From f4c0667d34c8562bb11b5e460b7d9ce894247aa3 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Wed, 8 Apr 2026 18:59:51 +0800
Subject: [PATCH 01/70] fix: bump transformers to 5.5.0 to resolve
 CVE-2026-1839

Bumps docling pin from ~=2.75.0 to ~=2.84.0 (allows huggingface-hub>=1)
and adds a transformers>=5.4.0 override to force resolution past 4.57.6.
---
 lib/crewai/pyproject.toml |  2 +-
 pyproject.toml            |  2 ++
 uv.lock                   | 33 ++++++++++++++++++---------------
 3 files changed, 21 insertions(+), 16 deletions(-)

diff --git a/lib/crewai/pyproject.toml b/lib/crewai/pyproject.toml
index e883035c1..99749cc67 100644
--- a/lib/crewai/pyproject.toml
+++ b/lib/crewai/pyproject.toml
@@ -68,7 +68,7 @@ openpyxl = [
 ]
 mem0 = ["mem0ai~=0.1.94"]
 docling = [
-    "docling~=2.75.0",
+    "docling~=2.84.0",
 ]
 qdrant = [
     "qdrant-client[fastembed]~=1.14.3",
diff --git a/pyproject.toml b/pyproject.toml
index 44b966533..6f6404677 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -166,12 +166,14 @@ exclude-newer = "3 days"
 # onnxruntime 1.24+ dropped Python 3.10 wheels; cap it so qdrant[fastembed] resolves on 3.10.
 # fastembed 0.7.x and docling 2.63 cap pillow<12; the removed APIs don't affect them.
 # langchain-core <1.2.11 has SSRF via image_url token counting (CVE-2026-26013).
+# transformers 4.57.6 has CVE-2026-1839; force 5.4+ (docling 2.84 allows huggingface-hub>=1).
 override-dependencies = [
     "rich>=13.7.1",
     "onnxruntime<1.24; python_version < '3.11'",
     "pillow>=12.1.1",
     "langchain-core>=1.2.11,<2",
     "urllib3>=2.6.3",
+    "transformers>=5.4.0; python_version >= '3.10'",
 ]
 
 [tool.uv.workspace]
diff --git a/uv.lock b/uv.lock
index 2f0922173..d52f6621f 100644
--- a/uv.lock
+++ b/uv.lock
@@ -13,7 +13,7 @@ resolution-markers = [
 ]
 
 [options]
-exclude-newer = "2026-04-04T15:11:41.651093Z"
+exclude-newer = "2026-04-05T10:53:01.907268Z"
 exclude-newer-span = "P3D"
 
 [manifest]
@@ -28,6 +28,7 @@ overrides = [
     { name = "onnxruntime", marker = "python_full_version < '3.11'", specifier = "<1.24" },
     { name = "pillow", specifier = ">=12.1.1" },
     { name = "rich", specifier = ">=13.7.1" },
+    { name = "transformers", marker = "python_full_version >= '3.10'", specifier = ">=5.4.0" },
     { name = "urllib3", specifier = ">=2.6.3" },
 ]
 
@@ -1307,7 +1308,7 @@ requires-dist = [
     { name = "click", specifier = "~=8.1.7" },
     { name = "crewai-files", marker = "extra == 'file-processing'", editable = "lib/crewai-files" },
     { name = "crewai-tools", marker = "extra == 'tools'", editable = "lib/crewai-tools" },
-    { name = "docling", marker = "extra == 'docling'", specifier = "~=2.75.0" },
+    { name = "docling", marker = "extra == 'docling'", specifier = "~=2.84.0" },
     { name = "google-genai", marker = "extra == 'google-genai'", specifier = "~=1.65.0" },
     { name = "httpx", specifier = "~=0.28.1" },
     { name = "httpx-auth", marker = "extra == 'a2a'", specifier = "~=0.23.1" },
@@ -1820,7 +1821,7 @@ wheels = [
 
 [[package]]
 name = "docling"
-version = "2.75.0"
+version = "2.84.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "accelerate" },
@@ -1851,12 +1852,14 @@ dependencies = [
     { name = "rtree" },
     { name = "scipy", version = "1.15.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
     { name = "scipy", version = "1.17.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "torch" },
+    { name = "torchvision" },
     { name = "tqdm" },
     { name = "typer" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/77/0b/8ea363fd3c8bb4facb8d3c37aebfe7ad5265fecc1c6bd40f979d1f6179ba/docling-2.75.0.tar.gz", hash = "sha256:1b0a77766e201e5e2d118e236c006f3814afcea2e13726fb3c7389d666a56622", size = 364929, upload-time = "2026-02-24T20:18:04.896Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/6f/1f/85560d7ba90a20f46c65396b45990fad34b7c95da23ca6e547456631d0e6/docling-2.84.0.tar.gz", hash = "sha256:007b0bad3c0ec45dc91af6083cbe1f0a93ddef1686304f466e8a168a1fb1dccb", size = 425470, upload-time = "2026-04-01T18:36:31.377Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/b8/85/5c6885547ce5cde33af43201e3b2b04cf2360e6854abc07485f54b8d265d/docling-2.75.0-py3-none-any.whl", hash = "sha256:6e156f0326edb6471fc076e978ac64f902f54aac0da13cf89df456013e377bcc", size = 396243, upload-time = "2026-02-24T20:18:03.57Z" },
+    { url = "https://files.pythonhosted.org/packages/22/e1/054e6ddf45e5760d51053b93b1a4f8be1568882b50c5ceeb88e6adaa6918/docling-2.84.0-py3-none-any.whl", hash = "sha256:ee431e5bb20cbebdd957f6173918f133d769340462814f3479df3446743d240e", size = 451391, upload-time = "2026-04-01T18:36:29.379Z" },
 ]
 
 [[package]]
@@ -2735,21 +2738,22 @@ wheels = [
 
 [[package]]
 name = "huggingface-hub"
-version = "0.36.2"
+version = "1.9.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "filelock" },
     { name = "fsspec" },
-    { name = "hf-xet", marker = "platform_machine == 'aarch64' or platform_machine == 'amd64' or platform_machine == 'arm64' or platform_machine == 'x86_64'" },
+    { name = "hf-xet", marker = "platform_machine == 'AMD64' or platform_machine == 'aarch64' or platform_machine == 'amd64' or platform_machine == 'arm64' or platform_machine == 'x86_64'" },
+    { name = "httpx" },
     { name = "packaging" },
     { name = "pyyaml" },
-    { name = "requests" },
     { name = "tqdm" },
+    { name = "typer" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/7c/b7/8cb61d2eece5fb05a83271da168186721c450eb74e3c31f7ef3169fa475b/huggingface_hub-0.36.2.tar.gz", hash = "sha256:1934304d2fb224f8afa3b87007d58501acfda9215b334eed53072dd5e815ff7a", size = 649782, upload-time = "2026-02-06T09:24:13.098Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/88/bb/62c7aa86f63a05e2f9b96642fdef9b94526a23979820b09f5455deff4983/huggingface_hub-1.9.0.tar.gz", hash = "sha256:0ea5be7a56135c91797cae6ad726e38eaeb6eb4b77cefff5c9d38ba0ecf874f7", size = 750326, upload-time = "2026-04-03T08:35:55.888Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a8/af/48ac8483240de756d2438c380746e7130d1c6f75802ef22f3c6d49982787/huggingface_hub-0.36.2-py3-none-any.whl", hash = "sha256:48f0c8eac16145dfce371e9d2d7772854a4f591bcb56c9cf548accf531d54270", size = 566395, upload-time = "2026-02-06T09:24:11.133Z" },
+    { url = "https://files.pythonhosted.org/packages/73/37/0d15d16150e1829f3e90962c99f28257f6de9e526a680b4c6f5acdb54fd2/huggingface_hub-1.9.0-py3-none-any.whl", hash = "sha256:2999328c058d39fd19ab748dd09bd4da2fbaa4f4c1ddea823eab103051e14a1f", size = 637355, upload-time = "2026-04-03T08:35:53.897Z" },
 ]
 
 [[package]]
@@ -8172,24 +8176,23 @@ wheels = [
 
 [[package]]
 name = "transformers"
-version = "4.57.6"
+version = "5.5.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "filelock" },
     { name = "huggingface-hub" },
     { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
     { name = "numpy", version = "2.4.4", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
     { name = "packaging" },
     { name = "pyyaml" },
     { name = "regex" },
-    { name = "requests" },
     { name = "safetensors" },
     { name = "tokenizers" },
     { name = "tqdm" },
+    { name = "typer" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/c4/35/67252acc1b929dc88b6602e8c4a982e64f31e733b804c14bc24b47da35e6/transformers-4.57.6.tar.gz", hash = "sha256:55e44126ece9dc0a291521b7e5492b572e6ef2766338a610b9ab5afbb70689d3", size = 10134912, upload-time = "2026-01-16T10:38:39.284Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/ff/9d/fb46e729b461985f41a5740167688b924a4019141e5c164bea77548d3d9e/transformers-5.5.0.tar.gz", hash = "sha256:c8db656cf51c600cd8c75f06b20ef85c72e8b8ff9abc880c5d3e8bc70e0ddcbd", size = 8237745, upload-time = "2026-04-02T16:13:08.113Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/03/b8/e484ef633af3887baeeb4b6ad12743363af7cce68ae51e938e00aaa0529d/transformers-4.57.6-py3-none-any.whl", hash = "sha256:4c9e9de11333ddfe5114bc872c9f370509198acf0b87a832a0ab9458e2bd0550", size = 11993498, upload-time = "2026-01-16T10:38:31.289Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/28/35f7411ff80a3640c1f4fc907dcbb6a65061ebb82f66950e38bfc9f7f740/transformers-5.5.0-py3-none-any.whl", hash = "sha256:821a9ff0961abbb29eb1eb686d78df1c85929fdf213a3fe49dc6bd94f9efa944", size = 10245591, upload-time = "2026-04-02T16:13:03.462Z" },
 ]
 
 [[package]]

From fc9280ccf63871a85854bde526a39383bbe2ac98 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Wed, 8 Apr 2026 19:52:51 +0800
Subject: [PATCH 02/70] refactor: replace regex with tomlkit in devtools CLI

---
 lib/devtools/pyproject.toml             |   6 +-
 lib/devtools/src/crewai_devtools/cli.py | 151 +++++++++++++---
 lib/devtools/tests/__init__.py          |   0
 lib/devtools/tests/test_toml_updates.py | 225 ++++++++++++++++++++++++
 pyproject.toml                          |   1 +
 uv.lock                                 |  21 +--
 6 files changed, 365 insertions(+), 39 deletions(-)
 create mode 100644 lib/devtools/tests/__init__.py
 create mode 100644 lib/devtools/tests/test_toml_updates.py

diff --git a/lib/devtools/pyproject.toml b/lib/devtools/pyproject.toml
index 815c8392f..7eebc9ea4 100644
--- a/lib/devtools/pyproject.toml
+++ b/lib/devtools/pyproject.toml
@@ -11,7 +11,7 @@ classifiers = ["Private :: Do Not Upload"]
 private = true
 dependencies = [
     "click~=8.1.7",
-    "toml~=0.10.2",
+    "tomlkit~=0.13.2",
     "openai>=1.83.0,<3",
     "python-dotenv~=1.1.1",
     "pygithub~=1.59.1",
@@ -25,6 +25,10 @@ release = "crewai_devtools.cli:release"
 docs-check = "crewai_devtools.docs_check:docs_check"
 devtools = "crewai_devtools.cli:main"
 
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--noconftest"
+
 [tool.uv]
 exclude-newer = "3 days"
 
diff --git a/lib/devtools/src/crewai_devtools/cli.py b/lib/devtools/src/crewai_devtools/cli.py
index 9f7b469be..785f943c7 100644
--- a/lib/devtools/src/crewai_devtools/cli.py
+++ b/lib/devtools/src/crewai_devtools/cli.py
@@ -1,8 +1,8 @@
 """Development tools for version bumping and git automation."""
 
+from collections.abc import Mapping
 import os
 from pathlib import Path
-import re
 import subprocess
 import sys
 import tempfile
@@ -18,6 +18,7 @@ from rich.console import Console
 from rich.markdown import Markdown
 from rich.panel import Panel
 from rich.prompt import Confirm
+import tomlkit
 
 from crewai_devtools.docs_check import docs_check
 from crewai_devtools.prompts import RELEASE_NOTES_PROMPT, TRANSLATE_RELEASE_NOTES_PROMPT
@@ -169,18 +170,17 @@ def update_pyproject_version(file_path: Path, new_version: str) -> bool:
     if not file_path.exists():
         return False
 
-    content = file_path.read_text()
-    new_content = re.sub(
-        r'^(version\s*=\s*")[^"]+(")',
-        rf"\g<1>{new_version}\2",
-        content,
-        count=1,
-        flags=re.MULTILINE,
-    )
-    if new_content != content:
-        file_path.write_text(new_content)
-        return True
-    return False
+    doc = tomlkit.parse(file_path.read_text())
+    project = doc.get("project")
+    if project is None:
+        return False
+    old_version = project.get("version")
+    if old_version is None or old_version == new_version:
+        return False
+
+    project["version"] = new_version
+    file_path.write_text(tomlkit.dumps(doc))
+    return True
 
 
 _DEFAULT_WORKSPACE_PACKAGES: Final[list[str]] = [
@@ -473,6 +473,14 @@ def update_changelog(
     return True
 
 
+def _is_crewai_dep(spec: str) -> bool:
+    """Return True if *spec* is a ``crewai`` or ``crewai[...]`` dependency."""
+    if not spec.startswith("crewai"):
+        return False
+    rest = spec[6:]  # after "crewai"
+    return len(rest) > 0 and rest[0] in ("[", "=", ">", "<", "~", "!")
+
+
 def _pin_crewai_deps(content: str, version: str) -> str:
     """Replace crewai dependency version pins in a pyproject.toml string.
 
@@ -486,11 +494,21 @@ def _pin_crewai_deps(content: str, version: str) -> str:
     Returns:
         Transformed content.
     """
-    return re.sub(
-        r'"crewai(\[tools\])?(==|>=)[^"]*"',
-        lambda m: f'"crewai{(m.group(1) or "")!s}=={version}"',
-        content,
-    )
+    doc = tomlkit.parse(content)
+    for key in ("dependencies", "optional-dependencies"):
+        deps = doc.get("project", {}).get(key)
+        if deps is None:
+            continue
+        # optional-dependencies is a table of lists; dependencies is a list
+        dep_lists = deps.values() if isinstance(deps, Mapping) else [deps]
+        for dep_list in dep_lists:
+            for i, dep in enumerate(dep_list):
+                s = str(dep)
+                if not _is_crewai_dep(s) or ("==" not in s and ">=" not in s):
+                    continue
+                extras = s[6 : s.index("]") + 1] if "[" in s[6:7] else ""
+                dep_list[i] = f"crewai{extras}=={version}"
+    return tomlkit.dumps(doc)
 
 
 def update_template_dependencies(templates_dir: Path, new_version: str) -> list[Path]:
@@ -1049,6 +1067,11 @@ _ENTERPRISE_EXTRA_PACKAGES: Final[tuple[str, ...]] = tuple(
     for p in os.getenv("ENTERPRISE_EXTRA_PACKAGES", "").split(",")
     if p.strip()
 )
+_ENTERPRISE_WORKFLOW_PATHS: Final[tuple[str, ...]] = tuple(
+    p.strip()
+    for p in os.getenv("ENTERPRISE_WORKFLOW_PATHS", "").split(",")
+    if p.strip()
+)
 
 
 def _update_enterprise_crewai_dep(pyproject_path: Path, version: str) -> bool:
@@ -1072,6 +1095,86 @@ def _update_enterprise_crewai_dep(pyproject_path: Path, version: str) -> bool:
     return False
 
 
+def _update_enterprise_workflows(repo_dir: Path, version: str) -> list[Path]:
+    """Update crewai version pins in enterprise CI workflow files.
+
+    Applies ``_repin_crewai_install`` line-by-line on the raw file so
+    only version numbers change and all formatting is preserved.
+
+    Args:
+        repo_dir: Root of the cloned enterprise repo.
+        version: New crewai version string.
+
+    Returns:
+        List of workflow paths that were modified.
+    """
+    updated: list[Path] = []
+    for rel_path in _ENTERPRISE_WORKFLOW_PATHS:
+        workflow = repo_dir / rel_path
+        if not workflow.exists():
+            continue
+
+        raw = workflow.read_text()
+        lines = raw.splitlines(keepends=True)
+        changed = False
+        for i, line in enumerate(lines):
+            if "crewai[" not in line:
+                continue
+            new_line = _repin_crewai_install(line, version)
+            if new_line != line:
+                lines[i] = new_line
+                changed = True
+
+        if changed:
+            new_raw = "".join(lines)
+        else:
+            new_raw = raw
+
+        if new_raw != raw:
+            workflow.write_text(new_raw)
+            updated.append(workflow)
+
+    return updated
+
+
+def _repin_crewai_install(run_value: str, version: str) -> str:
+    """Rewrite ``crewai[extras]==old`` pins in a shell command string.
+
+    Splits on the known ``crewai[`` prefix and reconstructs the pin
+    with the new version, avoiding regex.
+
+    Args:
+        run_value: The ``run:`` string from a workflow step.
+        version: New version to pin to.
+
+    Returns:
+        The updated string.
+    """
+    result: list[str] = []
+    remainder = run_value
+    marker = "crewai["
+    while marker in remainder:
+        before, _, after = remainder.partition(marker)
+        result.append(before)
+        # after looks like: a2a]==1.14.0" ...
+        bracket_end = after.index("]")
+        extras = after[:bracket_end]
+        rest = after[bracket_end + 1 :]
+        if rest.startswith("=="):
+            # Find end of version — next quote or whitespace
+            ver_start = 2  # len("==")
+            ver_end = ver_start
+            while ver_end < len(rest) and rest[ver_end] not in ('"', "'", " ", "\n"):
+                ver_end += 1
+            result.append(f"crewai[{extras}]=={version}")
+            remainder = rest[ver_end:]
+        else:
+            result.append(f"crewai[{extras}]")
+            remainder = rest
+    result.append(remainder)
+    return "".join(result)
+
+
 _DEPLOYMENT_TEST_REPO: Final[str] = "crewAIInc/crew_deployment_test"
 
 _PYPI_POLL_INTERVAL: Final[int] = 15
@@ -1099,11 +1202,7 @@ def _update_deployment_test_repo(version: str, is_prerelease: bool) -> None:
 
         pyproject = repo_dir / "pyproject.toml"
         content = pyproject.read_text()
-        new_content = re.sub(
-            r'"crewai\[tools\]==[^"]+"',
-            f'"crewai[tools]=={version}"',
-            content,
-        )
+        new_content = _pin_crewai_deps(content, version)
         if new_content == content:
             console.print(
                 "[yellow]Warning:[/yellow] No crewai[tools] pin found to update"
@@ -1262,6 +1361,12 @@ def _release_enterprise(version: str, is_prerelease: bool, dry_run: bool) -> Non
                 f"[green]✓[/green] Updated crewai[tools] dep in {enterprise_dep_path}"
             )
 
+        # --- update crewai pins in CI workflows ---
+        for wf in _update_enterprise_workflows(repo_dir, version):
+            console.print(
+                f"[green]✓[/green] Updated crewai pin in {wf.relative_to(repo_dir)}"
+            )
+
         _wait_for_pypi("crewai", version)
 
         console.print("\nSyncing workspace...")
diff --git a/lib/devtools/tests/__init__.py b/lib/devtools/tests/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/lib/devtools/tests/test_toml_updates.py b/lib/devtools/tests/test_toml_updates.py
new file mode 100644
index 000000000..eb93dd235
--- /dev/null
+++ b/lib/devtools/tests/test_toml_updates.py
@@ -0,0 +1,225 @@
+"""Tests for TOML-based version and dependency update functions."""
+
+from pathlib import Path
+from textwrap import dedent
+
+from crewai_devtools.cli import (
+    _pin_crewai_deps,
+    _repin_crewai_install,
+    update_pyproject_version,
+)
+
+
+# --- update_pyproject_version ---
+
+
+class TestUpdatePyprojectVersion:
+    def test_updates_version(self, tmp_path: Path) -> None:
+        pyproject = tmp_path / "pyproject.toml"
+        pyproject.write_text(
+            dedent("""\
+            [project]
+            name = "my-pkg"
+            version = "1.0.0"
+        """)
+        )
+
+        assert update_pyproject_version(pyproject, "2.0.0") is True
+        assert 'version = "2.0.0"' in pyproject.read_text()
+
+    def test_returns_false_when_already_current(self, tmp_path: Path) -> None:
+        pyproject = tmp_path / "pyproject.toml"
+        pyproject.write_text(
+            dedent("""\
+            [project]
+            name = "my-pkg"
+            version = "1.0.0"
+        """)
+        )
+
+        assert update_pyproject_version(pyproject, "1.0.0") is False
+
+    def test_returns_false_when_no_project_section(self, tmp_path: Path) -> None:
+        pyproject = tmp_path / "pyproject.toml"
+        pyproject.write_text("[tool.ruff]\nline-length = 88\n")
+
+        assert update_pyproject_version(pyproject, "1.0.0") is False
+
+    def test_returns_false_when_version_is_dynamic(self, tmp_path: Path) -> None:
+        pyproject = tmp_path / "pyproject.toml"
+        pyproject.write_text(
+            dedent("""\
+            [project]
+            name = "my-pkg"
+            dynamic = ["version"]
+        """)
+        )
+
+        assert update_pyproject_version(pyproject, "1.0.0") is False
+        assert 'version = "1.0.0"' not in pyproject.read_text()
+
+    def test_returns_false_for_missing_file(self, tmp_path: Path) -> None:
+        assert update_pyproject_version(tmp_path / "nope.toml", "1.0.0") is False
+
+    def test_preserves_comments_and_formatting(self, tmp_path: Path) -> None:
+        content = dedent("""\
+            # This is important
+            [project]
+            name = "my-pkg"
+            version = "1.0.0"  # current version
+            description = "A package"
+        """)
+        pyproject = tmp_path / "pyproject.toml"
+        pyproject.write_text(content)
+
+        update_pyproject_version(pyproject, "2.0.0")
+        result = pyproject.read_text()
+
+        assert "# This is important" in result
+        assert 'description = "A package"' in result
+
+
+# --- _pin_crewai_deps ---
+
+
+class TestPinCrewaiDeps:
+    def test_pins_exact_version(self) -> None:
+        content = dedent("""\
+            [project]
+            dependencies = [
+                "crewai==1.0.0",
+            ]
+        """)
+        result = _pin_crewai_deps(content, "2.0.0")
+        assert '"crewai==2.0.0"' in result
+
+    def test_pins_minimum_version(self) -> None:
+        content = dedent("""\
+            [project]
+            dependencies = [
+                "crewai>=1.0.0",
+            ]
+        """)
+        result = _pin_crewai_deps(content, "2.0.0")
+        assert '"crewai==2.0.0"' in result
+        assert ">=" not in result
+
+    def test_pins_with_tools_extra(self) -> None:
+        content = dedent("""\
+            [project]
+            dependencies = [
+                "crewai[tools]==1.0.0",
+            ]
+        """)
+        result = _pin_crewai_deps(content, "2.0.0")
+        assert '"crewai[tools]==2.0.0"' in result
+
+    def test_leaves_unrelated_deps_alone(self) -> None:
+        content = dedent("""\
+            [project]
+            dependencies = [
+                "requests>=2.0",
+                "crewai==1.0.0",
+                "click~=8.1",
+            ]
+        """)
+        result = _pin_crewai_deps(content, "2.0.0")
+        assert '"requests>=2.0"' in result
+        assert '"click~=8.1"' in result
+
+    def test_handles_optional_dependencies(self) -> None:
+        content = dedent("""\
+            [project]
+            dependencies = []
+
+            [project.optional-dependencies]
+            tools = [
+                "crewai[tools]>=1.0.0",
+            ]
+        """)
+        result = _pin_crewai_deps(content, "3.0.0")
+        assert '"crewai[tools]==3.0.0"' in result
+
+    def test_handles_multiple_crewai_entries(self) -> None:
+        content = dedent("""\
+            [project]
+            dependencies = [
+                "crewai==1.0.0",
+                "crewai[tools]==1.0.0",
+            ]
+        """)
+        result = _pin_crewai_deps(content, "2.0.0")
+        assert '"crewai==2.0.0"' in result
+        assert '"crewai[tools]==2.0.0"' in result
+
+    def test_preserves_arbitrary_extras(self) -> None:
+        content = dedent("""\
+            [project]
+            dependencies = [
+                "crewai[a2a]==1.0.0",
+            ]
+        """)
+        result = _pin_crewai_deps(content, "2.0.0")
+        assert '"crewai[a2a]==2.0.0"' in result
+
+    def test_no_deps_returns_unchanged(self) -> None:
+        content = dedent("""\
+            [project]
+            name = "empty"
+        """)
+        result = _pin_crewai_deps(content, "2.0.0")
+        assert "empty" in result
+
+    def test_skips_crewai_without_version_specifier(self) -> None:
+        content = dedent("""\
+            [project]
+            dependencies = [
+                "crewai-tools~=1.0",
+            ]
+        """)
+        result = _pin_crewai_deps(content, "2.0.0")
+        assert '"crewai-tools~=1.0"' in result
+
+    def test_skips_crewai_extras_without_pin(self) -> None:
+        content = dedent("""\
+            [project]
+            dependencies = [
+                "crewai[tools]",
+            ]
+        """)
+        result = _pin_crewai_deps(content, "2.0.0")
+        assert '"crewai[tools]"' in result
+        assert "==" not in result
+
+
+# --- _repin_crewai_install ---
+
+
+class TestRepinCrewaiInstall:
+    def test_repins_a2a_extra(self) -> None:
+        result = _repin_crewai_install('uv pip install "crewai[a2a]==1.14.0"', "2.0.0")
+        assert result == 'uv pip install "crewai[a2a]==2.0.0"'
+
+    def test_repins_tools_extra(self) -> None:
+        result = _repin_crewai_install('uv pip install "crewai[tools]==1.0.0"', "3.0.0")
+        assert result == 'uv pip install "crewai[tools]==3.0.0"'
+
+    def test_leaves_unrelated_commands_alone(self) -> None:
+        cmd = "uv pip install requests"
+        assert _repin_crewai_install(cmd, "2.0.0") == cmd
+
+    def test_handles_multiple_pins(self) -> None:
+        cmd = 'pip install "crewai[a2a]==1.0.0" "crewai[tools]==1.0.0"'
+        result = _repin_crewai_install(cmd, "2.0.0")
+        assert result == 'pip install "crewai[a2a]==2.0.0" "crewai[tools]==2.0.0"'
+
+    def test_preserves_surrounding_text(self) -> None:
+        cmd = 'echo hello && uv pip install "crewai[a2a]==1.14.0" && echo done'
+        result = _repin_crewai_install(cmd, "2.0.0")
+        assert (
+            result == 'echo hello && uv pip install "crewai[a2a]==2.0.0" && echo done'
+        )
+
+    def test_no_version_specifier_unchanged(self) -> None:
+        cmd = 'pip install "crewai[tools]>=1.0"'
+        assert _repin_crewai_install(cmd, "2.0.0") == cmd
diff --git a/pyproject.toml b/pyproject.toml
index 6f6404677..5894a9b2f 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -107,6 +107,7 @@ ignore-decorators = ["typing.overload"]
 "lib/crewai/tests/**/*.py" = ["S101", "RET504", "S105", "S106"]  # Allow assert statements, unnecessary assignments, and hardcoded passwords in tests
 "lib/crewai-tools/tests/**/*.py" = ["S101", "RET504", "S105", "S106", "RUF012", "N818", "E402", "RUF043", "S110", "B017"]  # Allow various test-specific patterns
 "lib/crewai-files/tests/**/*.py" = ["S101", "RET504", "S105", "S106", "B017", "F841"]  # Allow assert statements and blind exception assertions in tests
+"lib/devtools/tests/**/*.py" = ["S101"]
 
 
 [tool.mypy]
diff --git a/uv.lock b/uv.lock
index d52f6621f..5f637e156 100644
--- a/uv.lock
+++ b/uv.lock
@@ -13,7 +13,7 @@ resolution-markers = [
 ]
 
 [options]
-exclude-newer = "2026-04-05T10:53:01.907268Z"
+exclude-newer = "2026-04-05T11:09:48.9111Z"
 exclude-newer-span = "P3D"
 
 [manifest]
@@ -1358,7 +1358,7 @@ dependencies = [
     { name = "pygithub" },
     { name = "python-dotenv" },
     { name = "rich" },
-    { name = "toml" },
+    { name = "tomlkit" },
 ]
 
 [package.metadata]
@@ -1368,7 +1368,7 @@ requires-dist = [
     { name = "pygithub", specifier = "~=1.59.1" },
     { name = "python-dotenv", specifier = "~=1.1.1" },
     { name = "rich", specifier = ">=13.9.4" },
-    { name = "toml", specifier = "~=0.10.2" },
+    { name = "tomlkit", specifier = "~=0.13.2" },
 ]
 
 [[package]]
@@ -8037,15 +8037,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/59/8c/b1c87148aa15e099243ec9f0cf9d0e970cc2234c3257d558c25a2c5304e6/tokenizers-0.22.2-pp310-pypy310_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f01a9c019878532f98927d2bacb79bbb404b43d3437455522a00a30718cdedb5", size = 3373542, upload-time = "2026-01-05T10:40:52.803Z" },
 ]
 
-[[package]]
-name = "toml"
-version = "0.10.2"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/be/ba/1f744cdc819428fc6b5084ec34d9b30660f6f9daaf70eead706e3203ec3c/toml-0.10.2.tar.gz", hash = "sha256:b3bda1d108d5dd99f4a20d24d9c348e91c4db7ab1b749200bded2f839ccbe68f", size = 22253, upload-time = "2020-11-01T01:40:22.204Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/44/6f/7120676b6d73228c96e17f1f794d8ab046fc910d781c8d151120c3f1569e/toml-0.10.2-py2.py3-none-any.whl", hash = "sha256:806143ae5bfb6a3c6e736a764057db0e6a0e05e338b5630894a5f779cabb4f9b", size = 16588, upload-time = "2020-11-01T01:40:20.672Z" },
-]
-
 [[package]]
 name = "tomli"
 version = "2.0.2"
@@ -8066,11 +8057,11 @@ wheels = [
 
 [[package]]
 name = "tomlkit"
-version = "0.14.0"
+version = "0.13.3"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/c3/af/14b24e41977adb296d6bd1fb59402cf7d60ce364f90c890bd2ec65c43b5a/tomlkit-0.14.0.tar.gz", hash = "sha256:cf00efca415dbd57575befb1f6634c4f42d2d87dbba376128adb42c121b87064", size = 187167, upload-time = "2026-01-13T01:14:53.304Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/cc/18/0bbf3884e9eaa38819ebe46a7bd25dcd56b67434402b66a58c4b8e552575/tomlkit-0.13.3.tar.gz", hash = "sha256:430cf247ee57df2b94ee3fbe588e71d362a941ebb545dec29b53961d61add2a1", size = 185207, upload-time = "2025-06-05T07:13:44.947Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/b5/11/87d6d29fb5d237229d67973a6c9e06e048f01cf4994dee194ab0ea841814/tomlkit-0.14.0-py3-none-any.whl", hash = "sha256:592064ed85b40fa213469f81ac584f67a4f2992509a7c3ea2d632208623a3680", size = 39310, upload-time = "2026-01-13T01:14:51.965Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/75/8539d011f6be8e29f339c42e633aae3cb73bffa95dd0f9adec09b9c58e85/tomlkit-0.13.3-py3-none-any.whl", hash = "sha256:c89c649d79ee40629a9fda55f8ace8c6a1b42deb912b2a8fd8d942ddadb606b0", size = 38901, upload-time = "2025-06-05T07:13:43.546Z" },
 ]
 
 [[package]]

From 98e0d1054fd4a80561013a8816bb798963eb3618 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Wed, 8 Apr 2026 21:02:25 +0800
Subject: [PATCH 03/70] fix: sanitize tool names in hook decorator filters

---
 lib/crewai/src/crewai/hooks/decorators.py     |  5 +++
 lib/crewai/src/crewai/utilities/tool_utils.py |  8 ++---
 lib/crewai/tests/hooks/test_decorators.py     | 32 +++++++++++++++++++
 3 files changed, 41 insertions(+), 4 deletions(-)

diff --git a/lib/crewai/src/crewai/hooks/decorators.py b/lib/crewai/src/crewai/hooks/decorators.py
index 6007f19bb..4f1da08f5 100644
--- a/lib/crewai/src/crewai/hooks/decorators.py
+++ b/lib/crewai/src/crewai/hooks/decorators.py
@@ -5,6 +5,8 @@ from functools import wraps
 import inspect
 from typing import TYPE_CHECKING, Any, TypeVar, overload
 
+from crewai.utilities.string_utils import sanitize_tool_name
+
 
 if TYPE_CHECKING:
     from crewai.hooks.llm_hooks import LLMCallHookContext
@@ -37,6 +39,9 @@ def _create_hook_decorator(
         tools: list[str] | None = None,
         agents: list[str] | None = None,
     ) -> Callable[..., Any]:
+        if tools:
+            tools = [sanitize_tool_name(t) for t in tools]
+
         def decorator(f: Callable[..., Any]) -> Callable[..., Any]:
             setattr(f, marker_attribute, True)
 
diff --git a/lib/crewai/src/crewai/utilities/tool_utils.py b/lib/crewai/src/crewai/utilities/tool_utils.py
index 027f136ed..b77eb9192 100644
--- a/lib/crewai/src/crewai/utilities/tool_utils.py
+++ b/lib/crewai/src/crewai/utilities/tool_utils.py
@@ -96,7 +96,7 @@ async def aexecute_tool_and_check_finality(
     if tool:
         tool_input = tool_calling.arguments if tool_calling.arguments else {}
         hook_context = ToolCallHookContext(
-            tool_name=tool_calling.tool_name,
+            tool_name=sanitized_tool_name,
             tool_input=tool_input,
             tool=tool,
             agent=agent,
@@ -120,7 +120,7 @@ async def aexecute_tool_and_check_finality(
         tool_result = await tool_usage.ause(tool_calling, agent_action.text)
 
         after_hook_context = ToolCallHookContext(
-            tool_name=tool_calling.tool_name,
+            tool_name=sanitized_tool_name,
             tool_input=tool_input,
             tool=tool,
             agent=agent,
@@ -216,7 +216,7 @@ def execute_tool_and_check_finality(
     if tool:
         tool_input = tool_calling.arguments if tool_calling.arguments else {}
         hook_context = ToolCallHookContext(
-            tool_name=tool_calling.tool_name,
+            tool_name=sanitized_tool_name,
             tool_input=tool_input,
             tool=tool,
             agent=agent,
@@ -240,7 +240,7 @@ def execute_tool_and_check_finality(
         tool_result = tool_usage.use(tool_calling, agent_action.text)
 
         after_hook_context = ToolCallHookContext(
-            tool_name=tool_calling.tool_name,
+            tool_name=sanitized_tool_name,
             tool_input=tool_input,
             tool=tool,
             agent=agent,
diff --git a/lib/crewai/tests/hooks/test_decorators.py b/lib/crewai/tests/hooks/test_decorators.py
index ec147068d..a19a0f740 100644
--- a/lib/crewai/tests/hooks/test_decorators.py
+++ b/lib/crewai/tests/hooks/test_decorators.py
@@ -192,6 +192,38 @@ class TestToolHookDecorators:
         # Should still be 1 (hook didn't execute for read_file)
         assert len(execution_log) == 1
 
+    def test_before_tool_call_tool_filter_sanitizes_names(self):
+        """Tool filter should auto-sanitize names so users can pass BaseTool.name directly."""
+        execution_log = []
+
+        # User passes the human-readable tool name (e.g. BaseTool.name)
+        @before_tool_call(tools=["Delete File", "Execute Code"])
+        def filtered_hook(context):
+            execution_log.append(context.tool_name)
+            return None
+
+        hooks = get_before_tool_call_hooks()
+        assert len(hooks) == 1
+
+        mock_tool = Mock()
+        # Context uses the sanitized name (as set by the executor)
+        context = ToolCallHookContext(
+            tool_name="delete_file",
+            tool_input={},
+            tool=mock_tool,
+        )
+        hooks[0](context)
+        assert execution_log == ["delete_file"]
+
+        # Non-matching tool still filtered out
+        context2 = ToolCallHookContext(
+            tool_name="read_file",
+            tool_input={},
+            tool=mock_tool,
+        )
+        hooks[0](context2)
+        assert execution_log == ["delete_file"]
+
     def test_before_tool_call_with_combined_filters(self):
         """Test that combined tool and agent filters work."""
         execution_log = []

From 0e8ed759475e152d1c6af81468e52b38476b5f68 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Wed, 8 Apr 2026 23:32:37 +0800
Subject: [PATCH 04/70] feat: add aclose()/close() and async context manager to
 streaming outputs

---
 docs/ar/learn/streaming-crew-execution.mdx    |  28 +++
 docs/ar/learn/streaming-flow-execution.mdx    |  28 +++
 docs/en/learn/streaming-crew-execution.mdx    |  28 +++
 docs/en/learn/streaming-flow-execution.mdx    |  28 +++
 docs/ko/learn/streaming-crew-execution.mdx    |  28 +++
 docs/pt-BR/learn/streaming-crew-execution.mdx |  28 +++
 lib/crewai/src/crewai/crew.py                 |   4 +
 lib/crewai/src/crewai/crews/utils.py          |   2 +
 lib/crewai/src/crewai/flow/flow.py            |   3 +
 lib/crewai/src/crewai/types/streaming.py      | 230 +++++++++---------
 lib/crewai/src/crewai/utilities/streaming.py  |  26 +-
 lib/crewai/tests/test_streaming.py            | 152 ++++++++++++
 12 files changed, 464 insertions(+), 121 deletions(-)

diff --git a/docs/ar/learn/streaming-crew-execution.mdx b/docs/ar/learn/streaming-crew-execution.mdx
index 930ef389f..4dfe1859f 100644
--- a/docs/ar/learn/streaming-crew-execution.mdx
+++ b/docs/ar/learn/streaming-crew-execution.mdx
@@ -325,6 +325,34 @@ asyncio.run(interactive_research())
 - **تجربة المستخدم**: تقليل زمن الاستجابة المتصور بعرض نتائج تدريجية
 - **لوحات المعلومات الحية**: بناء واجهات مراقبة تعرض حالة تنفيذ الطاقم
 
+## الإلغاء وتنظيف الموارد
+
+يدعم `CrewStreamingOutput` الإلغاء السلس بحيث يتوقف العمل الجاري فوراً عند انقطاع اتصال المستهلك.
+
+### مدير السياق غير المتزامن
+
+```python Code
+streaming = await crew.akickoff(inputs={"topic": "AI"})
+
+async with streaming:
+    async for chunk in streaming:
+        print(chunk.content, end="", flush=True)
+```
+
+### الإلغاء الصريح
+
+```python Code
+streaming = await crew.akickoff(inputs={"topic": "AI"})
+try:
+    async for chunk in streaming:
+        print(chunk.content, end="", flush=True)
+finally:
+    await streaming.aclose()  # غير متزامن
+    # streaming.close()       # المكافئ المتزامن
+```
+
+بعد الإلغاء، يكون كل من `streaming.is_cancelled` و `streaming.is_completed` بقيمة `True`. كل من `aclose()` و `close()` متساويان القوة.
+
 ## ملاحظات مهمة
 
 - يفعّل البث تلقائياً بث LLM لجميع الوكلاء في الطاقم
diff --git a/docs/ar/learn/streaming-flow-execution.mdx b/docs/ar/learn/streaming-flow-execution.mdx
index 53663c111..de4575b1c 100644
--- a/docs/ar/learn/streaming-flow-execution.mdx
+++ b/docs/ar/learn/streaming-flow-execution.mdx
@@ -420,6 +420,34 @@ except Exception as e:
         print("Streaming completed but flow encountered an error")
 ```
 
+## الإلغاء وتنظيف الموارد
+
+يدعم `FlowStreamingOutput` الإلغاء السلس بحيث يتوقف العمل الجاري فوراً عند انقطاع اتصال المستهلك.
+
+### مدير السياق غير المتزامن
+
+```python Code
+streaming = await flow.kickoff_async()
+
+async with streaming:
+    async for chunk in streaming:
+        print(chunk.content, end="", flush=True)
+```
+
+### الإلغاء الصريح
+
+```python Code
+streaming = await flow.kickoff_async()
+try:
+    async for chunk in streaming:
+        print(chunk.content, end="", flush=True)
+finally:
+    await streaming.aclose()  # غير متزامن
+    # streaming.close()       # المكافئ المتزامن
+```
+
+بعد الإلغاء، يكون كل من `streaming.is_cancelled` و `streaming.is_completed` بقيمة `True`. كل من `aclose()` و `close()` متساويان القوة.
+
 ## ملاحظات مهمة
 
 - يفعّل البث تلقائياً بث LLM لأي أطقم مستخدمة داخل التدفق
diff --git a/docs/en/learn/streaming-crew-execution.mdx b/docs/en/learn/streaming-crew-execution.mdx
index bfcd0850d..ff0a3cd7f 100644
--- a/docs/en/learn/streaming-crew-execution.mdx
+++ b/docs/en/learn/streaming-crew-execution.mdx
@@ -325,6 +325,34 @@ Streaming is particularly valuable for:
 - **User Experience**: Reduce perceived latency by showing incremental results
 - **Live Dashboards**: Build monitoring interfaces that display crew execution status
 
+## Cancellation and Resource Cleanup
+
+`CrewStreamingOutput` supports graceful cancellation so that in-flight work stops promptly when the consumer disconnects.
+
+### Async Context Manager
+
+```python Code
+streaming = await crew.akickoff(inputs={"topic": "AI"})
+
+async with streaming:
+    async for chunk in streaming:
+        print(chunk.content, end="", flush=True)
+```
+
+### Explicit Cancellation
+
+```python Code
+streaming = await crew.akickoff(inputs={"topic": "AI"})
+try:
+    async for chunk in streaming:
+        print(chunk.content, end="", flush=True)
+finally:
+    await streaming.aclose()  # async
+    # streaming.close()       # sync equivalent
+```
+
+After cancellation, `streaming.is_cancelled` and `streaming.is_completed` are both `True`. Both `aclose()` and `close()` are idempotent.
+
 ## Important Notes
 
 - Streaming automatically enables LLM streaming for all agents in the crew
diff --git a/docs/en/learn/streaming-flow-execution.mdx b/docs/en/learn/streaming-flow-execution.mdx
index df0fec91d..31ca0f376 100644
--- a/docs/en/learn/streaming-flow-execution.mdx
+++ b/docs/en/learn/streaming-flow-execution.mdx
@@ -420,6 +420,34 @@ except Exception as e:
         print("Streaming completed but flow encountered an error")
 ```
 
+## Cancellation and Resource Cleanup
+
+`FlowStreamingOutput` supports graceful cancellation so that in-flight work stops promptly when the consumer disconnects.
+
+### Async Context Manager
+
+```python Code
+streaming = await flow.kickoff_async()
+
+async with streaming:
+    async for chunk in streaming:
+        print(chunk.content, end="", flush=True)
+```
+
+### Explicit Cancellation
+
+```python Code
+streaming = await flow.kickoff_async()
+try:
+    async for chunk in streaming:
+        print(chunk.content, end="", flush=True)
+finally:
+    await streaming.aclose()  # async
+    # streaming.close()       # sync equivalent
+```
+
+After cancellation, `streaming.is_cancelled` and `streaming.is_completed` are both `True`. Both `aclose()` and `close()` are idempotent.
+
 ## Important Notes
 
 - Streaming automatically enables LLM streaming for any crews used within the flow
diff --git a/docs/ko/learn/streaming-crew-execution.mdx b/docs/ko/learn/streaming-crew-execution.mdx
index aec56caed..db2ce1c0c 100644
--- a/docs/ko/learn/streaming-crew-execution.mdx
+++ b/docs/ko/learn/streaming-crew-execution.mdx
@@ -325,6 +325,34 @@ asyncio.run(interactive_research())
 - **사용자 경험**: 점진적인 결과를 표시하여 체감 지연 시간 감소
 - **라이브 대시보드**: crew 실행 상태를 표시하는 모니터링 인터페이스 구축
 
+## 취소 및 리소스 정리
+
+`CrewStreamingOutput`은 소비자가 연결을 끊을 때 진행 중인 작업을 즉시 중단하는 정상적인 취소를 지원합니다.
+
+### 비동기 컨텍스트 매니저
+
+```python Code
+streaming = await crew.akickoff(inputs={"topic": "AI"})
+
+async with streaming:
+    async for chunk in streaming:
+        print(chunk.content, end="", flush=True)
+```
+
+### 명시적 취소
+
+```python Code
+streaming = await crew.akickoff(inputs={"topic": "AI"})
+try:
+    async for chunk in streaming:
+        print(chunk.content, end="", flush=True)
+finally:
+    await streaming.aclose()  # 비동기
+    # streaming.close()       # 동기 버전
+```
+
+취소 후 `streaming.is_cancelled`와 `streaming.is_completed`는 모두 `True`입니다. `aclose()`와 `close()` 모두 멱등성을 가집니다.
+
 ## 중요 사항
 
 - 스트리밍은 crew의 모든 에이전트에 대해 자동으로 LLM 스트리밍을 활성화합니다
diff --git a/docs/pt-BR/learn/streaming-crew-execution.mdx b/docs/pt-BR/learn/streaming-crew-execution.mdx
index 85a26e370..4a3df07ef 100644
--- a/docs/pt-BR/learn/streaming-crew-execution.mdx
+++ b/docs/pt-BR/learn/streaming-crew-execution.mdx
@@ -325,6 +325,34 @@ O streaming é particularmente valioso para:
 - **Experiência do Usuário**: Reduzir latência percebida mostrando resultados incrementais
 - **Dashboards ao Vivo**: Construir interfaces de monitoramento que exibem status de execução da crew
 
+## Cancelamento e Limpeza de Recursos
+
+`CrewStreamingOutput` suporta cancelamento gracioso para que o trabalho em andamento pare imediatamente quando o consumidor desconecta.
+
+### Gerenciador de Contexto Assíncrono
+
+```python Code
+streaming = await crew.akickoff(inputs={"topic": "AI"})
+
+async with streaming:
+    async for chunk in streaming:
+        print(chunk.content, end="", flush=True)
+```
+
+### Cancelamento Explícito
+
+```python Code
+streaming = await crew.akickoff(inputs={"topic": "AI"})
+try:
+    async for chunk in streaming:
+        print(chunk.content, end="", flush=True)
+finally:
+    await streaming.aclose()  # assíncrono
+    # streaming.close()       # equivalente síncrono
+```
+
+Após o cancelamento, `streaming.is_cancelled` e `streaming.is_completed` são ambos `True`. Tanto `aclose()` quanto `close()` são idempotentes.
+
 ## Notas Importantes
 
 - O streaming ativa automaticamente o streaming do LLM para todos os agentes na crew
diff --git a/lib/crewai/src/crewai/crew.py b/lib/crewai/src/crewai/crew.py
index e630ec5b0..1c671467e 100644
--- a/lib/crewai/src/crewai/crew.py
+++ b/lib/crewai/src/crewai/crew.py
@@ -134,6 +134,7 @@ from crewai.utilities.rpm_controller import RPMController
 from crewai.utilities.streaming import (
     create_async_chunk_generator,
     create_chunk_generator,
+    register_cleanup,
     signal_end,
     signal_error,
 )
@@ -882,6 +883,7 @@ class Crew(FlowTrackable, BaseModel):
                     ctx.state, run_crew, ctx.output_holder
                 )
             )
+            register_cleanup(streaming_output, ctx.state)
             ctx.output_holder.append(streaming_output)
             return streaming_output
 
@@ -1007,6 +1009,7 @@ class Crew(FlowTrackable, BaseModel):
                     ctx.state, run_crew, ctx.output_holder
                 )
             )
+            register_cleanup(streaming_output, ctx.state)
             ctx.output_holder.append(streaming_output)
 
             return streaming_output
@@ -1078,6 +1081,7 @@ class Crew(FlowTrackable, BaseModel):
                     ctx.state, run_crew, ctx.output_holder
                 )
             )
+            register_cleanup(streaming_output, ctx.state)
             ctx.output_holder.append(streaming_output)
 
             return streaming_output
diff --git a/lib/crewai/src/crewai/crews/utils.py b/lib/crewai/src/crewai/crews/utils.py
index 4077a9a19..e85a48b05 100644
--- a/lib/crewai/src/crewai/crews/utils.py
+++ b/lib/crewai/src/crewai/crews/utils.py
@@ -431,6 +431,7 @@ async def run_for_each_async(
     from crewai.types.usage_metrics import UsageMetrics
     from crewai.utilities.streaming import (
         create_async_chunk_generator,
+        register_cleanup,
         signal_end,
         signal_error,
     )
@@ -480,6 +481,7 @@ async def run_for_each_async(
             streaming_output._set_results(result)
 
         streaming_output._set_result = set_results_wrapper  # type: ignore[method-assign]
+        register_cleanup(streaming_output, ctx.state)
         ctx.output_holder.append(streaming_output)
 
         return streaming_output
diff --git a/lib/crewai/src/crewai/flow/flow.py b/lib/crewai/src/crewai/flow/flow.py
index 60d03b069..97e6bdf20 100644
--- a/lib/crewai/src/crewai/flow/flow.py
+++ b/lib/crewai/src/crewai/flow/flow.py
@@ -132,6 +132,7 @@ from crewai.utilities.streaming import (
     create_async_chunk_generator,
     create_chunk_generator,
     create_streaming_state,
+    register_cleanup,
     signal_end,
     signal_error,
 )
@@ -1962,6 +1963,7 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
             streaming_output = FlowStreamingOutput(
                 sync_iterator=create_chunk_generator(state, run_flow, output_holder)
             )
+            register_cleanup(streaming_output, state)
             output_holder.append(streaming_output)
 
             return streaming_output
@@ -2035,6 +2037,7 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
                     state, run_flow, output_holder
                 )
             )
+            register_cleanup(streaming_output, state)
             output_holder.append(streaming_output)
 
             return streaming_output
diff --git a/lib/crewai/src/crewai/types/streaming.py b/lib/crewai/src/crewai/types/streaming.py
index a1f6e4ef7..eb3ddbde1 100644
--- a/lib/crewai/src/crewai/types/streaming.py
+++ b/lib/crewai/src/crewai/types/streaming.py
@@ -2,11 +2,12 @@
 
 from __future__ import annotations
 
-from collections.abc import AsyncIterator, Iterator
+from collections.abc import AsyncIterator, Callable, Iterator
 from enum import Enum
 from typing import TYPE_CHECKING, Any, Generic, TypeVar
 
 from pydantic import BaseModel, Field
+from typing_extensions import Self
 
 
 if TYPE_CHECKING:
@@ -78,12 +79,21 @@ class StreamingOutputBase(Generic[T]):
     via the .result property after streaming completes.
     """
 
-    def __init__(self) -> None:
+    def __init__(
+        self,
+        sync_iterator: Iterator[StreamChunk] | None = None,
+        async_iterator: AsyncIterator[StreamChunk] | None = None,
+    ) -> None:
         """Initialize streaming output base."""
         self._result: T | None = None
         self._completed: bool = False
         self._chunks: list[StreamChunk] = []
         self._error: Exception | None = None
+        self._cancelled: bool = False
+        self._exhausted: bool = False
+        self._on_cleanup: Callable[[], None] | None = None
+        self._sync_iterator = sync_iterator
+        self._async_iterator = async_iterator
 
     @property
     def result(self) -> T:
@@ -112,6 +122,11 @@ class StreamingOutputBase(Generic[T]):
         """Check if streaming has completed."""
         return self._completed
 
+    @property
+    def is_cancelled(self) -> bool:
+        """Check if streaming was cancelled."""
+        return self._cancelled
+
     @property
     def chunks(self) -> list[StreamChunk]:
         """Get all collected chunks so far."""
@@ -129,6 +144,98 @@ class StreamingOutputBase(Generic[T]):
             if chunk.chunk_type == StreamChunkType.TEXT
         )
 
+    async def __aenter__(self) -> Self:
+        """Enter async context manager."""
+        return self
+
+    async def __aexit__(self, *exc_info: Any) -> None:
+        """Exit async context manager, cancelling if still running."""
+        await self.aclose()
+
+    async def aclose(self) -> None:
+        """Cancel streaming and clean up resources.
+
+        Cancels any in-flight tasks and closes the underlying async iterator.
+        Safe to call multiple times. No-op if already cancelled or fully consumed.
+        """
+        if self._cancelled or self._exhausted or self._error is not None:
+            return
+        self._cancelled = True
+        self._completed = True
+        if self._async_iterator is not None and hasattr(self._async_iterator, "aclose"):
+            await self._async_iterator.aclose()
+        if self._on_cleanup is not None:
+            self._on_cleanup()
+            self._on_cleanup = None
+
+    def close(self) -> None:
+        """Cancel streaming and clean up resources (sync).
+
+        Closes the underlying sync iterator. Safe to call multiple times.
+        No-op if already cancelled, fully consumed, or errored.
+        """
+        if self._cancelled or self._exhausted or self._error is not None:
+            return
+        self._cancelled = True
+        self._completed = True
+        if self._sync_iterator is not None and hasattr(self._sync_iterator, "close"):
+            self._sync_iterator.close()
+        if self._on_cleanup is not None:
+            self._on_cleanup()
+            self._on_cleanup = None
+
+    def __iter__(self) -> Iterator[StreamChunk]:
+        """Iterate over stream chunks synchronously.
+
+        Yields:
+            StreamChunk objects as they arrive.
+
+        Raises:
+            RuntimeError: If sync iterator not available.
+        """
+        if self._sync_iterator is None:
+            raise RuntimeError("Sync iterator not available")
+        try:
+            for chunk in self._sync_iterator:
+                self._chunks.append(chunk)
+                yield chunk
+            self._exhausted = True
+        except Exception as e:
+            self._error = e
+            raise
+        finally:
+            self._completed = True
+
+    def __aiter__(self) -> AsyncIterator[StreamChunk]:
+        """Return async iterator for stream chunks.
+
+        Returns:
+            Async iterator for StreamChunk objects.
+        """
+        return self._async_iterate()
+
+    async def _async_iterate(self) -> AsyncIterator[StreamChunk]:
+        """Iterate over stream chunks asynchronously.
+
+        Yields:
+            StreamChunk objects as they arrive.
+
+        Raises:
+            RuntimeError: If async iterator not available.
+        """
+        if self._async_iterator is None:
+            raise RuntimeError("Async iterator not available")
+        try:
+            async for chunk in self._async_iterator:
+                self._chunks.append(chunk)
+                yield chunk
+            self._exhausted = True
+        except Exception as e:
+            self._error = e
+            raise
+        finally:
+            self._completed = True
+
 
 class CrewStreamingOutput(StreamingOutputBase["CrewOutput"]):
     """Streaming output wrapper for crew execution.
@@ -167,9 +274,7 @@ class CrewStreamingOutput(StreamingOutputBase["CrewOutput"]):
             sync_iterator: Synchronous iterator for chunks.
             async_iterator: Asynchronous iterator for chunks.
         """
-        super().__init__()
-        self._sync_iterator = sync_iterator
-        self._async_iterator = async_iterator
+        super().__init__(sync_iterator=sync_iterator, async_iterator=async_iterator)
         self._results: list[CrewOutput] | None = None
 
     @property
@@ -204,56 +309,6 @@ class CrewStreamingOutput(StreamingOutputBase["CrewOutput"]):
         self._results = results
         self._completed = True
 
-    def __iter__(self) -> Iterator[StreamChunk]:
-        """Iterate over stream chunks synchronously.
-
-        Yields:
-            StreamChunk objects as they arrive.
-
-        Raises:
-            RuntimeError: If sync iterator not available.
-        """
-        if self._sync_iterator is None:
-            raise RuntimeError("Sync iterator not available")
-        try:
-            for chunk in self._sync_iterator:
-                self._chunks.append(chunk)
-                yield chunk
-        except Exception as e:
-            self._error = e
-            raise
-        finally:
-            self._completed = True
-
-    def __aiter__(self) -> AsyncIterator[StreamChunk]:
-        """Return async iterator for stream chunks.
-
-        Returns:
-            Async iterator for StreamChunk objects.
-        """
-        return self._async_iterate()
-
-    async def _async_iterate(self) -> AsyncIterator[StreamChunk]:
-        """Iterate over stream chunks asynchronously.
-
-        Yields:
-            StreamChunk objects as they arrive.
-
-        Raises:
-            RuntimeError: If async iterator not available.
-        """
-        if self._async_iterator is None:
-            raise RuntimeError("Async iterator not available")
-        try:
-            async for chunk in self._async_iterator:
-                self._chunks.append(chunk)
-                yield chunk
-        except Exception as e:
-            self._error = e
-            raise
-        finally:
-            self._completed = True
-
     def _set_result(self, result: CrewOutput) -> None:
         """Set the final result after streaming completes.
 
@@ -286,71 +341,6 @@ class FlowStreamingOutput(StreamingOutputBase[Any]):
         ```
     """
 
-    def __init__(
-        self,
-        sync_iterator: Iterator[StreamChunk] | None = None,
-        async_iterator: AsyncIterator[StreamChunk] | None = None,
-    ) -> None:
-        """Initialize flow streaming output.
-
-        Args:
-            sync_iterator: Synchronous iterator for chunks.
-            async_iterator: Asynchronous iterator for chunks.
-        """
-        super().__init__()
-        self._sync_iterator = sync_iterator
-        self._async_iterator = async_iterator
-
-    def __iter__(self) -> Iterator[StreamChunk]:
-        """Iterate over stream chunks synchronously.
-
-        Yields:
-            StreamChunk objects as they arrive.
-
-        Raises:
-            RuntimeError: If sync iterator not available.
-        """
-        if self._sync_iterator is None:
-            raise RuntimeError("Sync iterator not available")
-        try:
-            for chunk in self._sync_iterator:
-                self._chunks.append(chunk)
-                yield chunk
-        except Exception as e:
-            self._error = e
-            raise
-        finally:
-            self._completed = True
-
-    def __aiter__(self) -> AsyncIterator[StreamChunk]:
-        """Return async iterator for stream chunks.
-
-        Returns:
-            Async iterator for StreamChunk objects.
-        """
-        return self._async_iterate()
-
-    async def _async_iterate(self) -> AsyncIterator[StreamChunk]:
-        """Iterate over stream chunks asynchronously.
-
-        Yields:
-            StreamChunk objects as they arrive.
-
-        Raises:
-            RuntimeError: If async iterator not available.
-        """
-        if self._async_iterator is None:
-            raise RuntimeError("Async iterator not available")
-        try:
-            async for chunk in self._async_iterator:
-                self._chunks.append(chunk)
-                yield chunk
-        except Exception as e:
-            self._error = e
-            raise
-        finally:
-            self._completed = True
-
     def _set_result(self, result: Any) -> None:
         """Set the final result after streaming completes.
 
diff --git a/lib/crewai/src/crewai/utilities/streaming.py b/lib/crewai/src/crewai/utilities/streaming.py
index dd0992684..008144bff 100644
--- a/lib/crewai/src/crewai/utilities/streaming.py
+++ b/lib/crewai/src/crewai/utilities/streaming.py
@@ -3,6 +3,7 @@
 import asyncio
 from collections.abc import AsyncIterator, Callable, Iterator
 import contextvars
+import logging
 import queue
 import threading
 from typing import Any, NamedTuple
@@ -22,6 +23,9 @@ from crewai.types.streaming import (
 from crewai.utilities.string_utils import sanitize_tool_name
 
 
+logger = logging.getLogger(__name__)
+
+
 class TaskInfo(TypedDict):
     """Task context information for streaming."""
 
@@ -159,10 +163,23 @@ def _finalize_streaming(
         streaming_output: The streaming output to set the result on.
     """
     _unregister_handler(state.handler)
+    streaming_output._on_cleanup = None
     if state.result_holder:
         streaming_output._set_result(state.result_holder[0])
 
 
+def register_cleanup(
+    streaming_output: CrewStreamingOutput | FlowStreamingOutput,
+    state: StreamingState,
+) -> None:
+    """Register a cleanup callback on the streaming output.
+
+    Ensures the event handler is unregistered even if aclose()/close()
+    is called before iteration starts.
+    """
+    streaming_output._on_cleanup = lambda: _unregister_handler(state.handler)
+
+
 def create_streaming_state(
     current_task_info: TaskInfo,
     result_holder: list[Any],
@@ -294,7 +311,14 @@ async def create_async_chunk_generator(
                 raise item
             yield item
     finally:
-        await task
+        if not task.done():
+            task.cancel()
+        try:
+            await task
+        except asyncio.CancelledError:
+            pass
+        except Exception:
+            logger.debug("Background streaming task failed", exc_info=True)
         if output_holder:
             _finalize_streaming(state, output_holder[0])
         else:
diff --git a/lib/crewai/tests/test_streaming.py b/lib/crewai/tests/test_streaming.py
index 8eb63694e..7b1c8e1ba 100644
--- a/lib/crewai/tests/test_streaming.py
+++ b/lib/crewai/tests/test_streaming.py
@@ -709,6 +709,158 @@ class TestStreamingEdgeCases:
         assert streaming.is_completed
 
 
+class TestStreamingCancellation:
+    """Tests for streaming cancellation and resource cleanup."""
+
+    @pytest.mark.asyncio
+    async def test_aclose_cancels_async_streaming(self) -> None:
+        """Test that aclose() stops iteration and marks as cancelled."""
+        chunks_yielded: list[str] = []
+
+        async def slow_gen() -> AsyncIterator[StreamChunk]:
+            for i in range(100):
+                await asyncio.sleep(0.01)
+                chunks_yielded.append(f"chunk-{i}")
+                yield StreamChunk(content=f"chunk-{i}")
+
+        streaming = CrewStreamingOutput(async_iterator=slow_gen())
+        collected: list[StreamChunk] = []
+
+        async for chunk in streaming:
+            collected.append(chunk)
+            if len(collected) >= 3:
+                break
+
+        await streaming.aclose()
+
+        assert streaming.is_cancelled
+        assert streaming.is_completed
+        assert len(collected) == 3
+
+    @pytest.mark.asyncio
+    async def test_aclose_idempotent(self) -> None:
+        """Test that calling aclose() multiple times is safe."""
+        async def gen() -> AsyncIterator[StreamChunk]:
+            yield StreamChunk(content="test")
+
+        streaming = CrewStreamingOutput(async_iterator=gen())
+        async for _ in streaming:
+            pass
+
+        await streaming.aclose()
+        await streaming.aclose()
+        assert not streaming.is_cancelled
+        assert streaming.is_completed
+
+    @pytest.mark.asyncio
+    async def test_async_context_manager(self) -> None:
+        """Test using streaming output as async context manager."""
+        async def gen() -> AsyncIterator[StreamChunk]:
+            yield StreamChunk(content="hello")
+            yield StreamChunk(content="world")
+
+        streaming = CrewStreamingOutput(async_iterator=gen())
+        collected: list[StreamChunk] = []
+
+        async with streaming:
+            async for chunk in streaming:
+                collected.append(chunk)
+
+        assert not streaming.is_cancelled
+        assert streaming.is_completed
+        assert len(collected) == 2
+
+    @pytest.mark.asyncio
+    async def test_async_context_manager_early_exit(self) -> None:
+        """Test context manager cleans up on early exit."""
+        async def gen() -> AsyncIterator[StreamChunk]:
+            for i in range(100):
+                await asyncio.sleep(0.01)
+                yield StreamChunk(content=f"chunk-{i}")
+
+        streaming = CrewStreamingOutput(async_iterator=gen())
+
+        async with streaming:
+            async for chunk in streaming:
+                if chunk.content == "chunk-2":
+                    break
+
+        assert streaming.is_cancelled
+        assert streaming.is_completed
+
+    def test_close_cancels_sync_streaming(self) -> None:
+        """Test that close() stops sync streaming and marks as cancelled."""
+        def gen() -> Generator[StreamChunk, None, None]:
+            for i in range(100):
+                yield StreamChunk(content=f"chunk-{i}")
+
+        streaming = CrewStreamingOutput(sync_iterator=gen())
+        collected: list[StreamChunk] = []
+
+        for chunk in streaming:
+            collected.append(chunk)
+            if len(collected) >= 3:
+                break
+
+        streaming.close()
+
+        assert streaming.is_cancelled
+        assert streaming.is_completed
+
+    def test_close_idempotent(self) -> None:
+        """Test that calling close() multiple times is safe."""
+        def gen() -> Generator[StreamChunk, None, None]:
+            yield StreamChunk(content="test")
+
+        streaming = CrewStreamingOutput(sync_iterator=gen())
+        list(streaming)
+
+        streaming.close()
+        streaming.close()
+        assert not streaming.is_cancelled
+        assert streaming.is_completed
+
+    @pytest.mark.asyncio
+    async def test_flow_aclose(self) -> None:
+        """Test that FlowStreamingOutput aclose() is no-op after normal completion."""
+        async def gen() -> AsyncIterator[StreamChunk]:
+            yield StreamChunk(content="flow-chunk")
+
+        streaming = FlowStreamingOutput(async_iterator=gen())
+        async for _ in streaming:
+            pass
+
+        await streaming.aclose()
+        assert not streaming.is_cancelled
+        assert streaming.is_completed
+
+    @pytest.mark.asyncio
+    async def test_flow_async_context_manager(self) -> None:
+        """Test FlowStreamingOutput as async context manager with full consumption."""
+        async def gen() -> AsyncIterator[StreamChunk]:
+            yield StreamChunk(content="flow-chunk")
+
+        streaming = FlowStreamingOutput(async_iterator=gen())
+
+        async with streaming:
+            async for _ in streaming:
+                pass
+
+        assert not streaming.is_cancelled
+        assert streaming.is_completed
+
+    def test_flow_close(self) -> None:
+        """Test that FlowStreamingOutput close() is no-op after normal completion."""
+        def gen() -> Generator[StreamChunk, None, None]:
+            yield StreamChunk(content="flow-chunk")
+
+        streaming = FlowStreamingOutput(sync_iterator=gen())
+        list(streaming)
+
+        streaming.close()
+        assert not streaming.is_cancelled
+
+
 class TestStreamingImports:
     """Tests for correct imports of streaming types."""
 

From 1ae237a287304cdc72605db56d0a24fdc5e8c110 Mon Sep 17 00:00:00 2001
From: iris-clawd <iris@crewai.com>
Date: Wed, 8 Apr 2026 08:49:16 -0700
Subject: [PATCH 05/70] refactor: replace hardcoded denylist with dynamic
 BaseTool field exclusion in spec gen (#5347)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The spec generator previously used a hardcoded list of field names to
exclude from init_params_schema. Any new field or computed_field added
to BaseTool (like tool_type from 86ce54f) would silently leak into
tool.specs.json unless someone remembered to update that list.

Now _extract_init_params() dynamically computes BaseTool's fields at
import time via model_fields + model_computed_fields, so any future
additions to BaseTool are automatically excluded.

Fields from intermediate base classes (RagTool, BraveSearchToolBase,
SerpApiBaseTool) are correctly preserved since they're not on BaseTool.

TDD:
- RED: 3 new tests confirming BaseTool field leak, intermediate base
  preservation, and future-proofing — all failed before the fix
- GREEN: Dynamic allowlist applied — all 10 tests pass
- Regenerated tool.specs.json (tool_type removed from all tools)
---
 .../src/crewai_tools/generate_tool_specs.py   |  32 +-
 .../tests/test_generate_tool_specs.py         | 101 +++
 lib/crewai-tools/tool.specs.json              | 787 +++---------------
 3 files changed, 212 insertions(+), 708 deletions(-)

diff --git a/lib/crewai-tools/src/crewai_tools/generate_tool_specs.py b/lib/crewai-tools/src/crewai_tools/generate_tool_specs.py
index 34d78e074..579adaa30 100644
--- a/lib/crewai-tools/src/crewai_tools/generate_tool_specs.py
+++ b/lib/crewai-tools/src/crewai_tools/generate_tool_specs.py
@@ -154,21 +154,19 @@ class ToolSpecExtractor:
 
         return default_value
 
+    # Dynamically computed from BaseTool so that any future fields or
+    # computed_fields added to BaseTool are automatically excluded from
+    # the generated spec — no hardcoded denylist to maintain.
+    # ``package_dependencies`` is not a BaseTool field but is extracted
+    # into its own top-level key, so it's also excluded from init_params.
+    _BASE_TOOL_FIELDS: set[str] = (
+        set(BaseTool.model_fields)
+        | set(BaseTool.model_computed_fields)
+        | {"package_dependencies"}
+    )
+
     @staticmethod
     def _extract_init_params(tool_class: type[BaseTool]) -> dict[str, Any]:
-        ignored_init_params = [
-            "name",
-            "description",
-            "env_vars",
-            "args_schema",
-            "description_updated",
-            "cache_function",
-            "result_as_answer",
-            "max_usage_count",
-            "current_usage_count",
-            "package_dependencies",
-        ]
-
         json_schema = tool_class.model_json_schema(
             schema_generator=SchemaGenerator, mode="serialization"
         )
@@ -176,8 +174,14 @@ class ToolSpecExtractor:
         json_schema["properties"] = {
             key: value
             for key, value in json_schema["properties"].items()
-            if key not in ignored_init_params
+            if key not in ToolSpecExtractor._BASE_TOOL_FIELDS
         }
+        if "required" in json_schema:
+            json_schema["required"] = [
+                key
+                for key in json_schema["required"]
+                if key not in ToolSpecExtractor._BASE_TOOL_FIELDS
+            ]
         return json_schema
 
     def save_to_json(self, output_path: str) -> None:
diff --git a/lib/crewai-tools/tests/test_generate_tool_specs.py b/lib/crewai-tools/tests/test_generate_tool_specs.py
index 7506c4ee4..0841eeda6 100644
--- a/lib/crewai-tools/tests/test_generate_tool_specs.py
+++ b/lib/crewai-tools/tests/test_generate_tool_specs.py
@@ -45,6 +45,26 @@ class MockTool(BaseTool):
     )
 
 
+# --- Intermediate base class (like RagTool, BraveSearchToolBase) ---
+class MockIntermediateBase(BaseTool):
+    """Simulates an intermediate tool base class (e.g. RagTool, BraveSearchToolBase)."""
+
+    name: str = "Intermediate Base"
+    description: str = "An intermediate tool base"
+    shared_config: str = Field("default_config", description="Config from intermediate base")
+
+    def _run(self, query: str) -> str:
+        return query
+
+
+class MockDerivedTool(MockIntermediateBase):
+    """A tool inheriting from an intermediate base, like CodeDocsSearchTool(RagTool)."""
+
+    name: str = "Derived Tool"
+    description: str = "A tool that inherits from intermediate base"
+    derived_param: str = Field("derived_default", description="Param specific to derived tool")
+
+
 @pytest.fixture
 def extractor():
     ext = ToolSpecExtractor()
@@ -169,6 +189,87 @@ def test_extract_package_dependencies(mock_tool_extractor):
     ]
 
 
+def test_base_tool_fields_excluded_from_init_params(mock_tool_extractor):
+    """BaseTool internal fields (including computed_field like tool_type) must
+    never appear in init_params_schema. Studio reads this schema to render
+    the tool config UI — internal fields confuse users."""
+    init_schema = mock_tool_extractor["init_params_schema"]
+    props = set(init_schema.get("properties", {}).keys())
+    required = set(init_schema.get("required", []))
+
+    # These are all BaseTool's own fields — none should leak
+    base_fields = {"name", "description", "env_vars", "args_schema",
+                   "description_updated", "cache_function", "result_as_answer",
+                   "max_usage_count", "current_usage_count", "tool_type",
+                   "package_dependencies"}
+
+    leaked_props = base_fields & props
+    assert not leaked_props, (
+        f"BaseTool fields leaked into init_params_schema properties: {leaked_props}"
+    )
+    leaked_required = base_fields & required
+    assert not leaked_required, (
+        f"BaseTool fields leaked into init_params_schema required: {leaked_required}"
+    )
+
+
+def test_intermediate_base_fields_preserved_for_derived_tool(extractor):
+    """When a tool inherits from an intermediate base (e.g. RagTool),
+    the intermediate's fields should be included — only BaseTool's own
+    fields are excluded."""
+    with (
+        mock.patch(
+            "crewai_tools.generate_tool_specs.dir",
+            return_value=["MockDerivedTool"],
+        ),
+        mock.patch(
+            "crewai_tools.generate_tool_specs.getattr",
+            return_value=MockDerivedTool,
+        ),
+    ):
+        extractor.extract_all_tools()
+        assert len(extractor.tools_spec) == 1
+        tool_info = extractor.tools_spec[0]
+
+    props = set(tool_info["init_params_schema"].get("properties", {}).keys())
+
+    # Intermediate base's field should be preserved
+    assert "shared_config" in props, (
+        "Intermediate base class fields should be preserved in init_params_schema"
+    )
+    # Derived tool's own field should be preserved
+    assert "derived_param" in props, (
+        "Derived tool's own fields should be preserved in init_params_schema"
+    )
+    # BaseTool internals should still be excluded
+    assert "tool_type" not in props
+    assert "cache_function" not in props
+    assert "result_as_answer" not in props
+
+
+def test_future_base_tool_field_auto_excluded(extractor):
+    """If a new field is added to BaseTool in the future, it should be
+    automatically excluded from spec generation without needing to update
+    the ignored list. This test verifies the allowlist approach works
+    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),
+    ):
+        extractor.extract_all_tools()
+        tool_info = extractor.tools_spec[0]
+
+    props = set(tool_info["init_params_schema"].get("properties", {}).keys())
+    base_all = set(BaseTool.model_fields) | set(BaseTool.model_computed_fields)
+
+    leaked = base_all & props
+    assert not leaked, (
+        f"BaseTool fields should be auto-excluded but found: {leaked}. "
+        "The spec generator should dynamically compute BaseTool's fields "
+        "instead of using a hardcoded denylist."
+    )
+
+
 def test_save_to_json(extractor, tmp_path):
     extractor.tools_spec = [
         {
diff --git a/lib/crewai-tools/tool.specs.json b/lib/crewai-tools/tool.specs.json
index adc392bab..76ff76a4b 100644
--- a/lib/crewai-tools/tool.specs.json
+++ b/lib/crewai-tools/tool.specs.json
@@ -81,16 +81,9 @@
             ],
             "default": null,
             "title": "Mind Name"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "AIMindTool",
         "type": "object"
       },
@@ -168,20 +161,13 @@
             "title": "Save Dir",
             "type": "string"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "use_title_as_filename": {
             "default": false,
             "title": "Use Title As Filename",
             "type": "boolean"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "ArxivPaperTool",
         "type": "object"
       },
@@ -297,16 +283,9 @@
             "default": "https://api.search.brave.com/res/v1/images/search",
             "title": "Search Url",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "BraveImageSearchTool",
         "type": "object"
       },
@@ -488,16 +467,9 @@
             "default": "https://api.search.brave.com/res/v1/llm/context",
             "title": "Search Url",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "BraveLLMContextTool",
         "type": "object"
       },
@@ -775,16 +747,9 @@
             "default": "https://api.search.brave.com/res/v1/local/descriptions",
             "title": "Search Url",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "BraveLocalPOIsDescriptionTool",
         "type": "object"
       },
@@ -896,16 +861,9 @@
             "default": "https://api.search.brave.com/res/v1/local/pois",
             "title": "Search Url",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "BraveLocalPOIsTool",
         "type": "object"
       },
@@ -1062,16 +1020,9 @@
             "default": "https://api.search.brave.com/res/v1/news/search",
             "title": "Search Url",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "BraveNewsSearchTool",
         "type": "object"
       },
@@ -1344,16 +1295,9 @@
             "default": "https://api.search.brave.com/res/v1/web/search",
             "title": "Search Url",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "BraveSearchTool",
         "type": "object"
       },
@@ -1729,16 +1673,9 @@
             "default": "https://api.search.brave.com/res/v1/videos/search",
             "title": "Search Url",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "BraveVideoSearchTool",
         "type": "object"
       },
@@ -1999,16 +1936,9 @@
             "default": "https://api.search.brave.com/res/v1/web/search",
             "title": "Search Url",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "BraveWebSearchTool",
         "type": "object"
       },
@@ -2380,11 +2310,6 @@
             "title": "Format",
             "type": "string"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "url": {
             "anyOf": [
               {
@@ -2410,9 +2335,7 @@
             "title": "Zipcode"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "BrightDataDatasetTool",
         "type": "object"
       },
@@ -2590,20 +2513,13 @@
             "default": null,
             "title": "Search Type"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "zone": {
             "default": "",
             "title": "Zone",
             "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "BrightDataSearchTool",
         "type": "object"
       },
@@ -2774,11 +2690,6 @@
             "title": "Format",
             "type": "string"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "url": {
             "anyOf": [
               {
@@ -2797,9 +2708,7 @@
             "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "BrightDataWebUnlockerTool",
         "type": "object"
       },
@@ -2972,16 +2881,9 @@
             ],
             "default": false,
             "title": "Text Content"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "BrowserbaseLoadTool",
         "type": "object"
       },
@@ -4026,16 +3928,9 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "CSVSearchTool",
         "type": "object"
       },
@@ -5085,16 +4980,9 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "CodeDocsSearchTool",
         "type": "object"
       },
@@ -5172,18 +5060,8 @@
           }
         },
         "description": "Wrapper for composio tools.",
-        "properties": {
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          }
-        },
-        "required": [
-          "name",
-          "description",
-          "tool_type"
-        ],
+        "properties": {},
+        "required": [],
         "title": "ComposioTool",
         "type": "object"
       },
@@ -5246,16 +5124,10 @@
           "contextual_client": {
             "default": null,
             "title": "Contextual Client"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
-          "api_key",
-          "tool_type"
+          "api_key"
         ],
         "title": "ContextualAICreateAgentTool",
         "type": "object"
@@ -5348,16 +5220,10 @@
           "api_key": {
             "title": "Api Key",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
-          "api_key",
-          "tool_type"
+          "api_key"
         ],
         "title": "ContextualAIParseTool",
         "type": "object"
@@ -5475,16 +5341,10 @@
           "contextual_client": {
             "default": null,
             "title": "Contextual Client"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
-          "api_key",
-          "tool_type"
+          "api_key"
         ],
         "title": "ContextualAIQueryTool",
         "type": "object"
@@ -5575,16 +5435,10 @@
           "api_key": {
             "title": "Api Key",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
-          "api_key",
-          "tool_type"
+          "api_key"
         ],
         "title": "ContextualAIRerankTool",
         "type": "object"
@@ -5751,11 +5605,6 @@
             "description": "Specify whether the index is scoped. Is True by default.",
             "title": "Scoped Index",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
@@ -5763,8 +5612,7 @@
           "collection_name",
           "scope_name",
           "bucket_name",
-          "index_name",
-          "tool_type"
+          "index_name"
         ],
         "title": "CouchbaseFTSVectorSearchTool",
         "type": "object"
@@ -6809,16 +6657,9 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "DOCXSearchTool",
         "type": "object"
       },
@@ -6954,16 +6795,9 @@
             ],
             "default": "1024x1024",
             "title": "Size"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "DallETool",
         "type": "object"
       },
@@ -7064,16 +6898,9 @@
             ],
             "default": null,
             "title": "Default Warehouse Id"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "DatabricksQueryTool",
         "type": "object"
       },
@@ -7203,16 +7030,9 @@
             ],
             "default": null,
             "title": "Directory"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "DirectoryReadTool",
         "type": "object"
       },
@@ -8256,16 +8076,9 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "DirectorySearchTool",
         "type": "object"
       },
@@ -8409,11 +8222,6 @@
             "default": false,
             "title": "Summary"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "type": {
             "anyOf": [
               {
@@ -8427,9 +8235,7 @@
             "title": "Type"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "EXASearchTool",
         "type": "object"
       },
@@ -8536,16 +8342,8 @@
             "type": "object"
           }
         },
-        "properties": {
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          }
-        },
-        "required": [
-          "tool_type"
-        ],
+        "properties": {},
+        "required": [],
         "title": "FileCompressorTool",
         "type": "object"
       },
@@ -8647,16 +8445,9 @@
             ],
             "default": null,
             "title": "File Path"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "FileReadTool",
         "type": "object"
       },
@@ -8746,16 +8537,8 @@
             "type": "object"
           }
         },
-        "properties": {
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          }
-        },
-        "required": [
-          "tool_type"
-        ],
+        "properties": {},
+        "required": [],
         "title": "FileWriterTool",
         "type": "object"
       },
@@ -8878,16 +8661,9 @@
               }
             ],
             "title": "Config"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "FirecrawlCrawlWebsiteTool",
         "type": "object"
       },
@@ -8977,16 +8753,9 @@
             "additionalProperties": true,
             "title": "Config",
             "type": "object"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "FirecrawlScrapeWebsiteTool",
         "type": "object"
       },
@@ -9083,16 +8852,9 @@
               }
             ],
             "title": "Config"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "FirecrawlSearchTool",
         "type": "object"
       },
@@ -9187,16 +8949,9 @@
             ],
             "description": "The user's Personal Access Token to access CrewAI AMP API. If not provided, it will be loaded from the environment variable CREWAI_PERSONAL_ACCESS_TOKEN.",
             "title": "Personal Access Token"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "GenerateCrewaiAutomationTool",
         "type": "object"
       },
@@ -10264,16 +10019,10 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
-          "gh_token",
-          "tool_type"
+          "gh_token"
         ],
         "title": "GithubSearchTool",
         "type": "object"
@@ -10383,16 +10132,9 @@
             ],
             "default": null,
             "title": "Hyperbrowser"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "HyperbrowserLoadTool",
         "type": "object"
       },
@@ -10495,17 +10237,11 @@
             "default": 600,
             "title": "Max Polling Time",
             "type": "integer"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
           "crew_api_url",
-          "crew_bearer_token",
-          "tool_type"
+          "crew_bearer_token"
         ],
         "title": "InvokeCrewAIAutomationTool",
         "type": "object"
@@ -11550,16 +11286,9 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "JSONSearchTool",
         "type": "object"
       },
@@ -11649,11 +11378,6 @@
             "title": "Headers",
             "type": "object"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "website_url": {
             "anyOf": [
               {
@@ -11667,9 +11391,7 @@
             "title": "Website Url"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "JinaScrapeWebsiteTool",
         "type": "object"
       },
@@ -11740,16 +11462,8 @@
             "type": "object"
           }
         },
-        "properties": {
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          }
-        },
-        "required": [
-          "tool_type"
-        ],
+        "properties": {},
+        "required": [],
         "title": "LinkupSearchTool",
         "type": "object"
       },
@@ -11809,18 +11523,10 @@
         "properties": {
           "llama_index_tool": {
             "title": "Llama Index Tool"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
-          "name",
-          "description",
-          "llama_index_tool",
-          "tool_type"
+          "llama_index_tool"
         ],
         "title": "LlamaIndexTool",
         "type": "object"
@@ -12855,16 +12561,9 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "MDXSearchTool",
         "type": "object"
       },
@@ -12976,20 +12675,12 @@
             "description": "UUID of the Agent Handler Tool Pack to use",
             "title": "Tool Pack Id",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
-          "name",
-          "description",
           "tool_pack_id",
           "registered_user_id",
-          "tool_name",
-          "tool_type"
+          "tool_name"
         ],
         "title": "MergeAgentHandlerTool",
         "type": "object"
@@ -13173,11 +12864,6 @@
             "title": "Text Key",
             "type": "string"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "vector_index_name": {
             "default": "vector_index",
             "description": "Name of the Atlas Search vector index",
@@ -13188,8 +12874,7 @@
         "required": [
           "database_name",
           "collection_name",
-          "connection_string",
-          "tool_type"
+          "connection_string"
         ],
         "title": "MongoDBVectorSearchTool",
         "type": "object"
@@ -13296,16 +12981,9 @@
             ],
             "default": null,
             "title": "Session Id"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "MultiOnTool",
         "type": "object"
       },
@@ -14346,16 +14024,10 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
-          "db_uri",
-          "tool_type"
+          "db_uri"
         ],
         "title": "MySQLSearchTool",
         "type": "object"
@@ -14451,16 +14123,10 @@
             },
             "title": "Tables",
             "type": "array"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
-          "db_uri",
-          "tool_type"
+          "db_uri"
         ],
         "title": "NL2SQLTool",
         "type": "object"
@@ -14869,16 +14535,9 @@
         "properties": {
           "llm": {
             "$ref": "#/$defs/LLM"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "OCRTool",
         "type": "object"
       },
@@ -15075,17 +14734,11 @@
           },
           "oxylabs_api": {
             "title": "Oxylabs Api"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
           "oxylabs_api",
-          "config",
-          "tool_type"
+          "config"
         ],
         "title": "OxylabsAmazonProductScraperTool",
         "type": "object"
@@ -15310,17 +14963,11 @@
           },
           "oxylabs_api": {
             "title": "Oxylabs Api"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
           "oxylabs_api",
-          "config",
-          "tool_type"
+          "config"
         ],
         "title": "OxylabsAmazonSearchScraperTool",
         "type": "object"
@@ -15558,17 +15205,11 @@
           },
           "oxylabs_api": {
             "title": "Oxylabs Api"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
           "oxylabs_api",
-          "config",
-          "tool_type"
+          "config"
         ],
         "title": "OxylabsGoogleSearchScraperTool",
         "type": "object"
@@ -15754,17 +15395,11 @@
           },
           "oxylabs_api": {
             "title": "Oxylabs Api"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
           "oxylabs_api",
-          "config",
-          "tool_type"
+          "config"
         ],
         "title": "OxylabsUniversalScraperTool",
         "type": "object"
@@ -16822,16 +16457,9 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "PDFSearchTool",
         "type": "object"
       },
@@ -16913,16 +16541,9 @@
             "default": "https://api.parallel.ai/v1beta/search",
             "title": "Search Url",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "ParallelSearchTool",
         "type": "object"
       },
@@ -17081,16 +16702,9 @@
             },
             "title": "Evaluators",
             "type": "array"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "PatronusEvalTool",
         "type": "object"
       },
@@ -17156,17 +16770,11 @@
           "evaluator": {
             "title": "Evaluator",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
           "evaluator",
-          "evaluated_model_gold_answer",
-          "tool_type"
+          "evaluated_model_gold_answer"
         ],
         "title": "PatronusLocalEvaluatorTool",
         "type": "object"
@@ -17272,16 +16880,9 @@
             },
             "title": "Evaluators",
             "type": "array"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "PatronusPredefinedCriteriaEvalTool",
         "type": "object"
       },
@@ -17470,16 +17071,10 @@
             "description": "Base package path for Qdrant. Will dynamically import client and models.",
             "title": "Qdrant Package",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
-          "qdrant_config",
-          "tool_type"
+          "qdrant_config"
         ],
         "title": "QdrantVectorSearchTool",
         "type": "object"
@@ -18549,16 +18144,9 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "RagTool",
         "type": "object"
       },
@@ -18654,11 +18242,6 @@
             ],
             "title": "Headers"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "website_url": {
             "anyOf": [
               {
@@ -18672,9 +18255,7 @@
             "title": "Website Url"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "ScrapeElementFromWebsiteTool",
         "type": "object"
       },
@@ -18774,11 +18355,6 @@
             ],
             "title": "Headers"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "website_url": {
             "anyOf": [
               {
@@ -18792,9 +18368,7 @@
             "title": "Website Url"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "ScrapeWebsiteTool",
         "type": "object"
       },
@@ -18884,11 +18458,6 @@
             "title": "Enable Logging",
             "type": "boolean"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "user_prompt": {
             "anyOf": [
               {
@@ -18914,9 +18483,7 @@
             "title": "Website Url"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "ScrapegraphScrapeTool",
         "type": "object"
       },
@@ -19017,16 +18584,9 @@
             ],
             "default": null,
             "title": "Scrapfly"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "ScrapflyScrapeWebsiteTool",
         "type": "object"
       },
@@ -19184,11 +18744,6 @@
             "default": false,
             "title": "Return Html"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "wait_time": {
             "anyOf": [
               {
@@ -19214,9 +18769,7 @@
             "title": "Website Url"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "SeleniumScrapingTool",
         "type": "object"
       },
@@ -19306,16 +18859,9 @@
             ],
             "default": null,
             "title": "Client"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "SerpApiGoogleSearchTool",
         "type": "object"
       },
@@ -19411,16 +18957,9 @@
             ],
             "default": null,
             "title": "Client"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "SerpApiGoogleShoppingTool",
         "type": "object"
       },
@@ -19562,16 +19101,9 @@
             "default": "search",
             "title": "Search Type",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "SerperDevTool",
         "type": "object"
       },
@@ -19642,16 +19174,8 @@
             "type": "object"
           }
         },
-        "properties": {
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          }
-        },
-        "required": [
-          "tool_type"
-        ],
+        "properties": {},
+        "required": [],
         "title": "SerperScrapeWebsiteTool",
         "type": "object"
       },
@@ -20739,16 +20263,9 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "SerplyJobSearchTool",
         "type": "object"
       },
@@ -20862,16 +20379,9 @@
             "default": "https://api.serply.io/v1/news/",
             "title": "Search Url",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "SerplyNewsSearchTool",
         "type": "object"
       },
@@ -20985,16 +20495,9 @@
             "default": "https://api.serply.io/v1/scholar/",
             "title": "Search Url",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "SerplyScholarSearchTool",
         "type": "object"
       },
@@ -21144,16 +20647,9 @@
             "default": "https://api.serply.io/v1/search/",
             "title": "Search Url",
             "type": "string"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "SerplyWebSearchTool",
         "type": "object"
       },
@@ -22234,16 +21730,9 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "SerplyWebpageToMarkdownTool",
         "type": "object"
       },
@@ -22384,16 +21873,9 @@
             ],
             "default": null,
             "title": "Connection Pool"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "SingleStoreSearchTool",
         "type": "object"
       },
@@ -22604,16 +22086,10 @@
             "description": "Delay between retries in seconds",
             "title": "Retry Delay",
             "type": "number"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
         "required": [
-          "config",
-          "tool_type"
+          "config"
         ],
         "title": "SnowflakeSearchTool",
         "type": "object"
@@ -22800,11 +22276,6 @@
             "default": null,
             "title": "Spider"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "website_url": {
             "anyOf": [
               {
@@ -22818,9 +22289,7 @@
             "title": "Website Url"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "SpiderTool",
         "type": "object"
       },
@@ -22983,11 +22452,6 @@
             "default": "https://api.stagehand.browserbase.com/v1",
             "title": "Server Url"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "use_simplified_dom": {
             "default": true,
             "title": "Use Simplified Dom",
@@ -23004,9 +22468,7 @@
             "type": "boolean"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "StagehandTool",
         "type": "object"
       },
@@ -24084,11 +23546,6 @@
             "title": "Summarize",
             "type": "boolean"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "txt": {
             "anyOf": [
               {
@@ -24102,9 +23559,7 @@
             "title": "Txt"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "TXTSearchTool",
         "type": "object"
       },
@@ -24251,16 +23706,9 @@
             "description": "The timeout for the extraction request in seconds.",
             "title": "Timeout",
             "type": "integer"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "TavilyExtractorTool",
         "type": "object"
       },
@@ -24507,11 +23955,6 @@
             "title": "Timeout",
             "type": "integer"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "topic": {
             "default": "general",
             "description": "The topic to focus the search on.",
@@ -24524,9 +23967,7 @@
             "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "TavilySearchTool",
         "type": "object"
       },
@@ -24600,16 +24041,8 @@
           }
         },
         "description": "Tool for analyzing images using vision models.\n\nArgs:\n    llm: Optional LLM instance to use\n    model: Model identifier to use if no LLM is provided",
-        "properties": {
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          }
-        },
-        "required": [
-          "tool_type"
-        ],
+        "properties": {},
+        "required": [],
         "title": "VisionTool",
         "type": "object"
       },
@@ -24731,11 +24164,6 @@
             "default": null,
             "title": "Query"
           },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
-          },
           "vectorizer": {
             "title": "Vectorizer"
           },
@@ -24753,8 +24181,7 @@
         "required": [
           "collection_name",
           "weaviate_cluster_url",
-          "weaviate_api_key",
-          "tool_type"
+          "weaviate_api_key"
         ],
         "title": "WeaviateVectorSearchTool",
         "type": "object"
@@ -25801,16 +25228,9 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "WebsiteSearchTool",
         "type": "object"
       },
@@ -26860,16 +26280,9 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "XMLSearchTool",
         "type": "object"
       },
@@ -27919,16 +27332,9 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "YoutubeChannelSearchTool",
         "type": "object"
       },
@@ -28978,16 +28384,9 @@
             "default": false,
             "title": "Summarize",
             "type": "boolean"
-          },
-          "tool_type": {
-            "readOnly": true,
-            "title": "Tool Type",
-            "type": "string"
           }
         },
-        "required": [
-          "tool_type"
-        ],
+        "required": [],
         "title": "YoutubeVideoSearchTool",
         "type": "object"
       },

From 1c784695c1732dd03fedca21dbd2eb3d15dae8c9 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Wed, 8 Apr 2026 23:59:09 +0800
Subject: [PATCH 06/70] feat: add async checkpoint TUI browser

Launch a Textual TUI via `crewai checkpoint` to browse and resume
from checkpoints. Uses run_async/akickoff for fully async execution.
Adds provider auto-detection from file magic bytes.
---
 lib/crewai/src/crewai/cli/checkpoint_tui.py   | 366 ++++++++++++++++++
 lib/crewai/src/crewai/cli/cli.py              |  16 +-
 lib/crewai/src/crewai/crew.py                 |   4 +
 lib/crewai/src/crewai/state/provider/utils.py |  34 ++
 4 files changed, 417 insertions(+), 3 deletions(-)
 create mode 100644 lib/crewai/src/crewai/cli/checkpoint_tui.py
 create mode 100644 lib/crewai/src/crewai/state/provider/utils.py

diff --git a/lib/crewai/src/crewai/cli/checkpoint_tui.py b/lib/crewai/src/crewai/cli/checkpoint_tui.py
new file mode 100644
index 000000000..5f81d5fad
--- /dev/null
+++ b/lib/crewai/src/crewai/cli/checkpoint_tui.py
@@ -0,0 +1,366 @@
+"""Textual TUI for browsing checkpoint files."""
+
+from __future__ import annotations
+
+from typing import Any, ClassVar
+
+from textual.app import App, ComposeResult
+from textual.binding import Binding
+from textual.containers import Horizontal, Vertical
+from textual.screen import ModalScreen
+from textual.widgets import Button, Footer, Header, OptionList, Static
+from textual.widgets.option_list import Option
+
+from crewai.cli.checkpoint_cli import (
+    _entity_summary,
+    _format_size,
+    _is_sqlite,
+    _list_json,
+    _list_sqlite,
+)
+
+
+_PRIMARY = "#eb6658"
+_SECONDARY = "#1F7982"
+_TERTIARY = "#ffffff"
+_DIM = "#888888"
+_BG_DARK = "#0d1117"
+_BG_PANEL = "#161b22"
+
+
+def _load_entries(location: str) -> list[dict[str, Any]]:
+    if _is_sqlite(location):
+        return _list_sqlite(location)
+    return _list_json(location)
+
+
+def _format_list_label(entry: dict[str, Any]) -> str:
+    """Format a checkpoint entry for the list panel."""
+    name = entry.get("name", "")
+    ts = entry.get("ts") or ""
+    trigger = entry.get("trigger") or ""
+    summary = _entity_summary(entry.get("entities", []))
+
+    line1 = f"[bold]{name}[/]"
+    parts = []
+    if ts:
+        parts.append(f"[dim]{ts}[/]")
+    if "size" in entry:
+        parts.append(f"[dim]{_format_size(entry['size'])}[/]")
+    if trigger:
+        parts.append(f"[{_PRIMARY}]{trigger}[/]")
+    line2 = "  ".join(parts)
+    line3 = f"  [{_DIM}]{summary}[/]"
+
+    return f"{line1}\n{line2}\n{line3}"
+
+
+def _format_detail(entry: dict[str, Any]) -> str:
+    """Format checkpoint details for the right panel."""
+    lines: list[str] = []
+
+    # Header
+    name = entry.get("name", "")
+    lines.append(f"[bold {_PRIMARY}]{name}[/]")
+    lines.append(f"[{_DIM}]{'─' * 50}[/]")
+    lines.append("")
+
+    # Metadata table
+    ts = entry.get("ts") or "unknown"
+    trigger = entry.get("trigger") or ""
+    lines.append(f"  [bold]Time[/]       {ts}")
+    if "size" in entry:
+        lines.append(f"  [bold]Size[/]       {_format_size(entry['size'])}")
+    lines.append(f"  [bold]Events[/]     {entry.get('event_count', 0)}")
+    if trigger:
+        lines.append(f"  [bold]Trigger[/]    [{_PRIMARY}]{trigger}[/]")
+    if "path" in entry:
+        lines.append(f"  [bold]Path[/]       [{_DIM}]{entry['path']}[/]")
+    if "db" in entry:
+        lines.append(f"  [bold]Database[/]   [{_DIM}]{entry['db']}[/]")
+
+    # Entities
+    for ent in entry.get("entities", []):
+        eid = str(ent.get("id", ""))[:8]
+        etype = ent.get("type", "unknown")
+        ename = ent.get("name", "unnamed")
+
+        lines.append("")
+        lines.append(f"  [{_DIM}]{'─' * 50}[/]")
+        lines.append(f"  [bold {_SECONDARY}]{etype}[/]: {ename} [{_DIM}]{eid}[/]")
+
+        tasks = ent.get("tasks")
+        if isinstance(tasks, list):
+            completed = ent.get("tasks_completed", 0)
+            total = ent.get("tasks_total", 0)
+            pct = int(completed / total * 100) if total else 0
+            bar_len = 20
+            filled = int(bar_len * completed / total) if total else 0
+            bar = f"[{_PRIMARY}]{'█' * filled}[/][{_DIM}]{'░' * (bar_len - filled)}[/]"
+
+            lines.append(f"  {bar}  {completed}/{total} tasks ({pct}%)")
+            lines.append("")
+
+            for i, task in enumerate(tasks):
+                if task.get("completed"):
+                    icon = "[green]✓[/]"
+                else:
+                    icon = "[yellow]○[/]"
+                desc = str(task.get("description", ""))
+                if len(desc) > 55:
+                    desc = desc[:52] + "..."
+                lines.append(f"    {icon}  {i + 1}. {desc}")
+
+    return "\n".join(lines)
+
+
+class ConfirmResumeScreen(ModalScreen[bool]):
+    """Modal confirmation before resuming from a checkpoint."""
+
+    CSS = f"""
+    ConfirmResumeScreen {{
+        align: center middle;
+    }}
+    #confirm-dialog {{
+        width: 60;
+        height: auto;
+        padding: 1 2;
+        background: {_BG_PANEL};
+        border: round {_PRIMARY};
+    }}
+    #confirm-label {{
+        width: 100%;
+        content-align: center middle;
+        margin-bottom: 1;
+    }}
+    #confirm-name {{
+        width: 100%;
+        content-align: center middle;
+        color: {_PRIMARY};
+        text-style: bold;
+        margin-bottom: 1;
+    }}
+    #confirm-buttons {{
+        width: 100%;
+        height: 3;
+        layout: horizontal;
+        align: center middle;
+    }}
+    Button {{
+        margin: 0 2;
+        min-width: 12;
+    }}
+    """
+
+    def __init__(self, checkpoint_name: str) -> None:
+        super().__init__()
+        self._checkpoint_name = checkpoint_name
+
+    def compose(self) -> ComposeResult:
+        with Vertical(id="confirm-dialog"):
+            yield Static("Resume from this checkpoint?", id="confirm-label")
+            yield Static(self._checkpoint_name, id="confirm-name")
+            with Horizontal(id="confirm-buttons"):
+                yield Button("Resume", variant="success", id="btn-yes")
+                yield Button("Cancel", variant="default", id="btn-no")
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        self.dismiss(event.button.id == "btn-yes")
+
+    def on_key(self, event: Any) -> None:
+        if event.key == "y":
+            self.dismiss(True)
+        elif event.key in ("n", "escape"):
+            self.dismiss(False)
+
+
+class CheckpointTUI(App[str | None]):
+    """TUI to browse and inspect checkpoints.
+
+    Returns the checkpoint location string to resume from, or None if
+    the user quit without selecting.
+    """
+
+    TITLE = "CrewAI Checkpoints"
+
+    CSS = f"""
+    Screen {{
+        background: {_BG_DARK};
+    }}
+    Header {{
+        background: {_PRIMARY};
+        color: {_TERTIARY};
+    }}
+    Footer {{
+        background: {_SECONDARY};
+        color: {_TERTIARY};
+    }}
+    Footer > .footer-key--key {{
+        background: {_PRIMARY};
+        color: {_TERTIARY};
+    }}
+    Horizontal {{
+        height: 1fr;
+    }}
+    #cp-list {{
+        width: 38%;
+        background: {_BG_PANEL};
+        border: round {_SECONDARY};
+        padding: 0 1;
+        scrollbar-color: {_PRIMARY};
+    }}
+    #cp-list:focus {{
+        border: round {_PRIMARY};
+    }}
+    #cp-list > .option-list--option-highlighted {{
+        background: {_SECONDARY};
+        color: {_TERTIARY};
+        text-style: none;
+    }}
+    #cp-list > .option-list--option-highlighted * {{
+        color: {_TERTIARY};
+    }}
+    #detail-container {{
+        width: 62%;
+        padding: 0 1;
+    }}
+    #detail {{
+        height: 1fr;
+        background: {_BG_PANEL};
+        border: round {_SECONDARY};
+        padding: 1 2;
+        overflow-y: auto;
+        scrollbar-color: {_PRIMARY};
+    }}
+    #detail:focus {{
+        border: round {_PRIMARY};
+    }}
+    #status {{
+        height: 1;
+        padding: 0 2;
+        color: {_DIM};
+    }}
+    """
+
+    BINDINGS: ClassVar[list[Binding | tuple[str, str] | tuple[str, str, str]]] = [
+        ("q", "quit", "Quit"),
+        ("r", "refresh", "Refresh"),
+        ("j", "cursor_down", "Down"),
+        ("k", "cursor_up", "Up"),
+    ]
+
+    def __init__(self, location: str = "./.checkpoints") -> None:
+        super().__init__()
+        self._location = location
+        self._entries: list[dict[str, Any]] = []
+        self._selected_idx: int = 0
+        self._pending_location: str = ""
+
+    def compose(self) -> ComposeResult:
+        yield Header(show_clock=False)
+        with Horizontal():
+            yield OptionList(id="cp-list")
+            with Vertical(id="detail-container"):
+                yield Static("", id="status")
+                yield Static(
+                    f"\n  [{_DIM}]Select a checkpoint from the list[/]",  # noqa: S608
+                    id="detail",
+                )
+        yield Footer()
+
+    async def on_mount(self) -> None:
+        self.query_one("#cp-list", OptionList).border_title = "Checkpoints"
+        self.query_one("#detail", Static).border_title = "Detail"
+        self._refresh_list()
+
+    def _refresh_list(self) -> None:
+        self._entries = _load_entries(self._location)
+        option_list = self.query_one("#cp-list", OptionList)
+        option_list.clear_options()
+
+        if not self._entries:
+            self.query_one("#detail", Static).update(
+                f"\n  [{_DIM}]No checkpoints in {self._location}[/]"
+            )
+            self.query_one("#status", Static).update("")
+            self.sub_title = self._location
+            return
+
+        for entry in self._entries:
+            option_list.add_option(Option(_format_list_label(entry)))
+
+        count = len(self._entries)
+        storage = "SQLite" if _is_sqlite(self._location) else "JSON"
+        self.sub_title = f"{self._location}"
+        self.query_one("#status", Static).update(f" {count} checkpoint(s) | {storage}")
+
+    async def on_option_list_option_highlighted(
+        self,
+        event: OptionList.OptionHighlighted,
+    ) -> None:
+        idx = event.option_index
+        if idx is None:
+            return
+        if idx < len(self._entries):
+            self._selected_idx = idx
+            entry = self._entries[idx]
+            self.query_one("#detail", Static).update(_format_detail(entry))
+
+    def action_cursor_down(self) -> None:
+        self.query_one("#cp-list", OptionList).action_cursor_down()
+
+    def action_cursor_up(self) -> None:
+        self.query_one("#cp-list", OptionList).action_cursor_up()
+
+    async def on_option_list_option_selected(
+        self,
+        event: OptionList.OptionSelected,
+    ) -> None:
+        idx = event.option_index
+        if idx is None or idx >= len(self._entries):
+            return
+        entry = self._entries[idx]
+        if "path" in entry:
+            loc = entry["path"]
+        elif _is_sqlite(self._location):
+            loc = f"{self._location}#{entry['name']}"
+        else:
+            loc = entry.get("name", "")
+        self._pending_location = loc
+        name = entry.get("name", loc)
+        self.push_screen(ConfirmResumeScreen(name), self._on_confirm)
+
+    def _on_confirm(self, confirmed: bool | None) -> None:
+        if confirmed:
+            self.exit(self._pending_location)
+        else:
+            self._pending_location = ""
+
+    def action_refresh(self) -> None:
+        self._refresh_list()
+
+
+async def _run_checkpoint_tui_async(location: str) -> None:
+    """Async implementation of the checkpoint TUI flow."""
+    import click
+
+    app = CheckpointTUI(location=location)
+    selected = await app.run_async()
+
+    if selected is None:
+        return
+
+    click.echo(f"\nResuming from: {selected}\n")
+
+    from crewai.crew import Crew
+
+    crew = Crew.from_checkpoint(selected)
+    result = await crew.akickoff()
+    click.echo(f"\nResult: {getattr(result, 'raw', result)}")
+
+
+def run_checkpoint_tui(location: str = "./.checkpoints") -> None:
+    """Launch the checkpoint browser TUI."""
+    import asyncio
+
+    asyncio.run(_run_checkpoint_tui_async(location))
diff --git a/lib/crewai/src/crewai/cli/cli.py b/lib/crewai/src/crewai/cli/cli.py
index 57ff4551a..20a65dbe1 100644
--- a/lib/crewai/src/crewai/cli/cli.py
+++ b/lib/crewai/src/crewai/cli/cli.py
@@ -786,9 +786,19 @@ def traces_status() -> None:
     console.print(panel)
 
 
-@crewai.group()
-def checkpoint() -> None:
-    """Inspect checkpoint files."""
+@crewai.group(invoke_without_command=True)
+@click.option(
+    "--location", default="./.checkpoints", help="Checkpoint directory or SQLite file."
+)
+@click.pass_context
+def checkpoint(ctx: click.Context, location: str) -> None:
+    """Browse and inspect checkpoints. Launches a TUI when called without a subcommand."""
+    ctx.ensure_object(dict)
+    ctx.obj["location"] = location
+    if ctx.invoked_subcommand is None:
+        from crewai.cli.checkpoint_tui import run_checkpoint_tui
+
+        run_checkpoint_tui(location)
 
 
 @checkpoint.command("list")
diff --git a/lib/crewai/src/crewai/crew.py b/lib/crewai/src/crewai/crew.py
index 1c671467e..4090e706b 100644
--- a/lib/crewai/src/crewai/crew.py
+++ b/lib/crewai/src/crewai/crew.py
@@ -380,8 +380,12 @@ class Crew(FlowTrackable, BaseModel):
         from crewai.context import apply_execution_context
         from crewai.events.event_bus import crewai_event_bus
         from crewai.state.provider.json_provider import JsonProvider
+        from crewai.state.provider.utils import detect_provider
         from crewai.state.runtime import RuntimeState
 
+        if provider is None:
+            provider = detect_provider(path)
+
         state = RuntimeState.from_checkpoint(
             path,
             provider=provider or JsonProvider(),
diff --git a/lib/crewai/src/crewai/state/provider/utils.py b/lib/crewai/src/crewai/state/provider/utils.py
new file mode 100644
index 000000000..f4854cbe5
--- /dev/null
+++ b/lib/crewai/src/crewai/state/provider/utils.py
@@ -0,0 +1,34 @@
+"""Provider detection utilities."""
+
+from __future__ import annotations
+
+from crewai.state.provider.core import BaseProvider
+
+
+_SQLITE_MAGIC = b"SQLite format 3\x00"
+
+
+def detect_provider(path: str) -> BaseProvider:
+    """Detect the storage provider from a checkpoint path.
+
+    Reads the file's magic bytes to determine if it's a SQLite database.
+    For paths containing ``#``, checks the portion before the ``#``.
+    Falls back to JsonProvider.
+
+    Args:
+        path: A checkpoint file path, directory, or ``db_path#checkpoint_id``.
+
+    Returns:
+        The appropriate provider instance.
+    """
+    from crewai.state.provider.json_provider import JsonProvider
+    from crewai.state.provider.sqlite_provider import SqliteProvider
+
+    file_path = path.split("#")[0] if "#" in path else path
+    try:
+        with open(file_path, "rb") as f:
+            if f.read(16) == _SQLITE_MAGIC:
+                return SqliteProvider()
+    except OSError:
+        pass
+    return JsonProvider()

From 8bae7408993e81a5b98cdd7a0df6293d937b6b5c Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 9 Apr 2026 00:13:07 +0800
Subject: [PATCH 07/70] fix: use regex for template pyproject.toml version
 bumps

tomlkit.parse() fails on Jinja placeholders like {{folder_name}}
in CLI template files. Switch to regex replacement for templates.
---
 lib/devtools/src/crewai_devtools/cli.py |  9 ++++-
 lib/devtools/tests/test_toml_updates.py | 49 +++++++++++++++++++++++++
 2 files changed, 57 insertions(+), 1 deletion(-)

diff --git a/lib/devtools/src/crewai_devtools/cli.py b/lib/devtools/src/crewai_devtools/cli.py
index 785f943c7..c155026d9 100644
--- a/lib/devtools/src/crewai_devtools/cli.py
+++ b/lib/devtools/src/crewai_devtools/cli.py
@@ -514,6 +514,10 @@ def _pin_crewai_deps(content: str, version: str) -> str:
 def update_template_dependencies(templates_dir: Path, new_version: str) -> list[Path]:
     """Update crewai dependency versions in CLI template pyproject.toml files.
 
+    Uses simple string replacement instead of TOML parsing because
+    template files contain Jinja placeholders (``{{folder_name}}``)
+    that are not valid TOML.
+
     Args:
         templates_dir: Path to the CLI templates directory.
         new_version: New version string.
@@ -521,10 +525,13 @@ def update_template_dependencies(templates_dir: Path, new_version: str) -> list[
     Returns:
         List of paths that were updated.
     """
+    import re
+
+    pattern = re.compile(r"(crewai(?:\[[\w,]+\])?)(?:==|>=)[^\s\"']+")
     updated = []
     for pyproject in templates_dir.rglob("pyproject.toml"):
         content = pyproject.read_text()
-        new_content = _pin_crewai_deps(content, new_version)
+        new_content = pattern.sub(rf"\1=={new_version}", content)
         if new_content != content:
             pyproject.write_text(new_content)
             updated.append(pyproject)
diff --git a/lib/devtools/tests/test_toml_updates.py b/lib/devtools/tests/test_toml_updates.py
index eb93dd235..0a47283a9 100644
--- a/lib/devtools/tests/test_toml_updates.py
+++ b/lib/devtools/tests/test_toml_updates.py
@@ -7,6 +7,7 @@ from crewai_devtools.cli import (
     _pin_crewai_deps,
     _repin_crewai_install,
     update_pyproject_version,
+    update_template_dependencies,
 )
 
 
@@ -223,3 +224,51 @@ class TestRepinCrewaiInstall:
     def test_no_version_specifier_unchanged(self) -> None:
         cmd = 'pip install "crewai[tools]>=1.0"'
         assert _repin_crewai_install(cmd, "2.0.0") == cmd
+
+
+# --- update_template_dependencies ---
+
+
+class TestUpdateTemplateDependencies:
+    def test_updates_jinja_template(self, tmp_path: Path) -> None:
+        """Template pyproject.toml files with Jinja placeholders should not break."""
+        tpl = tmp_path / "crew" / "pyproject.toml"
+        tpl.parent.mkdir()
+        tpl.write_text(
+            dedent("""\
+            [project]
+            name = "{{folder_name}}"
+            version = "0.1.0"
+            dependencies = [
+                "crewai[tools]==1.14.0"
+            ]
+
+            [project.scripts]
+            {{folder_name}} = "{{folder_name}}.main:run"
+        """)
+        )
+
+        updated = update_template_dependencies(tmp_path, "2.0.0")
+
+        assert len(updated) == 1
+        content = tpl.read_text()
+        assert '"crewai[tools]==2.0.0"' in content
+        assert "{{folder_name}}" in content
+
+    def test_updates_bare_crewai(self, tmp_path: Path) -> None:
+        tpl = tmp_path / "pyproject.toml"
+        tpl.write_text('dependencies = [\n    "crewai==1.0.0"\n]\n')
+
+        updated = update_template_dependencies(tmp_path, "3.0.0")
+
+        assert len(updated) == 1
+        assert '"crewai==3.0.0"' in tpl.read_text()
+
+    def test_skips_unrelated_deps(self, tmp_path: Path) -> None:
+        tpl = tmp_path / "pyproject.toml"
+        tpl.write_text('dependencies = [\n    "requests>=2.0"\n]\n')
+
+        updated = update_template_dependencies(tmp_path, "2.0.0")
+
+        assert len(updated) == 0
+        assert '"requests>=2.0"' in tpl.read_text()

From 52c227ab17eb8ad2892c2cd0bbf8cebdd046f8fb Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 9 Apr 2026 00:22:24 +0800
Subject: [PATCH 08/70] feat: bump versions to 1.14.1rc1

---
 lib/crewai-files/src/crewai_files/__init__.py           | 2 +-
 lib/crewai-tools/pyproject.toml                         | 2 +-
 lib/crewai-tools/src/crewai_tools/__init__.py           | 2 +-
 lib/crewai/pyproject.toml                               | 2 +-
 lib/crewai/src/crewai/__init__.py                       | 2 +-
 lib/crewai/src/crewai/cli/templates/crew/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/flow/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/tool/pyproject.toml | 2 +-
 lib/devtools/src/crewai_devtools/__init__.py            | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/lib/crewai-files/src/crewai_files/__init__.py b/lib/crewai-files/src/crewai_files/__init__.py
index 7430288b5..0ca503d5a 100644
--- a/lib/crewai-files/src/crewai_files/__init__.py
+++ b/lib/crewai-files/src/crewai_files/__init__.py
@@ -152,4 +152,4 @@ __all__ = [
     "wrap_file_source",
 ]
 
-__version__ = "1.14.0"
+__version__ = "1.14.1rc1"
diff --git a/lib/crewai-tools/pyproject.toml b/lib/crewai-tools/pyproject.toml
index 7653f9851..f91954070 100644
--- a/lib/crewai-tools/pyproject.toml
+++ b/lib/crewai-tools/pyproject.toml
@@ -10,7 +10,7 @@ requires-python = ">=3.10, <3.14"
 dependencies = [
     "pytube~=15.0.0",
     "requests~=2.32.5",
-    "crewai==1.14.0",
+    "crewai==1.14.1rc1",
     "tiktoken~=0.8.0",
     "beautifulsoup4~=4.13.4",
     "python-docx~=1.2.0",
diff --git a/lib/crewai-tools/src/crewai_tools/__init__.py b/lib/crewai-tools/src/crewai_tools/__init__.py
index 2230e9afc..24fa5671f 100644
--- a/lib/crewai-tools/src/crewai_tools/__init__.py
+++ b/lib/crewai-tools/src/crewai_tools/__init__.py
@@ -305,4 +305,4 @@ __all__ = [
     "ZapierActionTools",
 ]
 
-__version__ = "1.14.0"
+__version__ = "1.14.1rc1"
diff --git a/lib/crewai/pyproject.toml b/lib/crewai/pyproject.toml
index 99749cc67..816dc132e 100644
--- a/lib/crewai/pyproject.toml
+++ b/lib/crewai/pyproject.toml
@@ -55,7 +55,7 @@ Repository = "https://github.com/crewAIInc/crewAI"
 
 [project.optional-dependencies]
 tools = [
-    "crewai-tools==1.14.0",
+    "crewai-tools==1.14.1rc1",
 ]
 embeddings = [
     "tiktoken~=0.8.0"
diff --git a/lib/crewai/src/crewai/__init__.py b/lib/crewai/src/crewai/__init__.py
index 1fdf84e70..98e5d5d11 100644
--- a/lib/crewai/src/crewai/__init__.py
+++ b/lib/crewai/src/crewai/__init__.py
@@ -46,7 +46,7 @@ def _suppress_pydantic_deprecation_warnings() -> None:
 
 _suppress_pydantic_deprecation_warnings()
 
-__version__ = "1.14.0"
+__version__ = "1.14.1rc1"
 _telemetry_submitted = False
 
 
diff --git a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
index 0fabbb1b3..1651fa1e3 100644
--- a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.0"
+    "crewai[tools]==1.14.1rc1"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
index e2f3e567e..7cd694ddf 100644
--- a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.0"
+    "crewai[tools]==1.14.1rc1"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
index 7f65a59a0..d88425e96 100644
--- a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
@@ -5,7 +5,7 @@ description = "Power up your crews with {{folder_name}}"
 readme = "README.md"
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.0"
+    "crewai[tools]==1.14.1rc1"
 ]
 
 [tool.crewai]
diff --git a/lib/devtools/src/crewai_devtools/__init__.py b/lib/devtools/src/crewai_devtools/__init__.py
index 54244d24f..9821c3cc3 100644
--- a/lib/devtools/src/crewai_devtools/__init__.py
+++ b/lib/devtools/src/crewai_devtools/__init__.py
@@ -1,3 +1,3 @@
 """CrewAI development tools."""
 
-__version__ = "1.14.0"
+__version__ = "1.14.1rc1"

From fe028ef4006013a40d0672fa822fee24d5c47c54 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 9 Apr 2026 00:29:04 +0800
Subject: [PATCH 09/70] docs: update changelog and version for v1.14.1rc1

---
 docs/ar/changelog.mdx    | 34 ++++++++++++++++++++++++++++++++++
 docs/en/changelog.mdx    | 34 ++++++++++++++++++++++++++++++++++
 docs/ko/changelog.mdx    | 34 ++++++++++++++++++++++++++++++++++
 docs/pt-BR/changelog.mdx | 34 ++++++++++++++++++++++++++++++++++
 4 files changed, 136 insertions(+)

diff --git a/docs/ar/changelog.mdx b/docs/ar/changelog.mdx
index b2f335d6c..8b6739241 100644
--- a/docs/ar/changelog.mdx
+++ b/docs/ar/changelog.mdx
@@ -4,6 +4,40 @@ description: "تحديثات المنتج والتحسينات وإصلاحات
 icon: "clock"
 mode: "wide"
 ---
+<Update label="9 أبريل 2026">
+  ## v1.14.1rc1
+
+  [عرض الإصدار على GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.1rc1)
+
+  ## ما الذي تغير
+
+  ### الميزات
+  - إضافة متصفح TUI لنقطة التحقق غير المتزامنة
+  - إضافة aclose()/close() ومدير سياق غير متزامن لمخرجات البث
+
+  ### إصلاحات الأخطاء
+  - إصلاح زيادة إصدارات pyproject.toml باستخدام التعبيرات العادية
+  - تنظيف أسماء الأدوات في مرشحات ديكور المكونات
+  - زيادة إصدار transformers إلى 5.5.0 لحل CVE-2026-1839
+  - تسجيل معالجات نقطة التحقق عند إنشاء CheckpointConfig
+
+  ### إعادة الهيكلة
+  - استبدال القائمة المحظورة الثابتة باستبعاد حقل BaseTool الديناميكي في توليد المواصفات
+  - استبدال التعبيرات العادية بـ tomlkit في واجهة سطر الأوامر devtools
+  - استخدام كائن PRINTER المشترك
+  - جعل BaseProvider نموذجًا أساسيًا مع مميز نوع المزود
+  - إزالة غلاف stdout/stderr لـ FilteredStream
+  - إزالة flow/config.py غير المستخدمة
+
+  ### الوثائق
+  - تحديث سجل التغييرات والإصدار لـ v1.14.0
+
+  ## المساهمون
+
+  @greysonlalonde, @iris-clawd, @joaomdmoura
+
+</Update>
+
 <Update label="7 أبريل 2026">
   ## v1.14.0
 
diff --git a/docs/en/changelog.mdx b/docs/en/changelog.mdx
index 891d9fc8b..62945af05 100644
--- a/docs/en/changelog.mdx
+++ b/docs/en/changelog.mdx
@@ -4,6 +4,40 @@ description: "Product updates, improvements, and bug fixes for CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="Apr 09, 2026">
+  ## v1.14.1rc1
+
+  [View release on GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.1rc1)
+
+  ## What's Changed
+
+  ### Features
+  - Add async checkpoint TUI browser
+  - Add aclose()/close() and async context manager to streaming outputs
+
+  ### Bug Fixes
+  - Fix template pyproject.toml version bumps using regex
+  - Sanitize tool names in hook decorator filters
+  - Bump transformers to 5.5.0 to resolve CVE-2026-1839
+  - Register checkpoint handlers when CheckpointConfig is created
+
+  ### Refactoring
+  - Replace hardcoded denylist with dynamic BaseTool field exclusion in spec gen
+  - Replace regex with tomlkit in devtools CLI
+  - Use shared PRINTER singleton
+  - Make BaseProvider a BaseModel with provider_type discriminator
+  - Remove FilteredStream stdout/stderr wrapper
+  - Remove unused flow/config.py
+
+  ### Documentation
+  - Update changelog and version for v1.14.0
+
+  ## Contributors
+
+  @greysonlalonde, @iris-clawd, @joaomdmoura
+
+</Update>
+
 <Update label="Apr 07, 2026">
   ## v1.14.0
 
diff --git a/docs/ko/changelog.mdx b/docs/ko/changelog.mdx
index ad4a3db79..5524cd317 100644
--- a/docs/ko/changelog.mdx
+++ b/docs/ko/changelog.mdx
@@ -4,6 +4,40 @@ description: "CrewAI의 제품 업데이트, 개선 사항 및 버그 수정"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="2026년 4월 9일">
+  ## v1.14.1rc1
+
+  [GitHub 릴리스 보기](https://github.com/crewAIInc/crewAI/releases/tag/1.14.1rc1)
+
+  ## 변경 사항
+
+  ### 기능
+  - 비동기 체크포인트 TUI 브라우저 추가
+  - 스트리밍 출력에 aclose()/close() 및 비동기 컨텍스트 관리자 추가
+
+  ### 버그 수정
+  - 정규 표현식을 사용하여 템플릿 pyproject.toml 버전 증가 수정
+  - 후크 데코레이터 필터에서 도구 이름 정리
+  - CVE-2026-1839 해결을 위해 transformers를 5.5.0으로 업데이트
+  - CheckpointConfig가 생성될 때 체크포인트 핸들러 등록
+
+  ### 리팩토링
+  - 하드코딩된 거부 목록을 동적 BaseTool 필드 제외로 교체
+  - devtools CLI에서 정규 표현식을 tomlkit으로 교체
+  - 공유 PRINTER 싱글톤 사용
+  - BaseProvider를 provider_type 구분자가 있는 BaseModel로 변경
+  - FilteredStream stdout/stderr 래퍼 제거
+  - 사용되지 않는 flow/config.py 제거
+
+  ### 문서
+  - v1.14.0에 대한 변경 로그 및 버전 업데이트
+
+  ## 기여자
+
+  @greysonlalonde, @iris-clawd, @joaomdmoura
+
+</Update>
+
 <Update label="2026년 4월 7일">
   ## v1.14.0
 
diff --git a/docs/pt-BR/changelog.mdx b/docs/pt-BR/changelog.mdx
index febf0d886..fd7e7c7cd 100644
--- a/docs/pt-BR/changelog.mdx
+++ b/docs/pt-BR/changelog.mdx
@@ -4,6 +4,40 @@ description: "Atualizações de produto, melhorias e correções do CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="09 abr 2026">
+  ## v1.14.1rc1
+
+  [Ver release no GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.1rc1)
+
+  ## O que Mudou
+
+  ### Recursos
+  - Adicionar navegador TUI de ponto de verificação assíncrono
+  - Adicionar aclose()/close() e gerenciador de contexto assíncrono para saídas de streaming
+
+  ### Correções de Bugs
+  - Corrigir aumentos de versão do template pyproject.toml usando regex
+  - Sanitizar nomes de ferramentas nos filtros do decorador de hook
+  - Atualizar transformers para 5.5.0 para resolver CVE-2026-1839
+  - Registrar manipuladores de ponto de verificação quando CheckpointConfig é criado
+
+  ### Refatoração
+  - Substituir lista de negação codificada por exclusão dinâmica de campo BaseTool na geração de especificações
+  - Substituir regex por tomlkit na CLI do devtools
+  - Usar singleton PRINTER compartilhado
+  - Tornar BaseProvider um BaseModel com discriminador de tipo de provedor
+  - Remover wrapper stdout/stderr de FilteredStream
+  - Remover flow/config.py não utilizado
+
+  ### Documentação
+  - Atualizar changelog e versão para v1.14.0
+
+  ## Contribuidores
+
+  @greysonlalonde, @iris-clawd, @joaomdmoura
+
+</Update>
+
 <Update label="07 abr 2026">
   ## v1.14.0
 

From 5c08e566b5b5f51a59f63910b6223d345322fe79 Mon Sep 17 00:00:00 2001
From: Lorenze Jay <63378463+lorenzejay@users.noreply.github.com>
Date: Wed, 8 Apr 2026 10:10:18 -0700
Subject: [PATCH 10/70] dedicate skills page (#5331)

---
 docs/ar/skills.mdx    | 50 +++++++++++++++++++++++++++++++++++++++++++
 docs/docs.json        | 40 ++++++++++++++++++++++++++++++++++
 docs/en/skills.mdx    | 50 +++++++++++++++++++++++++++++++++++++++++++
 docs/ko/skills.mdx    | 50 +++++++++++++++++++++++++++++++++++++++++++
 docs/pt-BR/skills.mdx | 50 +++++++++++++++++++++++++++++++++++++++++++
 5 files changed, 240 insertions(+)
 create mode 100644 docs/ar/skills.mdx
 create mode 100644 docs/en/skills.mdx
 create mode 100644 docs/ko/skills.mdx
 create mode 100644 docs/pt-BR/skills.mdx

diff --git a/docs/ar/skills.mdx b/docs/ar/skills.mdx
new file mode 100644
index 000000000..4e0bf6e22
--- /dev/null
+++ b/docs/ar/skills.mdx
@@ -0,0 +1,50 @@
+---
+title: Skills
+description: ثبّت crewaiinc/skills من السجل الرسمي على skills.sh—Flows وCrews ووكلاء مرتبطون بالوثائق لـ Claude Code وCursor وCodex وغيرها.
+icon: wand-magic-sparkles
+mode: "wide"
+---
+
+# Skills
+
+**امنح وكيل البرمجة سياق CrewAI في أمر واحد.**
+
+تُنشر **Skills** الخاصة بـ CrewAI على **[skills.sh/crewaiinc/skills](https://skills.sh/crewaiinc/skills)**—السجل الرسمي لـ `crewaiinc/skills`، بما في ذلك كل مهارة (مثل **design-agent** و**getting-started** و**design-task** و**ask-docs**) وإحصاءات التثبيت والتدقيقات. تعلّم وكلاء البرمجة—مثل Claude Code وCursor وCodex—هيكلة Flows وضبط Crews واستخدام الأدوات واتباع أنماط CrewAI. نفّذ الأمر أدناه (أو الصقه في الوكيل).
+
+```shell Terminal
+npx skills add crewaiinc/skills
+```
+
+يضيف ذلك حزمة المهارات إلى سير عمل الوكيل لتطبيق اتفاقيات CrewAI دون إعادة شرح الإطار في كل جلسة. المصدر والقضايا على [GitHub](https://github.com/crewAIInc/skills).
+
+## ما يحصل عليه الوكيل
+
+- **Flows** — تطبيقات ذات حالة وخطوات وkickoffs للـ crew على نمط CrewAI
+- **Crews والوكلاء** — أنماط YAML أولاً، أدوار، مهام، وتفويض
+- **الأدوات والتكاملات** — ربط الوكلاء بالبحث وواجهات API وأدوات CrewAI الشائعة
+- **هيكل المشروع** — مواءمة مع قوالب CLI واتفاقيات المستودع
+- **أنماط محدثة** — تتبع المهارات وثائق CrewAI والممارسات الموصى بها
+
+## تعرّف أكثر على هذا الموقع
+
+<CardGroup cols={2}>
+  <Card title="أدوات البرمجة و AGENTS.md" icon="terminal" href="/ar/guides/coding-tools/agents-md">
+    استخدام `AGENTS.md` وسير عمل وكلاء البرمجة مع CrewAI.
+  </Card>
+  <Card title="البداية السريعة" icon="rocket" href="/ar/quickstart">
+    ابنِ أول Flow وcrew من البداية للنهاية.
+  </Card>
+  <Card title="التثبيت" icon="download" href="/ar/installation">
+    ثبّت CrewAI CLI وحزمة Python.
+  </Card>
+  <Card title="سجل Skills (skills.sh)" icon="globe" href="https://skills.sh/crewaiinc/skills">
+    القائمة الرسمية لـ `crewaiinc/skills`—المهارات والتثبيتات والتدقيقات.
+  </Card>
+  <Card title="المصدر على GitHub" icon="code-branch" href="https://github.com/crewAIInc/skills">
+    مصدر الحزمة والتحديثات والقضايا.
+  </Card>
+</CardGroup>
+
+### فيديو: CrewAI مع مهارات وكلاء البرمجة
+
+<iframe src="https://www.loom.com/embed/befb9f68b81f42ad8112bfdd95a780af" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen style={{ width: "100%", height: "400px" }} />
diff --git a/docs/docs.json b/docs/docs.json
index 9d2679a19..ec4c519ba 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -79,6 +79,7 @@
                     "group": "Get Started",
                     "pages": [
                       "en/introduction",
+                      "en/skills",
                       "en/installation",
                       "en/quickstart"
                     ]
@@ -551,6 +552,7 @@
                     "group": "Get Started",
                     "pages": [
                       "en/introduction",
+                      "en/skills",
                       "en/installation",
                       "en/quickstart"
                     ]
@@ -1023,6 +1025,7 @@
                     "group": "Get Started",
                     "pages": [
                       "en/introduction",
+                      "en/skills",
                       "en/installation",
                       "en/quickstart"
                     ]
@@ -1495,6 +1498,7 @@
                     "group": "Get Started",
                     "pages": [
                       "en/introduction",
+                      "en/skills",
                       "en/installation",
                       "en/quickstart"
                     ]
@@ -1965,6 +1969,7 @@
                     "group": "Get Started",
                     "pages": [
                       "en/introduction",
+                      "en/skills",
                       "en/installation",
                       "en/quickstart"
                     ]
@@ -2435,6 +2440,7 @@
                     "group": "Get Started",
                     "pages": [
                       "en/introduction",
+                      "en/skills",
                       "en/installation",
                       "en/quickstart"
                     ]
@@ -2906,6 +2912,7 @@
                     "group": "Get Started",
                     "pages": [
                       "en/introduction",
+                      "en/skills",
                       "en/installation",
                       "en/quickstart"
                     ]
@@ -3378,6 +3385,7 @@
                     "group": "Get Started",
                     "pages": [
                       "en/introduction",
+                      "en/skills",
                       "en/installation",
                       "en/quickstart"
                     ]
@@ -3848,6 +3856,7 @@
                     "group": "Get Started",
                     "pages": [
                       "en/introduction",
+                      "en/skills",
                       "en/installation",
                       "en/quickstart"
                     ]
@@ -4351,6 +4360,7 @@
                     "group": "Começando",
                     "pages": [
                       "pt-BR/introduction",
+                      "pt-BR/skills",
                       "pt-BR/installation",
                       "pt-BR/quickstart"
                     ]
@@ -4808,6 +4818,7 @@
                     "group": "Começando",
                     "pages": [
                       "pt-BR/introduction",
+                      "pt-BR/skills",
                       "pt-BR/installation",
                       "pt-BR/quickstart"
                     ]
@@ -5265,6 +5276,7 @@
                     "group": "Começando",
                     "pages": [
                       "pt-BR/introduction",
+                      "pt-BR/skills",
                       "pt-BR/installation",
                       "pt-BR/quickstart"
                     ]
@@ -5722,6 +5734,7 @@
                     "group": "Começando",
                     "pages": [
                       "pt-BR/introduction",
+                      "pt-BR/skills",
                       "pt-BR/installation",
                       "pt-BR/quickstart"
                     ]
@@ -6178,6 +6191,7 @@
                     "group": "Começando",
                     "pages": [
                       "pt-BR/introduction",
+                      "pt-BR/skills",
                       "pt-BR/installation",
                       "pt-BR/quickstart"
                     ]
@@ -6634,6 +6648,7 @@
                     "group": "Começando",
                     "pages": [
                       "pt-BR/introduction",
+                      "pt-BR/skills",
                       "pt-BR/installation",
                       "pt-BR/quickstart"
                     ]
@@ -7090,6 +7105,7 @@
                     "group": "Começando",
                     "pages": [
                       "pt-BR/introduction",
+                      "pt-BR/skills",
                       "pt-BR/installation",
                       "pt-BR/quickstart"
                     ]
@@ -7545,6 +7561,7 @@
                     "group": "Começando",
                     "pages": [
                       "pt-BR/introduction",
+                      "pt-BR/skills",
                       "pt-BR/installation",
                       "pt-BR/quickstart"
                     ]
@@ -8000,6 +8017,7 @@
                     "group": "Começando",
                     "pages": [
                       "pt-BR/introduction",
+                      "pt-BR/skills",
                       "pt-BR/installation",
                       "pt-BR/quickstart"
                     ]
@@ -8486,6 +8504,7 @@
                     "group": "시작 안내",
                     "pages": [
                       "ko/introduction",
+                      "ko/skills",
                       "ko/installation",
                       "ko/quickstart"
                     ]
@@ -8955,6 +8974,7 @@
                     "group": "시작 안내",
                     "pages": [
                       "ko/introduction",
+                      "ko/skills",
                       "ko/installation",
                       "ko/quickstart"
                     ]
@@ -9424,6 +9444,7 @@
                     "group": "시작 안내",
                     "pages": [
                       "ko/introduction",
+                      "ko/skills",
                       "ko/installation",
                       "ko/quickstart"
                     ]
@@ -9893,6 +9914,7 @@
                     "group": "시작 안내",
                     "pages": [
                       "ko/introduction",
+                      "ko/skills",
                       "ko/installation",
                       "ko/quickstart"
                     ]
@@ -10361,6 +10383,7 @@
                     "group": "시작 안내",
                     "pages": [
                       "ko/introduction",
+                      "ko/skills",
                       "ko/installation",
                       "ko/quickstart"
                     ]
@@ -10829,6 +10852,7 @@
                     "group": "시작 안내",
                     "pages": [
                       "ko/introduction",
+                      "ko/skills",
                       "ko/installation",
                       "ko/quickstart"
                     ]
@@ -11297,6 +11321,7 @@
                     "group": "시작 안내",
                     "pages": [
                       "ko/introduction",
+                      "ko/skills",
                       "ko/installation",
                       "ko/quickstart"
                     ]
@@ -11764,6 +11789,7 @@
                     "group": "시작 안내",
                     "pages": [
                       "ko/introduction",
+                      "ko/skills",
                       "ko/installation",
                       "ko/quickstart"
                     ]
@@ -12231,6 +12257,7 @@
                     "group": "시작 안내",
                     "pages": [
                       "ko/introduction",
+                      "ko/skills",
                       "ko/installation",
                       "ko/quickstart"
                     ]
@@ -12729,6 +12756,7 @@
                     "group": "البدء",
                     "pages": [
                       "ar/introduction",
+                      "ar/skills",
                       "ar/installation",
                       "ar/quickstart"
                     ]
@@ -13198,6 +13226,7 @@
                     "group": "البدء",
                     "pages": [
                       "ar/introduction",
+                      "ar/skills",
                       "ar/installation",
                       "ar/quickstart"
                     ]
@@ -13667,6 +13696,7 @@
                     "group": "البدء",
                     "pages": [
                       "ar/introduction",
+                      "ar/skills",
                       "ar/installation",
                       "ar/quickstart"
                     ]
@@ -14136,6 +14166,7 @@
                     "group": "البدء",
                     "pages": [
                       "ar/introduction",
+                      "ar/skills",
                       "ar/installation",
                       "ar/quickstart"
                     ]
@@ -14604,6 +14635,7 @@
                     "group": "البدء",
                     "pages": [
                       "ar/introduction",
+                      "ar/skills",
                       "ar/installation",
                       "ar/quickstart"
                     ]
@@ -15072,6 +15104,7 @@
                     "group": "البدء",
                     "pages": [
                       "ar/introduction",
+                      "ar/skills",
                       "ar/installation",
                       "ar/quickstart"
                     ]
@@ -15540,6 +15573,7 @@
                     "group": "البدء",
                     "pages": [
                       "ar/introduction",
+                      "ar/skills",
                       "ar/installation",
                       "ar/quickstart"
                     ]
@@ -16007,6 +16041,7 @@
                     "group": "البدء",
                     "pages": [
                       "ar/introduction",
+                      "ar/skills",
                       "ar/installation",
                       "ar/quickstart"
                     ]
@@ -16474,6 +16509,7 @@
                     "group": "البدء",
                     "pages": [
                       "ar/introduction",
+                      "ar/skills",
                       "ar/installation",
                       "ar/quickstart"
                     ]
@@ -16985,6 +17021,10 @@
       "source": "/introduction",
       "destination": "/en/introduction"
     },
+    {
+      "source": "/skills",
+      "destination": "/en/skills"
+    },
     {
       "source": "/installation",
       "destination": "/en/installation"
diff --git a/docs/en/skills.mdx b/docs/en/skills.mdx
new file mode 100644
index 000000000..81260c88f
--- /dev/null
+++ b/docs/en/skills.mdx
@@ -0,0 +1,50 @@
+---
+title: Skills
+description: Install crewaiinc/skills from the official registry at skills.sh—Flows, Crews, and docs-aware agents for Claude Code, Cursor, Codex, and more.
+icon: wand-magic-sparkles
+mode: "wide"
+---
+
+# Skills
+
+**Give your AI coding agent CrewAI context in one command.**
+
+CrewAI **Skills** are published on **[skills.sh/crewaiinc/skills](https://skills.sh/crewaiinc/skills)**—the official registry for `crewaiinc/skills`, including individual skills (for example **design-agent**, **getting-started**, **design-task**, and **ask-docs**), install stats, and audits. They teach coding agents—like Claude Code, Cursor, and Codex—how to scaffold Flows, configure Crews, use tools, and follow CrewAI patterns. Run the install below (or paste it into your agent).
+
+```shell Terminal
+npx skills add crewaiinc/skills
+```
+
+That pulls the official skill pack into your agent workflow so it can apply CrewAI conventions without you re-explaining the framework each session. Source code and issues live on [GitHub](https://github.com/crewAIInc/skills).
+
+## What your agent gets
+
+- **Flows** — structure stateful apps, steps, and crew kickoffs the CrewAI way
+- **Crews & agents** — YAML-first patterns, roles, tasks, and delegation
+- **Tools & integrations** — hook agents to search, APIs, and common CrewAI tools
+- **Project layout** — align with CLI scaffolds and repo conventions
+- **Up-to-date patterns** — skills track current CrewAI docs and recommended practices
+
+## Learn more on this site
+
+<CardGroup cols={2}>
+  <Card title="Coding tools & AGENTS.md" icon="terminal" href="/en/guides/coding-tools/agents-md">
+    How to use `AGENTS.md` and coding-agent workflows with CrewAI.
+  </Card>
+  <Card title="Quickstart" icon="rocket" href="/en/quickstart">
+    Build your first Flow and crew end-to-end.
+  </Card>
+  <Card title="Installation" icon="download" href="/en/installation">
+    Install the CrewAI CLI and Python package.
+  </Card>
+  <Card title="Skills registry (skills.sh)" icon="globe" href="https://skills.sh/crewaiinc/skills">
+    Official listing for `crewaiinc/skills`—skills, installs, and audits.
+  </Card>
+  <Card title="GitHub source" icon="code-branch" href="https://github.com/crewAIInc/skills">
+    Source, updates, and issues for the skill pack.
+  </Card>
+</CardGroup>
+
+### Video: CrewAI with coding agent skills
+
+<iframe src="https://www.loom.com/embed/befb9f68b81f42ad8112bfdd95a780af" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen style={{ width: "100%", height: "400px" }} />
diff --git a/docs/ko/skills.mdx b/docs/ko/skills.mdx
new file mode 100644
index 000000000..0c789c158
--- /dev/null
+++ b/docs/ko/skills.mdx
@@ -0,0 +1,50 @@
+---
+title: Skills
+description: skills.sh의 공식 레지스트리에서 crewaiinc/skills를 설치하세요. Claude Code, Cursor, Codex 등을 위한 Flow, Crew, 문서 연동 스킬.
+icon: wand-magic-sparkles
+mode: "wide"
+---
+
+# Skills
+
+**한 번의 명령으로 코딩 에이전트에 CrewAI 컨텍스트를 제공하세요.**
+
+CrewAI **Skills**는 **[skills.sh/crewaiinc/skills](https://skills.sh/crewaiinc/skills)**에 게시됩니다. `crewaiinc/skills`의 공식 레지스트리로, 개별 스킬(예: **design-agent**, **getting-started**, **design-task**, **ask-docs**), 설치 수, 감사 정보를 확인할 수 있습니다. Claude Code, Cursor, Codex 같은 코딩 에이전트에게 Flow 구성, Crew 설정, 도구 사용, CrewAI 패턴을 가르칩니다. 아래를 실행하거나 에이전트에 붙여 넣으세요.
+
+```shell Terminal
+npx skills add crewaiinc/skills
+```
+
+에이전트 워크플로에 스킬 팩이 추가되어 세션마다 프레임워크를 다시 설명하지 않아도 CrewAI 관례를 적용할 수 있습니다. 소스와 이슈는 [GitHub](https://github.com/crewAIInc/skills)에서 관리합니다.
+
+## 에이전트가 얻는 것
+
+- **Flows** — CrewAI 방식의 상태ful 앱, 단계, crew kickoff
+- **Crew & 에이전트** — YAML 우선 패턴, 역할, 작업, 위임
+- **도구 & 통합** — 검색, API, 일반적인 CrewAI 도구 연결
+- **프로젝트 구조** — CLI 스캐폴드 및 저장소 관례와 정렬
+- **최신 패턴** — 스킬이 현재 CrewAI 문서 및 권장 사항을 반영
+
+## 이 사이트에서 더 알아보기
+
+<CardGroup cols={2}>
+  <Card title="코딩 도구 & AGENTS.md" icon="terminal" href="/ko/guides/coding-tools/agents-md">
+    CrewAI와 `AGENTS.md`, 코딩 에이전트 워크플로 사용법.
+  </Card>
+  <Card title="빠른 시작" icon="rocket" href="/ko/quickstart">
+    첫 Flow와 crew를 처음부터 끝까지 구축합니다.
+  </Card>
+  <Card title="설치" icon="download" href="/ko/installation">
+    CrewAI CLI와 Python 패키지를 설치합니다.
+  </Card>
+  <Card title="Skills 레지스트리 (skills.sh)" icon="globe" href="https://skills.sh/crewaiinc/skills">
+    `crewaiinc/skills` 공식 목록—스킬, 설치 수, 감사.
+  </Card>
+  <Card title="GitHub 소스" icon="code-branch" href="https://github.com/crewAIInc/skills">
+    스킬 팩 소스, 업데이트, 이슈.
+  </Card>
+</CardGroup>
+
+### 영상: 코딩 에이전트 스킬과 CrewAI
+
+<iframe src="https://www.loom.com/embed/befb9f68b81f42ad8112bfdd95a780af" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen style={{ width: "100%", height: "400px" }} />
diff --git a/docs/pt-BR/skills.mdx b/docs/pt-BR/skills.mdx
new file mode 100644
index 000000000..acd372d3f
--- /dev/null
+++ b/docs/pt-BR/skills.mdx
@@ -0,0 +1,50 @@
+---
+title: Skills
+description: Instale crewaiinc/skills pelo registro oficial em skills.sh—Flows, Crews e agentes alinhados à documentação para Claude Code, Cursor, Codex e outros.
+icon: wand-magic-sparkles
+mode: "wide"
+---
+
+# Skills
+
+**Dê ao seu agente de código o contexto do CrewAI em um comando.**
+
+As **Skills** do CrewAI são publicadas em **[skills.sh/crewaiinc/skills](https://skills.sh/crewaiinc/skills)**—o registro oficial de `crewaiinc/skills`, com cada skill (por exemplo **design-agent**, **getting-started**, **design-task** e **ask-docs**), estatísticas de instalação e auditorias. Ensinam agentes de código—como Claude Code, Cursor e Codex—a estruturar Flows, configurar Crews, usar ferramentas e seguir os padrões do CrewAI. Execute o comando abaixo (ou cole no seu agente).
+
+```shell Terminal
+npx skills add crewaiinc/skills
+```
+
+Isso adiciona o pacote de skills ao fluxo do seu agente para aplicar convenções do CrewAI sem precisar reexplicar o framework a cada sessão. Código-fonte e issues ficam no [GitHub](https://github.com/crewAIInc/skills).
+
+## O que seu agente ganha
+
+- **Flows** — apps com estado, passos e kickoffs de crew no estilo CrewAI
+- **Crews e agentes** — padrões YAML-first, papéis, tarefas e delegação
+- **Ferramentas e integrações** — conectar agentes a busca, APIs e ferramentas comuns
+- **Layout de projeto** — alinhar com scaffolds da CLI e convenções do repositório
+- **Padrões atualizados** — skills acompanham a documentação e as práticas recomendadas
+
+## Saiba mais neste site
+
+<CardGroup cols={2}>
+  <Card title="Ferramentas de codificação e AGENTS.md" icon="terminal" href="/pt-BR/guides/coding-tools/agents-md">
+    Como usar `AGENTS.md` e fluxos de agente de código com o CrewAI.
+  </Card>
+  <Card title="Início rápido" icon="rocket" href="/pt-BR/quickstart">
+    Construa seu primeiro Flow e crew ponta a ponta.
+  </Card>
+  <Card title="Instalação" icon="download" href="/pt-BR/installation">
+    Instale a CLI e o pacote Python do CrewAI.
+  </Card>
+  <Card title="Registro de skills (skills.sh)" icon="globe" href="https://skills.sh/crewaiinc/skills">
+    Listagem oficial de `crewaiinc/skills`—skills, instalações e auditorias.
+  </Card>
+  <Card title="Código no GitHub" icon="code-branch" href="https://github.com/crewAIInc/skills">
+    Fonte, atualizações e issues do pacote de skills.
+  </Card>
+</CardGroup>
+
+### Vídeo: CrewAI com coding agent skills
+
+<iframe src="https://www.loom.com/embed/befb9f68b81f42ad8112bfdd95a780af" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen style={{ width: "100%", height: "400px" }} />

From 00400a9f31d011a5cd9268b8247827740152b22f Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 9 Apr 2026 01:34:47 +0800
Subject: [PATCH 11/70] ci: skip python tests, lint, and type checks on
 docs-only PRs

---
 .github/workflows/linter.yml       | 24 ++++++++++++++++++++++--
 .github/workflows/tests.yml        | 24 ++++++++++++++++++++++--
 .github/workflows/type-checker.yml |  6 +++++-
 3 files changed, 49 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/linter.yml b/.github/workflows/linter.yml
index 633d6c0e0..419820b19 100644
--- a/.github/workflows/linter.yml
+++ b/.github/workflows/linter.yml
@@ -1,12 +1,16 @@
 name: Lint
 
-on: [pull_request]
+on:
+  pull_request:
+    paths-ignore:
+      - 'docs/**'
+      - '**/*.md'
 
 permissions:
   contents: read
 
 jobs:
-  lint:
+  lint-run:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -48,3 +52,19 @@ jobs:
             ~/.local/share/uv
             .venv
           key: uv-main-py3.11-${{ hashFiles('uv.lock') }}
+
+  # Summary job to provide single status for branch protection
+  lint:
+    name: lint
+    runs-on: ubuntu-latest
+    needs: lint-run
+    if: always()
+    steps:
+      - name: Check lint results
+        run: |
+          if [ "${{ needs.lint-run.result }}" == "success" ] || [ "${{ needs.lint-run.result }}" == "skipped" ]; then
+            echo "Lint passed"
+          else
+            echo "Lint failed"
+            exit 1
+          fi
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index fb75beb8a..8f1c1dab4 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -1,12 +1,16 @@
 name: Run Tests
 
-on: [pull_request]
+on:
+  pull_request:
+    paths-ignore:
+      - 'docs/**'
+      - '**/*.md'
 
 permissions:
   contents: read
 
 jobs:
-  tests:
+  tests-matrix:
     name: tests (${{ matrix.python-version }})
     runs-on: ubuntu-latest
     timeout-minutes: 15
@@ -98,3 +102,19 @@ jobs:
             ~/.local/share/uv
             .venv
           key: uv-main-py${{ matrix.python-version }}-${{ hashFiles('uv.lock') }}
+
+  # Summary job to provide single status for branch protection
+  tests:
+    name: tests
+    runs-on: ubuntu-latest
+    needs: tests-matrix
+    if: always()
+    steps:
+      - name: Check matrix results
+        run: |
+          if [ "${{ needs.tests-matrix.result }}" == "success" ] || [ "${{ needs.tests-matrix.result }}" == "skipped" ]; then
+            echo "All tests passed"
+          else
+            echo "Tests failed"
+            exit 1
+          fi
diff --git a/.github/workflows/type-checker.yml b/.github/workflows/type-checker.yml
index 2bab1ebb7..f423e304c 100644
--- a/.github/workflows/type-checker.yml
+++ b/.github/workflows/type-checker.yml
@@ -1,6 +1,10 @@
 name: Run Type Checks
 
-on: [pull_request]
+on:
+  pull_request:
+    paths-ignore:
+      - 'docs/**'
+      - '**/*.md'
 
 permissions:
   contents: read

From a0578bb6c3db57f7f763fe8b385ff9382dcfc064 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 9 Apr 2026 01:45:40 +0800
Subject: [PATCH 12/70] feat: bump versions to 1.14.1

---
 lib/crewai-files/src/crewai_files/__init__.py           | 2 +-
 lib/crewai-tools/pyproject.toml                         | 2 +-
 lib/crewai-tools/src/crewai_tools/__init__.py           | 2 +-
 lib/crewai/pyproject.toml                               | 2 +-
 lib/crewai/src/crewai/__init__.py                       | 2 +-
 lib/crewai/src/crewai/cli/templates/crew/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/flow/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/tool/pyproject.toml | 2 +-
 lib/devtools/src/crewai_devtools/__init__.py            | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/lib/crewai-files/src/crewai_files/__init__.py b/lib/crewai-files/src/crewai_files/__init__.py
index 0ca503d5a..ae22cac91 100644
--- a/lib/crewai-files/src/crewai_files/__init__.py
+++ b/lib/crewai-files/src/crewai_files/__init__.py
@@ -152,4 +152,4 @@ __all__ = [
     "wrap_file_source",
 ]
 
-__version__ = "1.14.1rc1"
+__version__ = "1.14.1"
diff --git a/lib/crewai-tools/pyproject.toml b/lib/crewai-tools/pyproject.toml
index f91954070..6d9d54dca 100644
--- a/lib/crewai-tools/pyproject.toml
+++ b/lib/crewai-tools/pyproject.toml
@@ -10,7 +10,7 @@ requires-python = ">=3.10, <3.14"
 dependencies = [
     "pytube~=15.0.0",
     "requests~=2.32.5",
-    "crewai==1.14.1rc1",
+    "crewai==1.14.1",
     "tiktoken~=0.8.0",
     "beautifulsoup4~=4.13.4",
     "python-docx~=1.2.0",
diff --git a/lib/crewai-tools/src/crewai_tools/__init__.py b/lib/crewai-tools/src/crewai_tools/__init__.py
index 24fa5671f..e8719da6a 100644
--- a/lib/crewai-tools/src/crewai_tools/__init__.py
+++ b/lib/crewai-tools/src/crewai_tools/__init__.py
@@ -305,4 +305,4 @@ __all__ = [
     "ZapierActionTools",
 ]
 
-__version__ = "1.14.1rc1"
+__version__ = "1.14.1"
diff --git a/lib/crewai/pyproject.toml b/lib/crewai/pyproject.toml
index 816dc132e..96fa9b511 100644
--- a/lib/crewai/pyproject.toml
+++ b/lib/crewai/pyproject.toml
@@ -55,7 +55,7 @@ Repository = "https://github.com/crewAIInc/crewAI"
 
 [project.optional-dependencies]
 tools = [
-    "crewai-tools==1.14.1rc1",
+    "crewai-tools==1.14.1",
 ]
 embeddings = [
     "tiktoken~=0.8.0"
diff --git a/lib/crewai/src/crewai/__init__.py b/lib/crewai/src/crewai/__init__.py
index 98e5d5d11..9d5ffb5f2 100644
--- a/lib/crewai/src/crewai/__init__.py
+++ b/lib/crewai/src/crewai/__init__.py
@@ -46,7 +46,7 @@ def _suppress_pydantic_deprecation_warnings() -> None:
 
 _suppress_pydantic_deprecation_warnings()
 
-__version__ = "1.14.1rc1"
+__version__ = "1.14.1"
 _telemetry_submitted = False
 
 
diff --git a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
index 1651fa1e3..9c137bd2e 100644
--- a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.1rc1"
+    "crewai[tools]==1.14.1"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
index 7cd694ddf..0fbb2d52c 100644
--- a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.1rc1"
+    "crewai[tools]==1.14.1"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
index d88425e96..6ded8a798 100644
--- a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
@@ -5,7 +5,7 @@ description = "Power up your crews with {{folder_name}}"
 readme = "README.md"
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.1rc1"
+    "crewai[tools]==1.14.1"
 ]
 
 [tool.crewai]
diff --git a/lib/devtools/src/crewai_devtools/__init__.py b/lib/devtools/src/crewai_devtools/__init__.py
index 9821c3cc3..f82569e9a 100644
--- a/lib/devtools/src/crewai_devtools/__init__.py
+++ b/lib/devtools/src/crewai_devtools/__init__.py
@@ -1,3 +1,3 @@
 """CrewAI development tools."""
 
-__version__ = "1.14.1rc1"
+__version__ = "1.14.1"

From 15f5bff0437e8794ff9962ffb3a092cf1263585f Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 9 Apr 2026 01:56:51 +0800
Subject: [PATCH 13/70] docs: update changelog and version for v1.14.1

---
 .github/workflows/linter.yml       |   33 +-
 .github/workflows/tests.yml        |   33 +-
 .github/workflows/type-checker.yml |   37 +-
 docs/ar/changelog.mdx              |   33 +
 docs/docs.json                     | 1879 +++++++++++++++++++++++++++-
 docs/en/changelog.mdx              |   33 +
 docs/ko/changelog.mdx              |   33 +
 docs/pt-BR/changelog.mdx           |   33 +
 8 files changed, 2084 insertions(+), 30 deletions(-)

diff --git a/.github/workflows/linter.yml b/.github/workflows/linter.yml
index 419820b19..b62b0eba5 100644
--- a/.github/workflows/linter.yml
+++ b/.github/workflows/linter.yml
@@ -1,16 +1,29 @@
 name: Lint
 
-on:
-  pull_request:
-    paths-ignore:
-      - 'docs/**'
-      - '**/*.md'
+on: [pull_request]
 
 permissions:
   contents: read
 
 jobs:
+  changes:
+    name: Detect changes
+    runs-on: ubuntu-latest
+    outputs:
+      code: ${{ steps.filter.outputs.code }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            code:
+              - '!docs/**'
+              - '!**/*.md'
+
   lint-run:
+    needs: changes
+    if: needs.changes.outputs.code == 'true'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -57,12 +70,16 @@ jobs:
   lint:
     name: lint
     runs-on: ubuntu-latest
-    needs: lint-run
+    needs: [changes, lint-run]
     if: always()
     steps:
-      - name: Check lint results
+      - name: Check results
         run: |
-          if [ "${{ needs.lint-run.result }}" == "success" ] || [ "${{ needs.lint-run.result }}" == "skipped" ]; then
+          if [ "${{ needs.changes.outputs.code }}" != "true" ]; then
+            echo "Docs-only change, skipping lint"
+            exit 0
+          fi
+          if [ "${{ needs.lint-run.result }}" == "success" ]; then
             echo "Lint passed"
           else
             echo "Lint failed"
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 8f1c1dab4..71a7b801a 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -1,17 +1,30 @@
 name: Run Tests
 
-on:
-  pull_request:
-    paths-ignore:
-      - 'docs/**'
-      - '**/*.md'
+on: [pull_request]
 
 permissions:
   contents: read
 
 jobs:
+  changes:
+    name: Detect changes
+    runs-on: ubuntu-latest
+    outputs:
+      code: ${{ steps.filter.outputs.code }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            code:
+              - '!docs/**'
+              - '!**/*.md'
+
   tests-matrix:
     name: tests (${{ matrix.python-version }})
+    needs: changes
+    if: needs.changes.outputs.code == 'true'
     runs-on: ubuntu-latest
     timeout-minutes: 15
     strategy:
@@ -107,12 +120,16 @@ jobs:
   tests:
     name: tests
     runs-on: ubuntu-latest
-    needs: tests-matrix
+    needs: [changes, tests-matrix]
     if: always()
     steps:
-      - name: Check matrix results
+      - name: Check results
         run: |
-          if [ "${{ needs.tests-matrix.result }}" == "success" ] || [ "${{ needs.tests-matrix.result }}" == "skipped" ]; then
+          if [ "${{ needs.changes.outputs.code }}" != "true" ]; then
+            echo "Docs-only change, skipping tests"
+            exit 0
+          fi
+          if [ "${{ needs.tests-matrix.result }}" == "success" ]; then
             echo "All tests passed"
           else
             echo "Tests failed"
diff --git a/.github/workflows/type-checker.yml b/.github/workflows/type-checker.yml
index f423e304c..8d88d4b6a 100644
--- a/.github/workflows/type-checker.yml
+++ b/.github/workflows/type-checker.yml
@@ -1,17 +1,30 @@
 name: Run Type Checks
 
-on:
-  pull_request:
-    paths-ignore:
-      - 'docs/**'
-      - '**/*.md'
+on: [pull_request]
 
 permissions:
   contents: read
 
 jobs:
+  changes:
+    name: Detect changes
+    runs-on: ubuntu-latest
+    outputs:
+      code: ${{ steps.filter.outputs.code }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            code:
+              - '!docs/**'
+              - '!**/*.md'
+
   type-checker-matrix:
     name: type-checker (${{ matrix.python-version }})
+    needs: changes
+    if: needs.changes.outputs.code == 'true'
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
@@ -61,14 +74,18 @@ jobs:
   type-checker:
     name: type-checker
     runs-on: ubuntu-latest
-    needs: type-checker-matrix
+    needs: [changes, type-checker-matrix]
     if: always()
     steps:
-      - name: Check matrix results
+      - name: Check results
         run: |
-          if [ "${{ needs.type-checker-matrix.result }}" == "success" ] || [ "${{ needs.type-checker-matrix.result }}" == "skipped" ]; then
-            echo "✅ All type checks passed"
+          if [ "${{ needs.changes.outputs.code }}" != "true" ]; then
+            echo "Docs-only change, skipping type checks"
+            exit 0
+          fi
+          if [ "${{ needs.type-checker-matrix.result }}" == "success" ]; then
+            echo "All type checks passed"
           else
-            echo "❌ Type checks failed"
+            echo "Type checks failed"
             exit 1
           fi
diff --git a/docs/ar/changelog.mdx b/docs/ar/changelog.mdx
index 8b6739241..f8997da03 100644
--- a/docs/ar/changelog.mdx
+++ b/docs/ar/changelog.mdx
@@ -4,6 +4,39 @@ description: "تحديثات المنتج والتحسينات وإصلاحات
 icon: "clock"
 mode: "wide"
 ---
+<Update label="9 أبريل 2026">
+  ## v1.14.1
+
+  [عرض الإصدار على GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.1)
+
+  ## ما الذي تغير
+
+  ### الميزات
+  - إضافة متصفح TUI لنقاط التفتيش غير المتزامنة
+  - إضافة دالة aclose()/close() ومدير سياق غير متزامن لمخرجات البث
+
+  ### إصلاحات الأخطاء
+  - إصلاح التعبير النمطي لزيادة إصدار pyproject.toml
+  - تنظيف أسماء الأدوات في مرشحات زخرفة الخطاف
+  - إصلاح تسجيل معالجات نقاط التفتيش عند إنشاء CheckpointConfig
+  - رفع إصدار transformers إلى 5.5.0 لحل CVE-2026-1839
+  - إزالة غلاف FilteredStream لـ stdout/stderr
+
+  ### الوثائق
+  - تحديث سجل التغييرات والإصدار لـ v1.14.1rc1
+
+  ### إعادة الهيكلة
+  - استبدال القائمة المحظورة الثابتة باستبعاد حقل BaseTool الديناميكي في توليد المواصفات
+  - استبدال التعبير النمطي بـ tomlkit في واجهة سطر أوامر أدوات التطوير
+  - استخدام كائن PRINTER المشترك
+  - جعل BaseProvider نموذجاً أساسياً مع مميز نوع المزود
+
+  ## المساهمون
+
+  @greysonlalonde, @iris-clawd, @joaomdmoura, @lorenzejay
+
+</Update>
+
 <Update label="9 أبريل 2026">
   ## v1.14.1rc1
 
diff --git a/docs/docs.json b/docs/docs.json
index ec4c519ba..c175143ba 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -56,7 +56,7 @@
         },
         "versions": [
           {
-            "version": "v1.14.0",
+            "version": "v1.14.1",
             "default": true,
             "tabs": [
               {
@@ -529,6 +529,479 @@
               }
             ]
           },
+          {
+            "version": "v1.14.0",
+            "tabs": [
+              {
+                "tab": "Home",
+                "icon": "house",
+                "groups": [
+                  {
+                    "group": "Welcome",
+                    "pages": [
+                      "index"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "Documentation",
+                "icon": "book-open",
+                "groups": [
+                  {
+                    "group": "Get Started",
+                    "pages": [
+                      "en/introduction",
+                      "en/skills",
+                      "en/installation",
+                      "en/quickstart"
+                    ]
+                  },
+                  {
+                    "group": "Guides",
+                    "pages": [
+                      {
+                        "group": "Strategy",
+                        "icon": "compass",
+                        "pages": [
+                          "en/guides/concepts/evaluating-use-cases"
+                        ]
+                      },
+                      {
+                        "group": "Agents",
+                        "icon": "user",
+                        "pages": [
+                          "en/guides/agents/crafting-effective-agents"
+                        ]
+                      },
+                      {
+                        "group": "Crews",
+                        "icon": "users",
+                        "pages": [
+                          "en/guides/crews/first-crew"
+                        ]
+                      },
+                      {
+                        "group": "Flows",
+                        "icon": "code-branch",
+                        "pages": [
+                          "en/guides/flows/first-flow",
+                          "en/guides/flows/mastering-flow-state"
+                        ]
+                      },
+                      {
+                        "group": "Tools",
+                        "icon": "wrench",
+                        "pages": [
+                          "en/guides/tools/publish-custom-tools"
+                        ]
+                      },
+                      {
+                        "group": "Coding Tools",
+                        "icon": "terminal",
+                        "pages": [
+                          "en/guides/coding-tools/agents-md"
+                        ]
+                      },
+                      {
+                        "group": "Advanced",
+                        "icon": "gear",
+                        "pages": [
+                          "en/guides/advanced/customizing-prompts",
+                          "en/guides/advanced/fingerprinting"
+                        ]
+                      },
+                      {
+                        "group": "Migration",
+                        "icon": "shuffle",
+                        "pages": [
+                          "en/guides/migration/migrating-from-langgraph"
+                        ]
+                      }
+                    ]
+                  },
+                  {
+                    "group": "Core Concepts",
+                    "pages": [
+                      "en/concepts/agents",
+                      "en/concepts/agent-capabilities",
+                      "en/concepts/tasks",
+                      "en/concepts/crews",
+                      "en/concepts/flows",
+                      "en/concepts/production-architecture",
+                      "en/concepts/knowledge",
+                      "en/concepts/skills",
+                      "en/concepts/llms",
+                      "en/concepts/files",
+                      "en/concepts/processes",
+                      "en/concepts/collaboration",
+                      "en/concepts/training",
+                      "en/concepts/memory",
+                      "en/concepts/reasoning",
+                      "en/concepts/planning",
+                      "en/concepts/testing",
+                      "en/concepts/cli",
+                      "en/concepts/tools",
+                      "en/concepts/event-listener",
+                      "en/concepts/checkpointing"
+                    ]
+                  },
+                  {
+                    "group": "MCP Integration",
+                    "pages": [
+                      "en/mcp/overview",
+                      "en/mcp/dsl-integration",
+                      "en/mcp/stdio",
+                      "en/mcp/sse",
+                      "en/mcp/streamable-http",
+                      "en/mcp/multiple-servers",
+                      "en/mcp/security"
+                    ]
+                  },
+                  {
+                    "group": "Tools",
+                    "pages": [
+                      "en/tools/overview",
+                      {
+                        "group": "File & Document",
+                        "icon": "folder-open",
+                        "pages": [
+                          "en/tools/file-document/overview",
+                          "en/tools/file-document/filereadtool",
+                          "en/tools/file-document/filewritetool",
+                          "en/tools/file-document/pdfsearchtool",
+                          "en/tools/file-document/docxsearchtool",
+                          "en/tools/file-document/mdxsearchtool",
+                          "en/tools/file-document/xmlsearchtool",
+                          "en/tools/file-document/txtsearchtool",
+                          "en/tools/file-document/jsonsearchtool",
+                          "en/tools/file-document/csvsearchtool",
+                          "en/tools/file-document/directorysearchtool",
+                          "en/tools/file-document/directoryreadtool",
+                          "en/tools/file-document/ocrtool",
+                          "en/tools/file-document/pdf-text-writing-tool"
+                        ]
+                      },
+                      {
+                        "group": "Web Scraping & Browsing",
+                        "icon": "globe",
+                        "pages": [
+                          "en/tools/web-scraping/overview",
+                          "en/tools/web-scraping/scrapewebsitetool",
+                          "en/tools/web-scraping/scrapeelementfromwebsitetool",
+                          "en/tools/web-scraping/scrapflyscrapetool",
+                          "en/tools/web-scraping/seleniumscrapingtool",
+                          "en/tools/web-scraping/scrapegraphscrapetool",
+                          "en/tools/web-scraping/spidertool",
+                          "en/tools/web-scraping/browserbaseloadtool",
+                          "en/tools/web-scraping/hyperbrowserloadtool",
+                          "en/tools/web-scraping/stagehandtool",
+                          "en/tools/web-scraping/firecrawlcrawlwebsitetool",
+                          "en/tools/web-scraping/firecrawlscrapewebsitetool",
+                          "en/tools/web-scraping/oxylabsscraperstool",
+                          "en/tools/web-scraping/brightdata-tools"
+                        ]
+                      },
+                      {
+                        "group": "Search & Research",
+                        "icon": "magnifying-glass",
+                        "pages": [
+                          "en/tools/search-research/overview",
+                          "en/tools/search-research/serperdevtool",
+                          "en/tools/search-research/bravesearchtool",
+                          "en/tools/search-research/exasearchtool",
+                          "en/tools/search-research/linkupsearchtool",
+                          "en/tools/search-research/githubsearchtool",
+                          "en/tools/search-research/websitesearchtool",
+                          "en/tools/search-research/codedocssearchtool",
+                          "en/tools/search-research/youtubechannelsearchtool",
+                          "en/tools/search-research/youtubevideosearchtool",
+                          "en/tools/search-research/tavilysearchtool",
+                          "en/tools/search-research/tavilyextractortool",
+                          "en/tools/search-research/arxivpapertool",
+                          "en/tools/search-research/serpapi-googlesearchtool",
+                          "en/tools/search-research/serpapi-googleshoppingtool",
+                          "en/tools/search-research/databricks-query-tool"
+                        ]
+                      },
+                      {
+                        "group": "Database & Data",
+                        "icon": "database",
+                        "pages": [
+                          "en/tools/database-data/overview",
+                          "en/tools/database-data/mysqltool",
+                          "en/tools/database-data/pgsearchtool",
+                          "en/tools/database-data/snowflakesearchtool",
+                          "en/tools/database-data/nl2sqltool",
+                          "en/tools/database-data/qdrantvectorsearchtool",
+                          "en/tools/database-data/weaviatevectorsearchtool",
+                          "en/tools/database-data/mongodbvectorsearchtool",
+                          "en/tools/database-data/singlestoresearchtool"
+                        ]
+                      },
+                      {
+                        "group": "AI & Machine Learning",
+                        "icon": "brain",
+                        "pages": [
+                          "en/tools/ai-ml/overview",
+                          "en/tools/ai-ml/dalletool",
+                          "en/tools/ai-ml/visiontool",
+                          "en/tools/ai-ml/aimindtool",
+                          "en/tools/ai-ml/llamaindextool",
+                          "en/tools/ai-ml/langchaintool",
+                          "en/tools/ai-ml/ragtool",
+                          "en/tools/ai-ml/codeinterpretertool"
+                        ]
+                      },
+                      {
+                        "group": "Cloud & Storage",
+                        "icon": "cloud",
+                        "pages": [
+                          "en/tools/cloud-storage/overview",
+                          "en/tools/cloud-storage/s3readertool",
+                          "en/tools/cloud-storage/s3writertool",
+                          "en/tools/cloud-storage/bedrockkbretriever"
+                        ]
+                      },
+                      {
+                        "group": "Integrations",
+                        "icon": "plug",
+                        "pages": [
+                          "en/tools/integration/overview",
+                          "en/tools/integration/bedrockinvokeagenttool",
+                          "en/tools/integration/crewaiautomationtool",
+                          "en/tools/integration/mergeagenthandlertool"
+                        ]
+                      },
+                      {
+                        "group": "Automation",
+                        "icon": "bolt",
+                        "pages": [
+                          "en/tools/automation/overview",
+                          "en/tools/automation/apifyactorstool",
+                          "en/tools/automation/composiotool",
+                          "en/tools/automation/multiontool",
+                          "en/tools/automation/zapieractionstool"
+                        ]
+                      }
+                    ]
+                  },
+                  {
+                    "group": "Observability",
+                    "pages": [
+                      "en/observability/tracing",
+                      "en/observability/overview",
+                      "en/observability/arize-phoenix",
+                      "en/observability/braintrust",
+                      "en/observability/datadog",
+                      "en/observability/galileo",
+                      "en/observability/langdb",
+                      "en/observability/langfuse",
+                      "en/observability/langtrace",
+                      "en/observability/maxim",
+                      "en/observability/mlflow",
+                      "en/observability/neatlogs",
+                      "en/observability/openlit",
+                      "en/observability/opik",
+                      "en/observability/patronus-evaluation",
+                      "en/observability/portkey",
+                      "en/observability/weave",
+                      "en/observability/truefoundry"
+                    ]
+                  },
+                  {
+                    "group": "Learn",
+                    "pages": [
+                      "en/learn/overview",
+                      "en/learn/llm-selection-guide",
+                      "en/learn/conditional-tasks",
+                      "en/learn/coding-agents",
+                      "en/learn/create-custom-tools",
+                      "en/learn/custom-llm",
+                      "en/learn/custom-manager-agent",
+                      "en/learn/customizing-agents",
+                      "en/learn/dalle-image-generation",
+                      "en/learn/force-tool-output-as-result",
+                      "en/learn/hierarchical-process",
+                      "en/learn/human-input-on-execution",
+                      "en/learn/human-in-the-loop",
+                      "en/learn/human-feedback-in-flows",
+                      "en/learn/kickoff-async",
+                      "en/learn/kickoff-for-each",
+                      "en/learn/llm-connections",
+                      "en/learn/litellm-removal-guide",
+                      "en/learn/multimodal-agents",
+                      "en/learn/replay-tasks-from-latest-crew-kickoff",
+                      "en/learn/sequential-process",
+                      "en/learn/using-annotations",
+                      "en/learn/execution-hooks",
+                      "en/learn/llm-hooks",
+                      "en/learn/tool-hooks"
+                    ]
+                  },
+                  {
+                    "group": "Telemetry",
+                    "pages": [
+                      "en/telemetry"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "AMP",
+                "icon": "briefcase",
+                "groups": [
+                  {
+                    "group": "Getting Started",
+                    "pages": [
+                      "en/enterprise/introduction"
+                    ]
+                  },
+                  {
+                    "group": "Build",
+                    "pages": [
+                      "en/enterprise/features/automations",
+                      "en/enterprise/features/crew-studio",
+                      "en/enterprise/features/marketplace",
+                      "en/enterprise/features/agent-repositories",
+                      "en/enterprise/features/tools-and-integrations",
+                      "en/enterprise/features/pii-trace-redactions"
+                    ]
+                  },
+                  {
+                    "group": "Operate",
+                    "pages": [
+                      "en/enterprise/features/traces",
+                      "en/enterprise/features/webhook-streaming",
+                      "en/enterprise/features/hallucination-guardrail",
+                      "en/enterprise/features/flow-hitl-management"
+                    ]
+                  },
+                  {
+                    "group": "Manage",
+                    "pages": [
+                      "en/enterprise/features/sso",
+                      "en/enterprise/features/rbac"
+                    ]
+                  },
+                  {
+                    "group": "Integration Docs",
+                    "pages": [
+                      "en/enterprise/integrations/asana",
+                      "en/enterprise/integrations/box",
+                      "en/enterprise/integrations/clickup",
+                      "en/enterprise/integrations/github",
+                      "en/enterprise/integrations/gmail",
+                      "en/enterprise/integrations/google_calendar",
+                      "en/enterprise/integrations/google_contacts",
+                      "en/enterprise/integrations/google_docs",
+                      "en/enterprise/integrations/google_drive",
+                      "en/enterprise/integrations/google_sheets",
+                      "en/enterprise/integrations/google_slides",
+                      "en/enterprise/integrations/hubspot",
+                      "en/enterprise/integrations/jira",
+                      "en/enterprise/integrations/linear",
+                      "en/enterprise/integrations/microsoft_excel",
+                      "en/enterprise/integrations/microsoft_onedrive",
+                      "en/enterprise/integrations/microsoft_outlook",
+                      "en/enterprise/integrations/microsoft_sharepoint",
+                      "en/enterprise/integrations/microsoft_teams",
+                      "en/enterprise/integrations/microsoft_word",
+                      "en/enterprise/integrations/notion",
+                      "en/enterprise/integrations/salesforce",
+                      "en/enterprise/integrations/shopify",
+                      "en/enterprise/integrations/slack",
+                      "en/enterprise/integrations/stripe",
+                      "en/enterprise/integrations/zendesk"
+                    ]
+                  },
+                  {
+                    "group": "Triggers",
+                    "pages": [
+                      "en/enterprise/guides/automation-triggers",
+                      "en/enterprise/guides/gmail-trigger",
+                      "en/enterprise/guides/google-calendar-trigger",
+                      "en/enterprise/guides/google-drive-trigger",
+                      "en/enterprise/guides/outlook-trigger",
+                      "en/enterprise/guides/onedrive-trigger",
+                      "en/enterprise/guides/microsoft-teams-trigger",
+                      "en/enterprise/guides/slack-trigger",
+                      "en/enterprise/guides/hubspot-trigger",
+                      "en/enterprise/guides/salesforce-trigger",
+                      "en/enterprise/guides/zapier-trigger"
+                    ]
+                  },
+                  {
+                    "group": "How-To Guides",
+                    "pages": [
+                      "en/enterprise/guides/build-crew",
+                      "en/enterprise/guides/prepare-for-deployment",
+                      "en/enterprise/guides/deploy-to-amp",
+                      "en/enterprise/guides/private-package-registry",
+                      "en/enterprise/guides/kickoff-crew",
+                      "en/enterprise/guides/update-crew",
+                      "en/enterprise/guides/enable-crew-studio",
+                      "en/enterprise/guides/capture_telemetry_logs",
+                      "en/enterprise/guides/azure-openai-setup",
+                      "en/enterprise/guides/tool-repository",
+                      "en/enterprise/guides/custom-mcp-server",
+                      "en/enterprise/guides/react-component-export",
+                      "en/enterprise/guides/team-management",
+                      "en/enterprise/guides/human-in-the-loop",
+                      "en/enterprise/guides/webhook-automation"
+                    ]
+                  },
+                  {
+                    "group": "Resources",
+                    "pages": [
+                      "en/enterprise/resources/frequently-asked-questions"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "API Reference",
+                "icon": "magnifying-glass",
+                "groups": [
+                  {
+                    "group": "Getting Started",
+                    "pages": [
+                      "en/api-reference/introduction",
+                      "en/api-reference/inputs",
+                      "en/api-reference/kickoff",
+                      "en/api-reference/resume",
+                      "en/api-reference/status"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "Examples",
+                "icon": "code",
+                "groups": [
+                  {
+                    "group": "Examples",
+                    "pages": [
+                      "en/examples/example",
+                      "en/examples/cookbooks"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "Changelog",
+                "icon": "clock",
+                "groups": [
+                  {
+                    "group": "Release Notes",
+                    "pages": [
+                      "en/changelog"
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
           {
             "version": "v1.13.0",
             "tabs": [
@@ -4337,7 +4810,7 @@
         },
         "versions": [
           {
-            "version": "v1.14.0",
+            "version": "v1.14.1",
             "default": true,
             "tabs": [
               {
@@ -4795,6 +5268,464 @@
               }
             ]
           },
+          {
+            "version": "v1.14.0",
+            "tabs": [
+              {
+                "tab": "Início",
+                "icon": "house",
+                "groups": [
+                  {
+                    "group": "Bem-vindo",
+                    "pages": [
+                      "pt-BR/index"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "Documentação",
+                "icon": "book-open",
+                "groups": [
+                  {
+                    "group": "Começando",
+                    "pages": [
+                      "pt-BR/introduction",
+                      "pt-BR/skills",
+                      "pt-BR/installation",
+                      "pt-BR/quickstart"
+                    ]
+                  },
+                  {
+                    "group": "Guias",
+                    "pages": [
+                      {
+                        "group": "Estratégia",
+                        "icon": "compass",
+                        "pages": [
+                          "pt-BR/guides/concepts/evaluating-use-cases"
+                        ]
+                      },
+                      {
+                        "group": "Agentes",
+                        "icon": "user",
+                        "pages": [
+                          "pt-BR/guides/agents/crafting-effective-agents"
+                        ]
+                      },
+                      {
+                        "group": "Crews",
+                        "icon": "users",
+                        "pages": [
+                          "pt-BR/guides/crews/first-crew"
+                        ]
+                      },
+                      {
+                        "group": "Flows",
+                        "icon": "code-branch",
+                        "pages": [
+                          "pt-BR/guides/flows/first-flow",
+                          "pt-BR/guides/flows/mastering-flow-state"
+                        ]
+                      },
+                      {
+                        "group": "Ferramentas",
+                        "icon": "wrench",
+                        "pages": [
+                          "pt-BR/guides/tools/publish-custom-tools"
+                        ]
+                      },
+                      {
+                        "group": "Ferramentas de Codificação",
+                        "icon": "terminal",
+                        "pages": [
+                          "pt-BR/guides/coding-tools/agents-md"
+                        ]
+                      },
+                      {
+                        "group": "Avançado",
+                        "icon": "gear",
+                        "pages": [
+                          "pt-BR/guides/advanced/customizing-prompts",
+                          "pt-BR/guides/advanced/fingerprinting"
+                        ]
+                      },
+                      {
+                        "group": "Migração",
+                        "icon": "shuffle",
+                        "pages": [
+                          "pt-BR/guides/migration/migrating-from-langgraph"
+                        ]
+                      }
+                    ]
+                  },
+                  {
+                    "group": "Conceitos-Chave",
+                    "pages": [
+                      "pt-BR/concepts/agents",
+                      "pt-BR/concepts/agent-capabilities",
+                      "pt-BR/concepts/tasks",
+                      "pt-BR/concepts/crews",
+                      "pt-BR/concepts/flows",
+                      "pt-BR/concepts/production-architecture",
+                      "pt-BR/concepts/knowledge",
+                      "pt-BR/concepts/skills",
+                      "pt-BR/concepts/llms",
+                      "pt-BR/concepts/files",
+                      "pt-BR/concepts/processes",
+                      "pt-BR/concepts/collaboration",
+                      "pt-BR/concepts/training",
+                      "pt-BR/concepts/memory",
+                      "pt-BR/concepts/reasoning",
+                      "pt-BR/concepts/planning",
+                      "pt-BR/concepts/testing",
+                      "pt-BR/concepts/cli",
+                      "pt-BR/concepts/tools",
+                      "pt-BR/concepts/event-listener",
+                      "pt-BR/concepts/checkpointing"
+                    ]
+                  },
+                  {
+                    "group": "Integração MCP",
+                    "pages": [
+                      "pt-BR/mcp/overview",
+                      "pt-BR/mcp/dsl-integration",
+                      "pt-BR/mcp/stdio",
+                      "pt-BR/mcp/sse",
+                      "pt-BR/mcp/streamable-http",
+                      "pt-BR/mcp/multiple-servers",
+                      "pt-BR/mcp/security"
+                    ]
+                  },
+                  {
+                    "group": "Ferramentas",
+                    "pages": [
+                      "pt-BR/tools/overview",
+                      {
+                        "group": "Arquivo & Documento",
+                        "icon": "folder-open",
+                        "pages": [
+                          "pt-BR/tools/file-document/overview",
+                          "pt-BR/tools/file-document/filereadtool",
+                          "pt-BR/tools/file-document/filewritetool",
+                          "pt-BR/tools/file-document/pdfsearchtool",
+                          "pt-BR/tools/file-document/docxsearchtool",
+                          "pt-BR/tools/file-document/mdxsearchtool",
+                          "pt-BR/tools/file-document/xmlsearchtool",
+                          "pt-BR/tools/file-document/txtsearchtool",
+                          "pt-BR/tools/file-document/jsonsearchtool",
+                          "pt-BR/tools/file-document/csvsearchtool",
+                          "pt-BR/tools/file-document/directorysearchtool",
+                          "pt-BR/tools/file-document/directoryreadtool"
+                        ]
+                      },
+                      {
+                        "group": "Web Scraping & Navegação",
+                        "icon": "globe",
+                        "pages": [
+                          "pt-BR/tools/web-scraping/overview",
+                          "pt-BR/tools/web-scraping/scrapewebsitetool",
+                          "pt-BR/tools/web-scraping/scrapeelementfromwebsitetool",
+                          "pt-BR/tools/web-scraping/scrapflyscrapetool",
+                          "pt-BR/tools/web-scraping/seleniumscrapingtool",
+                          "pt-BR/tools/web-scraping/scrapegraphscrapetool",
+                          "pt-BR/tools/web-scraping/spidertool",
+                          "pt-BR/tools/web-scraping/browserbaseloadtool",
+                          "pt-BR/tools/web-scraping/hyperbrowserloadtool",
+                          "pt-BR/tools/web-scraping/stagehandtool",
+                          "pt-BR/tools/web-scraping/firecrawlcrawlwebsitetool",
+                          "pt-BR/tools/web-scraping/firecrawlscrapewebsitetool",
+                          "pt-BR/tools/web-scraping/oxylabsscraperstool"
+                        ]
+                      },
+                      {
+                        "group": "Pesquisa",
+                        "icon": "magnifying-glass",
+                        "pages": [
+                          "pt-BR/tools/search-research/overview",
+                          "pt-BR/tools/search-research/serperdevtool",
+                          "pt-BR/tools/search-research/bravesearchtool",
+                          "pt-BR/tools/search-research/exasearchtool",
+                          "pt-BR/tools/search-research/linkupsearchtool",
+                          "pt-BR/tools/search-research/githubsearchtool",
+                          "pt-BR/tools/search-research/websitesearchtool",
+                          "pt-BR/tools/search-research/codedocssearchtool",
+                          "pt-BR/tools/search-research/youtubechannelsearchtool",
+                          "pt-BR/tools/search-research/youtubevideosearchtool"
+                        ]
+                      },
+                      {
+                        "group": "Dados",
+                        "icon": "database",
+                        "pages": [
+                          "pt-BR/tools/database-data/overview",
+                          "pt-BR/tools/database-data/mysqltool",
+                          "pt-BR/tools/database-data/pgsearchtool",
+                          "pt-BR/tools/database-data/snowflakesearchtool",
+                          "pt-BR/tools/database-data/nl2sqltool",
+                          "pt-BR/tools/database-data/qdrantvectorsearchtool",
+                          "pt-BR/tools/database-data/weaviatevectorsearchtool"
+                        ]
+                      },
+                      {
+                        "group": "IA & Machine Learning",
+                        "icon": "brain",
+                        "pages": [
+                          "pt-BR/tools/ai-ml/overview",
+                          "pt-BR/tools/ai-ml/dalletool",
+                          "pt-BR/tools/ai-ml/visiontool",
+                          "pt-BR/tools/ai-ml/aimindtool",
+                          "pt-BR/tools/ai-ml/llamaindextool",
+                          "pt-BR/tools/ai-ml/langchaintool",
+                          "pt-BR/tools/ai-ml/ragtool",
+                          "pt-BR/tools/ai-ml/codeinterpretertool"
+                        ]
+                      },
+                      {
+                        "group": "Cloud & Armazenamento",
+                        "icon": "cloud",
+                        "pages": [
+                          "pt-BR/tools/cloud-storage/overview",
+                          "pt-BR/tools/cloud-storage/s3readertool",
+                          "pt-BR/tools/cloud-storage/s3writertool",
+                          "pt-BR/tools/cloud-storage/bedrockkbretriever"
+                        ]
+                      },
+                      {
+                        "group": "Integrations",
+                        "icon": "plug",
+                        "pages": [
+                          "pt-BR/tools/integration/overview",
+                          "pt-BR/tools/integration/bedrockinvokeagenttool",
+                          "pt-BR/tools/integration/crewaiautomationtool"
+                        ]
+                      },
+                      {
+                        "group": "Automação",
+                        "icon": "bolt",
+                        "pages": [
+                          "pt-BR/tools/automation/overview",
+                          "pt-BR/tools/automation/apifyactorstool",
+                          "pt-BR/tools/automation/composiotool",
+                          "pt-BR/tools/automation/multiontool"
+                        ]
+                      }
+                    ]
+                  },
+                  {
+                    "group": "Observabilidade",
+                    "pages": [
+                      "pt-BR/observability/tracing",
+                      "pt-BR/observability/overview",
+                      "pt-BR/observability/arize-phoenix",
+                      "pt-BR/observability/braintrust",
+                      "pt-BR/observability/datadog",
+                      "pt-BR/observability/galileo",
+                      "pt-BR/observability/langdb",
+                      "pt-BR/observability/langfuse",
+                      "pt-BR/observability/langtrace",
+                      "pt-BR/observability/maxim",
+                      "pt-BR/observability/mlflow",
+                      "pt-BR/observability/openlit",
+                      "pt-BR/observability/opik",
+                      "pt-BR/observability/patronus-evaluation",
+                      "pt-BR/observability/portkey",
+                      "pt-BR/observability/weave",
+                      "pt-BR/observability/truefoundry"
+                    ]
+                  },
+                  {
+                    "group": "Aprenda",
+                    "pages": [
+                      "pt-BR/learn/overview",
+                      "pt-BR/learn/llm-selection-guide",
+                      "pt-BR/learn/conditional-tasks",
+                      "pt-BR/learn/coding-agents",
+                      "pt-BR/learn/create-custom-tools",
+                      "pt-BR/learn/custom-llm",
+                      "pt-BR/learn/custom-manager-agent",
+                      "pt-BR/learn/customizing-agents",
+                      "pt-BR/learn/dalle-image-generation",
+                      "pt-BR/learn/force-tool-output-as-result",
+                      "pt-BR/learn/hierarchical-process",
+                      "pt-BR/learn/human-input-on-execution",
+                      "pt-BR/learn/human-in-the-loop",
+                      "pt-BR/learn/human-feedback-in-flows",
+                      "pt-BR/learn/kickoff-async",
+                      "pt-BR/learn/kickoff-for-each",
+                      "pt-BR/learn/llm-connections",
+                      "pt-BR/learn/multimodal-agents",
+                      "pt-BR/learn/replay-tasks-from-latest-crew-kickoff",
+                      "pt-BR/learn/sequential-process",
+                      "pt-BR/learn/using-annotations",
+                      "pt-BR/learn/execution-hooks",
+                      "pt-BR/learn/llm-hooks",
+                      "pt-BR/learn/tool-hooks"
+                    ]
+                  },
+                  {
+                    "group": "Telemetria",
+                    "pages": [
+                      "pt-BR/telemetry"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "AMP",
+                "icon": "briefcase",
+                "groups": [
+                  {
+                    "group": "Começando",
+                    "pages": [
+                      "pt-BR/enterprise/introduction"
+                    ]
+                  },
+                  {
+                    "group": "Construir",
+                    "pages": [
+                      "pt-BR/enterprise/features/automations",
+                      "pt-BR/enterprise/features/crew-studio",
+                      "pt-BR/enterprise/features/marketplace",
+                      "pt-BR/enterprise/features/agent-repositories",
+                      "pt-BR/enterprise/features/tools-and-integrations",
+                      "pt-BR/enterprise/features/pii-trace-redactions"
+                    ]
+                  },
+                  {
+                    "group": "Operar",
+                    "pages": [
+                      "pt-BR/enterprise/features/traces",
+                      "pt-BR/enterprise/features/webhook-streaming",
+                      "pt-BR/enterprise/features/hallucination-guardrail",
+                      "pt-BR/enterprise/features/flow-hitl-management"
+                    ]
+                  },
+                  {
+                    "group": "Gerenciar",
+                    "pages": [
+                      "pt-BR/enterprise/features/rbac"
+                    ]
+                  },
+                  {
+                    "group": "Documentação de Integração",
+                    "pages": [
+                      "pt-BR/enterprise/integrations/asana",
+                      "pt-BR/enterprise/integrations/box",
+                      "pt-BR/enterprise/integrations/clickup",
+                      "pt-BR/enterprise/integrations/github",
+                      "pt-BR/enterprise/integrations/gmail",
+                      "pt-BR/enterprise/integrations/google_calendar",
+                      "pt-BR/enterprise/integrations/google_contacts",
+                      "pt-BR/enterprise/integrations/google_docs",
+                      "pt-BR/enterprise/integrations/google_drive",
+                      "pt-BR/enterprise/integrations/google_sheets",
+                      "pt-BR/enterprise/integrations/google_slides",
+                      "pt-BR/enterprise/integrations/hubspot",
+                      "pt-BR/enterprise/integrations/jira",
+                      "pt-BR/enterprise/integrations/linear",
+                      "pt-BR/enterprise/integrations/microsoft_excel",
+                      "pt-BR/enterprise/integrations/microsoft_onedrive",
+                      "pt-BR/enterprise/integrations/microsoft_outlook",
+                      "pt-BR/enterprise/integrations/microsoft_sharepoint",
+                      "pt-BR/enterprise/integrations/microsoft_teams",
+                      "pt-BR/enterprise/integrations/microsoft_word",
+                      "pt-BR/enterprise/integrations/notion",
+                      "pt-BR/enterprise/integrations/salesforce",
+                      "pt-BR/enterprise/integrations/shopify",
+                      "pt-BR/enterprise/integrations/slack",
+                      "pt-BR/enterprise/integrations/stripe",
+                      "pt-BR/enterprise/integrations/zendesk"
+                    ]
+                  },
+                  {
+                    "group": "Guias",
+                    "pages": [
+                      "pt-BR/enterprise/guides/build-crew",
+                      "pt-BR/enterprise/guides/prepare-for-deployment",
+                      "pt-BR/enterprise/guides/deploy-to-amp",
+                      "pt-BR/enterprise/guides/private-package-registry",
+                      "pt-BR/enterprise/guides/kickoff-crew",
+                      "pt-BR/enterprise/guides/training-crews",
+                      "pt-BR/enterprise/guides/update-crew",
+                      "pt-BR/enterprise/guides/enable-crew-studio",
+                      "pt-BR/enterprise/guides/capture_telemetry_logs",
+                      "pt-BR/enterprise/guides/azure-openai-setup",
+                      "pt-BR/enterprise/guides/tool-repository",
+                      "pt-BR/enterprise/guides/custom-mcp-server",
+                      "pt-BR/enterprise/guides/react-component-export",
+                      "pt-BR/enterprise/guides/team-management",
+                      "pt-BR/enterprise/guides/human-in-the-loop",
+                      "pt-BR/enterprise/guides/webhook-automation"
+                    ]
+                  },
+                  {
+                    "group": "Triggers",
+                    "pages": [
+                      "pt-BR/enterprise/guides/automation-triggers",
+                      "pt-BR/enterprise/guides/gmail-trigger",
+                      "pt-BR/enterprise/guides/google-calendar-trigger",
+                      "pt-BR/enterprise/guides/google-drive-trigger",
+                      "pt-BR/enterprise/guides/outlook-trigger",
+                      "pt-BR/enterprise/guides/onedrive-trigger",
+                      "pt-BR/enterprise/guides/microsoft-teams-trigger",
+                      "pt-BR/enterprise/guides/slack-trigger",
+                      "pt-BR/enterprise/guides/hubspot-trigger",
+                      "pt-BR/enterprise/guides/salesforce-trigger",
+                      "pt-BR/enterprise/guides/zapier-trigger"
+                    ]
+                  },
+                  {
+                    "group": "Recursos",
+                    "pages": [
+                      "pt-BR/enterprise/resources/frequently-asked-questions"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "Referência da API",
+                "icon": "magnifying-glass",
+                "groups": [
+                  {
+                    "group": "Começando",
+                    "pages": [
+                      "pt-BR/api-reference/introduction",
+                      "pt-BR/api-reference/inputs",
+                      "pt-BR/api-reference/kickoff",
+                      "pt-BR/api-reference/resume",
+                      "pt-BR/api-reference/status"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "Exemplos",
+                "icon": "code",
+                "groups": [
+                  {
+                    "group": "Exemplos",
+                    "pages": [
+                      "pt-BR/examples/example",
+                      "pt-BR/examples/cookbooks"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "Notas de Versão",
+                "icon": "clock",
+                "groups": [
+                  {
+                    "group": "Notas de Versão",
+                    "pages": [
+                      "pt-BR/changelog"
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
           {
             "version": "v1.13.0",
             "tabs": [
@@ -8481,7 +9412,7 @@
         },
         "versions": [
           {
-            "version": "v1.14.0",
+            "version": "v1.14.1",
             "default": true,
             "tabs": [
               {
@@ -8951,6 +9882,476 @@
               }
             ]
           },
+          {
+            "version": "v1.14.0",
+            "tabs": [
+              {
+                "tab": "홈",
+                "icon": "house",
+                "groups": [
+                  {
+                    "group": "환영합니다",
+                    "pages": [
+                      "ko/index"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "기술 문서",
+                "icon": "book-open",
+                "groups": [
+                  {
+                    "group": "시작 안내",
+                    "pages": [
+                      "ko/introduction",
+                      "ko/skills",
+                      "ko/installation",
+                      "ko/quickstart"
+                    ]
+                  },
+                  {
+                    "group": "가이드",
+                    "pages": [
+                      {
+                        "group": "전략",
+                        "icon": "compass",
+                        "pages": [
+                          "ko/guides/concepts/evaluating-use-cases"
+                        ]
+                      },
+                      {
+                        "group": "에이전트 (Agents)",
+                        "icon": "user",
+                        "pages": [
+                          "ko/guides/agents/crafting-effective-agents"
+                        ]
+                      },
+                      {
+                        "group": "크루 (Crews)",
+                        "icon": "users",
+                        "pages": [
+                          "ko/guides/crews/first-crew"
+                        ]
+                      },
+                      {
+                        "group": "플로우 (Flows)",
+                        "icon": "code-branch",
+                        "pages": [
+                          "ko/guides/flows/first-flow",
+                          "ko/guides/flows/mastering-flow-state"
+                        ]
+                      },
+                      {
+                        "group": "도구",
+                        "icon": "wrench",
+                        "pages": [
+                          "ko/guides/tools/publish-custom-tools"
+                        ]
+                      },
+                      {
+                        "group": "코딩 도구",
+                        "icon": "terminal",
+                        "pages": [
+                          "ko/guides/coding-tools/agents-md"
+                        ]
+                      },
+                      {
+                        "group": "고급",
+                        "icon": "gear",
+                        "pages": [
+                          "ko/guides/advanced/customizing-prompts",
+                          "ko/guides/advanced/fingerprinting"
+                        ]
+                      },
+                      {
+                        "group": "마이그레이션",
+                        "icon": "shuffle",
+                        "pages": [
+                          "ko/guides/migration/migrating-from-langgraph"
+                        ]
+                      }
+                    ]
+                  },
+                  {
+                    "group": "핵심 개념",
+                    "pages": [
+                      "ko/concepts/agents",
+                      "ko/concepts/tasks",
+                      "ko/concepts/agent-capabilities",
+                      "ko/concepts/crews",
+                      "ko/concepts/flows",
+                      "ko/concepts/production-architecture",
+                      "ko/concepts/knowledge",
+                      "ko/concepts/skills",
+                      "ko/concepts/llms",
+                      "ko/concepts/files",
+                      "ko/concepts/processes",
+                      "ko/concepts/collaboration",
+                      "ko/concepts/training",
+                      "ko/concepts/memory",
+                      "ko/concepts/reasoning",
+                      "ko/concepts/planning",
+                      "ko/concepts/testing",
+                      "ko/concepts/cli",
+                      "ko/concepts/tools",
+                      "ko/concepts/event-listener",
+                      "ko/concepts/checkpointing"
+                    ]
+                  },
+                  {
+                    "group": "MCP 통합",
+                    "pages": [
+                      "ko/mcp/overview",
+                      "ko/mcp/dsl-integration",
+                      "ko/mcp/stdio",
+                      "ko/mcp/sse",
+                      "ko/mcp/streamable-http",
+                      "ko/mcp/multiple-servers",
+                      "ko/mcp/security"
+                    ]
+                  },
+                  {
+                    "group": "도구 (Tools)",
+                    "pages": [
+                      "ko/tools/overview",
+                      {
+                        "group": "파일 & 문서",
+                        "icon": "folder-open",
+                        "pages": [
+                          "ko/tools/file-document/overview",
+                          "ko/tools/file-document/filereadtool",
+                          "ko/tools/file-document/filewritetool",
+                          "ko/tools/file-document/pdfsearchtool",
+                          "ko/tools/file-document/docxsearchtool",
+                          "ko/tools/file-document/mdxsearchtool",
+                          "ko/tools/file-document/xmlsearchtool",
+                          "ko/tools/file-document/txtsearchtool",
+                          "ko/tools/file-document/jsonsearchtool",
+                          "ko/tools/file-document/csvsearchtool",
+                          "ko/tools/file-document/directorysearchtool",
+                          "ko/tools/file-document/directoryreadtool",
+                          "ko/tools/file-document/ocrtool",
+                          "ko/tools/file-document/pdf-text-writing-tool"
+                        ]
+                      },
+                      {
+                        "group": "웹 스크래핑 & 브라우징",
+                        "icon": "globe",
+                        "pages": [
+                          "ko/tools/web-scraping/overview",
+                          "ko/tools/web-scraping/scrapewebsitetool",
+                          "ko/tools/web-scraping/scrapeelementfromwebsitetool",
+                          "ko/tools/web-scraping/scrapflyscrapetool",
+                          "ko/tools/web-scraping/seleniumscrapingtool",
+                          "ko/tools/web-scraping/scrapegraphscrapetool",
+                          "ko/tools/web-scraping/spidertool",
+                          "ko/tools/web-scraping/browserbaseloadtool",
+                          "ko/tools/web-scraping/hyperbrowserloadtool",
+                          "ko/tools/web-scraping/stagehandtool",
+                          "ko/tools/web-scraping/firecrawlcrawlwebsitetool",
+                          "ko/tools/web-scraping/firecrawlscrapewebsitetool",
+                          "ko/tools/web-scraping/oxylabsscraperstool",
+                          "ko/tools/web-scraping/brightdata-tools"
+                        ]
+                      },
+                      {
+                        "group": "검색 및 연구",
+                        "icon": "magnifying-glass",
+                        "pages": [
+                          "ko/tools/search-research/overview",
+                          "ko/tools/search-research/serperdevtool",
+                          "ko/tools/search-research/bravesearchtool",
+                          "ko/tools/search-research/exasearchtool",
+                          "ko/tools/search-research/linkupsearchtool",
+                          "ko/tools/search-research/githubsearchtool",
+                          "ko/tools/search-research/websitesearchtool",
+                          "ko/tools/search-research/codedocssearchtool",
+                          "ko/tools/search-research/youtubechannelsearchtool",
+                          "ko/tools/search-research/youtubevideosearchtool",
+                          "ko/tools/search-research/tavilysearchtool",
+                          "ko/tools/search-research/tavilyextractortool",
+                          "ko/tools/search-research/arxivpapertool",
+                          "ko/tools/search-research/serpapi-googlesearchtool",
+                          "ko/tools/search-research/serpapi-googleshoppingtool",
+                          "ko/tools/search-research/databricks-query-tool"
+                        ]
+                      },
+                      {
+                        "group": "데이터베이스 & 데이터",
+                        "icon": "database",
+                        "pages": [
+                          "ko/tools/database-data/overview",
+                          "ko/tools/database-data/mysqltool",
+                          "ko/tools/database-data/pgsearchtool",
+                          "ko/tools/database-data/snowflakesearchtool",
+                          "ko/tools/database-data/nl2sqltool",
+                          "ko/tools/database-data/qdrantvectorsearchtool",
+                          "ko/tools/database-data/weaviatevectorsearchtool",
+                          "ko/tools/database-data/mongodbvectorsearchtool",
+                          "ko/tools/database-data/singlestoresearchtool"
+                        ]
+                      },
+                      {
+                        "group": "인공지능 & 머신러닝",
+                        "icon": "brain",
+                        "pages": [
+                          "ko/tools/ai-ml/overview",
+                          "ko/tools/ai-ml/dalletool",
+                          "ko/tools/ai-ml/visiontool",
+                          "ko/tools/ai-ml/aimindtool",
+                          "ko/tools/ai-ml/llamaindextool",
+                          "ko/tools/ai-ml/langchaintool",
+                          "ko/tools/ai-ml/ragtool",
+                          "ko/tools/ai-ml/codeinterpretertool"
+                        ]
+                      },
+                      {
+                        "group": "클라우드 & 스토리지",
+                        "icon": "cloud",
+                        "pages": [
+                          "ko/tools/cloud-storage/overview",
+                          "ko/tools/cloud-storage/s3readertool",
+                          "ko/tools/cloud-storage/s3writertool",
+                          "ko/tools/cloud-storage/bedrockkbretriever"
+                        ]
+                      },
+                      {
+                        "group": "Integrations",
+                        "icon": "plug",
+                        "pages": [
+                          "ko/tools/integration/overview",
+                          "ko/tools/integration/bedrockinvokeagenttool",
+                          "ko/tools/integration/crewaiautomationtool"
+                        ]
+                      },
+                      {
+                        "group": "자동화",
+                        "icon": "bolt",
+                        "pages": [
+                          "ko/tools/automation/overview",
+                          "ko/tools/automation/apifyactorstool",
+                          "ko/tools/automation/composiotool",
+                          "ko/tools/automation/multiontool",
+                          "ko/tools/automation/zapieractionstool"
+                        ]
+                      }
+                    ]
+                  },
+                  {
+                    "group": "Observability",
+                    "pages": [
+                      "ko/observability/tracing",
+                      "ko/observability/overview",
+                      "ko/observability/arize-phoenix",
+                      "ko/observability/braintrust",
+                      "ko/observability/datadog",
+                      "ko/observability/galileo",
+                      "ko/observability/langdb",
+                      "ko/observability/langfuse",
+                      "ko/observability/langtrace",
+                      "ko/observability/maxim",
+                      "ko/observability/mlflow",
+                      "ko/observability/neatlogs",
+                      "ko/observability/openlit",
+                      "ko/observability/opik",
+                      "ko/observability/patronus-evaluation",
+                      "ko/observability/portkey",
+                      "ko/observability/weave"
+                    ]
+                  },
+                  {
+                    "group": "학습",
+                    "pages": [
+                      "ko/learn/overview",
+                      "ko/learn/llm-selection-guide",
+                      "ko/learn/conditional-tasks",
+                      "ko/learn/coding-agents",
+                      "ko/learn/create-custom-tools",
+                      "ko/learn/custom-llm",
+                      "ko/learn/custom-manager-agent",
+                      "ko/learn/customizing-agents",
+                      "ko/learn/dalle-image-generation",
+                      "ko/learn/force-tool-output-as-result",
+                      "ko/learn/hierarchical-process",
+                      "ko/learn/human-input-on-execution",
+                      "ko/learn/human-in-the-loop",
+                      "ko/learn/human-feedback-in-flows",
+                      "ko/learn/kickoff-async",
+                      "ko/learn/kickoff-for-each",
+                      "ko/learn/llm-connections",
+                      "ko/learn/multimodal-agents",
+                      "ko/learn/replay-tasks-from-latest-crew-kickoff",
+                      "ko/learn/sequential-process",
+                      "ko/learn/using-annotations",
+                      "ko/learn/execution-hooks",
+                      "ko/learn/llm-hooks",
+                      "ko/learn/tool-hooks"
+                    ]
+                  },
+                  {
+                    "group": "Telemetry",
+                    "pages": [
+                      "ko/telemetry"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "엔터프라이즈",
+                "icon": "briefcase",
+                "groups": [
+                  {
+                    "group": "시작 안내",
+                    "pages": [
+                      "ko/enterprise/introduction"
+                    ]
+                  },
+                  {
+                    "group": "빌드",
+                    "pages": [
+                      "ko/enterprise/features/automations",
+                      "ko/enterprise/features/crew-studio",
+                      "ko/enterprise/features/marketplace",
+                      "ko/enterprise/features/agent-repositories",
+                      "ko/enterprise/features/tools-and-integrations",
+                      "ko/enterprise/features/pii-trace-redactions"
+                    ]
+                  },
+                  {
+                    "group": "운영",
+                    "pages": [
+                      "ko/enterprise/features/traces",
+                      "ko/enterprise/features/webhook-streaming",
+                      "ko/enterprise/features/hallucination-guardrail",
+                      "ko/enterprise/features/flow-hitl-management"
+                    ]
+                  },
+                  {
+                    "group": "관리",
+                    "pages": [
+                      "ko/enterprise/features/rbac"
+                    ]
+                  },
+                  {
+                    "group": "통합 문서",
+                    "pages": [
+                      "ko/enterprise/integrations/asana",
+                      "ko/enterprise/integrations/box",
+                      "ko/enterprise/integrations/clickup",
+                      "ko/enterprise/integrations/github",
+                      "ko/enterprise/integrations/gmail",
+                      "ko/enterprise/integrations/google_calendar",
+                      "ko/enterprise/integrations/google_contacts",
+                      "ko/enterprise/integrations/google_docs",
+                      "ko/enterprise/integrations/google_drive",
+                      "ko/enterprise/integrations/google_sheets",
+                      "ko/enterprise/integrations/google_slides",
+                      "ko/enterprise/integrations/hubspot",
+                      "ko/enterprise/integrations/jira",
+                      "ko/enterprise/integrations/linear",
+                      "ko/enterprise/integrations/microsoft_excel",
+                      "ko/enterprise/integrations/microsoft_onedrive",
+                      "ko/enterprise/integrations/microsoft_outlook",
+                      "ko/enterprise/integrations/microsoft_sharepoint",
+                      "ko/enterprise/integrations/microsoft_teams",
+                      "ko/enterprise/integrations/microsoft_word",
+                      "ko/enterprise/integrations/notion",
+                      "ko/enterprise/integrations/salesforce",
+                      "ko/enterprise/integrations/shopify",
+                      "ko/enterprise/integrations/slack",
+                      "ko/enterprise/integrations/stripe",
+                      "ko/enterprise/integrations/zendesk"
+                    ]
+                  },
+                  {
+                    "group": "How-To Guides",
+                    "pages": [
+                      "ko/enterprise/guides/build-crew",
+                      "ko/enterprise/guides/prepare-for-deployment",
+                      "ko/enterprise/guides/deploy-to-amp",
+                      "ko/enterprise/guides/private-package-registry",
+                      "ko/enterprise/guides/kickoff-crew",
+                      "ko/enterprise/guides/training-crews",
+                      "ko/enterprise/guides/update-crew",
+                      "ko/enterprise/guides/enable-crew-studio",
+                      "ko/enterprise/guides/capture_telemetry_logs",
+                      "ko/enterprise/guides/azure-openai-setup",
+                      "ko/enterprise/guides/tool-repository",
+                      "ko/enterprise/guides/custom-mcp-server",
+                      "ko/enterprise/guides/react-component-export",
+                      "ko/enterprise/guides/team-management",
+                      "ko/enterprise/guides/human-in-the-loop",
+                      "ko/enterprise/guides/webhook-automation"
+                    ]
+                  },
+                  {
+                    "group": "트리거",
+                    "pages": [
+                      "ko/enterprise/guides/automation-triggers",
+                      "ko/enterprise/guides/gmail-trigger",
+                      "ko/enterprise/guides/google-calendar-trigger",
+                      "ko/enterprise/guides/google-drive-trigger",
+                      "ko/enterprise/guides/outlook-trigger",
+                      "ko/enterprise/guides/onedrive-trigger",
+                      "ko/enterprise/guides/microsoft-teams-trigger",
+                      "ko/enterprise/guides/slack-trigger",
+                      "ko/enterprise/guides/hubspot-trigger",
+                      "ko/enterprise/guides/salesforce-trigger",
+                      "ko/enterprise/guides/zapier-trigger"
+                    ]
+                  },
+                  {
+                    "group": "학습 자원",
+                    "pages": [
+                      "ko/enterprise/resources/frequently-asked-questions"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "API 레퍼런스",
+                "icon": "magnifying-glass",
+                "groups": [
+                  {
+                    "group": "시작 안내",
+                    "pages": [
+                      "ko/api-reference/introduction",
+                      "ko/api-reference/inputs",
+                      "ko/api-reference/kickoff",
+                      "ko/api-reference/resume",
+                      "ko/api-reference/status"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "예시",
+                "icon": "code",
+                "groups": [
+                  {
+                    "group": "예시",
+                    "pages": [
+                      "ko/examples/example",
+                      "ko/examples/cookbooks"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "변경 로그",
+                "icon": "clock",
+                "groups": [
+                  {
+                    "group": "릴리스 노트",
+                    "pages": [
+                      "ko/changelog"
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
           {
             "version": "v1.13.0",
             "tabs": [
@@ -12733,7 +14134,7 @@
         },
         "versions": [
           {
-            "version": "v1.14.0",
+            "version": "v1.14.1",
             "default": true,
             "tabs": [
               {
@@ -13203,6 +14604,476 @@
               }
             ]
           },
+          {
+            "version": "v1.14.0",
+            "tabs": [
+              {
+                "tab": "الرئيسية",
+                "icon": "house",
+                "groups": [
+                  {
+                    "group": "مرحباً",
+                    "pages": [
+                      "ar/index"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "التقنية التوثيق",
+                "icon": "book-open",
+                "groups": [
+                  {
+                    "group": "البدء",
+                    "pages": [
+                      "ar/introduction",
+                      "ar/skills",
+                      "ar/installation",
+                      "ar/quickstart"
+                    ]
+                  },
+                  {
+                    "group": "الأدلّة",
+                    "pages": [
+                      {
+                        "group": "الاستراتيجية",
+                        "icon": "compass",
+                        "pages": [
+                          "ar/guides/concepts/evaluating-use-cases"
+                        ]
+                      },
+                      {
+                        "group": "الوكلاء",
+                        "icon": "user",
+                        "pages": [
+                          "ar/guides/agents/crafting-effective-agents"
+                        ]
+                      },
+                      {
+                        "group": "الطواقم",
+                        "icon": "users",
+                        "pages": [
+                          "ar/guides/crews/first-crew"
+                        ]
+                      },
+                      {
+                        "group": "التدفقات",
+                        "icon": "code-branch",
+                        "pages": [
+                          "ar/guides/flows/first-flow",
+                          "ar/guides/flows/mastering-flow-state"
+                        ]
+                      },
+                      {
+                        "group": "الأدوات",
+                        "icon": "wrench",
+                        "pages": [
+                          "ar/guides/tools/publish-custom-tools"
+                        ]
+                      },
+                      {
+                        "group": "أدوات البرمجة",
+                        "icon": "terminal",
+                        "pages": [
+                          "ar/guides/coding-tools/agents-md"
+                        ]
+                      },
+                      {
+                        "group": "متقدّم",
+                        "icon": "gear",
+                        "pages": [
+                          "ar/guides/advanced/customizing-prompts",
+                          "ar/guides/advanced/fingerprinting"
+                        ]
+                      },
+                      {
+                        "group": "الترحيل",
+                        "icon": "shuffle",
+                        "pages": [
+                          "ar/guides/migration/migrating-from-langgraph"
+                        ]
+                      }
+                    ]
+                  },
+                  {
+                    "group": "المفاهيم الأساسية",
+                    "pages": [
+                      "ar/concepts/agents",
+                      "ar/concepts/agent-capabilities",
+                      "ar/concepts/tasks",
+                      "ar/concepts/crews",
+                      "ar/concepts/flows",
+                      "ar/concepts/production-architecture",
+                      "ar/concepts/knowledge",
+                      "ar/concepts/skills",
+                      "ar/concepts/llms",
+                      "ar/concepts/files",
+                      "ar/concepts/processes",
+                      "ar/concepts/collaboration",
+                      "ar/concepts/training",
+                      "ar/concepts/memory",
+                      "ar/concepts/reasoning",
+                      "ar/concepts/planning",
+                      "ar/concepts/testing",
+                      "ar/concepts/cli",
+                      "ar/concepts/tools",
+                      "ar/concepts/event-listener",
+                      "ar/concepts/checkpointing"
+                    ]
+                  },
+                  {
+                    "group": "تكامل MCP",
+                    "pages": [
+                      "ar/mcp/overview",
+                      "ar/mcp/dsl-integration",
+                      "ar/mcp/stdio",
+                      "ar/mcp/sse",
+                      "ar/mcp/streamable-http",
+                      "ar/mcp/multiple-servers",
+                      "ar/mcp/security"
+                    ]
+                  },
+                  {
+                    "group": "الأدوات",
+                    "pages": [
+                      "ar/tools/overview",
+                      {
+                        "group": "الملفات والمستندات",
+                        "icon": "folder-open",
+                        "pages": [
+                          "ar/tools/file-document/overview",
+                          "ar/tools/file-document/filereadtool",
+                          "ar/tools/file-document/filewritetool",
+                          "ar/tools/file-document/pdfsearchtool",
+                          "ar/tools/file-document/docxsearchtool",
+                          "ar/tools/file-document/mdxsearchtool",
+                          "ar/tools/file-document/xmlsearchtool",
+                          "ar/tools/file-document/txtsearchtool",
+                          "ar/tools/file-document/jsonsearchtool",
+                          "ar/tools/file-document/csvsearchtool",
+                          "ar/tools/file-document/directorysearchtool",
+                          "ar/tools/file-document/directoryreadtool",
+                          "ar/tools/file-document/ocrtool",
+                          "ar/tools/file-document/pdf-text-writing-tool"
+                        ]
+                      },
+                      {
+                        "group": "استخراج بيانات الويب",
+                        "icon": "globe",
+                        "pages": [
+                          "ar/tools/web-scraping/overview",
+                          "ar/tools/web-scraping/scrapewebsitetool",
+                          "ar/tools/web-scraping/scrapeelementfromwebsitetool",
+                          "ar/tools/web-scraping/scrapflyscrapetool",
+                          "ar/tools/web-scraping/seleniumscrapingtool",
+                          "ar/tools/web-scraping/scrapegraphscrapetool",
+                          "ar/tools/web-scraping/spidertool",
+                          "ar/tools/web-scraping/browserbaseloadtool",
+                          "ar/tools/web-scraping/hyperbrowserloadtool",
+                          "ar/tools/web-scraping/stagehandtool",
+                          "ar/tools/web-scraping/firecrawlcrawlwebsitetool",
+                          "ar/tools/web-scraping/firecrawlscrapewebsitetool",
+                          "ar/tools/web-scraping/oxylabsscraperstool",
+                          "ar/tools/web-scraping/brightdata-tools"
+                        ]
+                      },
+                      {
+                        "group": "البحث والاستكشاف",
+                        "icon": "magnifying-glass",
+                        "pages": [
+                          "ar/tools/search-research/overview",
+                          "ar/tools/search-research/serperdevtool",
+                          "ar/tools/search-research/bravesearchtool",
+                          "ar/tools/search-research/exasearchtool",
+                          "ar/tools/search-research/linkupsearchtool",
+                          "ar/tools/search-research/githubsearchtool",
+                          "ar/tools/search-research/websitesearchtool",
+                          "ar/tools/search-research/codedocssearchtool",
+                          "ar/tools/search-research/youtubechannelsearchtool",
+                          "ar/tools/search-research/youtubevideosearchtool",
+                          "ar/tools/search-research/tavilysearchtool",
+                          "ar/tools/search-research/tavilyextractortool",
+                          "ar/tools/search-research/arxivpapertool",
+                          "ar/tools/search-research/serpapi-googlesearchtool",
+                          "ar/tools/search-research/serpapi-googleshoppingtool",
+                          "ar/tools/search-research/databricks-query-tool"
+                        ]
+                      },
+                      {
+                        "group": "قواعد البيانات",
+                        "icon": "database",
+                        "pages": [
+                          "ar/tools/database-data/overview",
+                          "ar/tools/database-data/mysqltool",
+                          "ar/tools/database-data/pgsearchtool",
+                          "ar/tools/database-data/snowflakesearchtool",
+                          "ar/tools/database-data/nl2sqltool",
+                          "ar/tools/database-data/qdrantvectorsearchtool",
+                          "ar/tools/database-data/weaviatevectorsearchtool",
+                          "ar/tools/database-data/mongodbvectorsearchtool",
+                          "ar/tools/database-data/singlestoresearchtool"
+                        ]
+                      },
+                      {
+                        "group": "الذكاء الاصطناعي والتعلّم الآلي",
+                        "icon": "brain",
+                        "pages": [
+                          "ar/tools/ai-ml/overview",
+                          "ar/tools/ai-ml/dalletool",
+                          "ar/tools/ai-ml/visiontool",
+                          "ar/tools/ai-ml/aimindtool",
+                          "ar/tools/ai-ml/llamaindextool",
+                          "ar/tools/ai-ml/langchaintool",
+                          "ar/tools/ai-ml/ragtool",
+                          "ar/tools/ai-ml/codeinterpretertool"
+                        ]
+                      },
+                      {
+                        "group": "التخزين السحابي",
+                        "icon": "cloud",
+                        "pages": [
+                          "ar/tools/cloud-storage/overview",
+                          "ar/tools/cloud-storage/s3readertool",
+                          "ar/tools/cloud-storage/s3writertool",
+                          "ar/tools/cloud-storage/bedrockkbretriever"
+                        ]
+                      },
+                      {
+                        "group": "Integrations",
+                        "icon": "plug",
+                        "pages": [
+                          "ar/tools/integration/overview",
+                          "ar/tools/integration/bedrockinvokeagenttool",
+                          "ar/tools/integration/crewaiautomationtool"
+                        ]
+                      },
+                      {
+                        "group": "الأتمتة",
+                        "icon": "bolt",
+                        "pages": [
+                          "ar/tools/automation/overview",
+                          "ar/tools/automation/apifyactorstool",
+                          "ar/tools/automation/composiotool",
+                          "ar/tools/automation/multiontool",
+                          "ar/tools/automation/zapieractionstool"
+                        ]
+                      }
+                    ]
+                  },
+                  {
+                    "group": "Observability",
+                    "pages": [
+                      "ar/observability/tracing",
+                      "ar/observability/overview",
+                      "ar/observability/arize-phoenix",
+                      "ar/observability/braintrust",
+                      "ar/observability/datadog",
+                      "ar/observability/galileo",
+                      "ar/observability/langdb",
+                      "ar/observability/langfuse",
+                      "ar/observability/langtrace",
+                      "ar/observability/maxim",
+                      "ar/observability/mlflow",
+                      "ar/observability/neatlogs",
+                      "ar/observability/openlit",
+                      "ar/observability/opik",
+                      "ar/observability/patronus-evaluation",
+                      "ar/observability/portkey",
+                      "ar/observability/weave"
+                    ]
+                  },
+                  {
+                    "group": "التعلّم",
+                    "pages": [
+                      "ar/learn/overview",
+                      "ar/learn/llm-selection-guide",
+                      "ar/learn/conditional-tasks",
+                      "ar/learn/coding-agents",
+                      "ar/learn/create-custom-tools",
+                      "ar/learn/custom-llm",
+                      "ar/learn/custom-manager-agent",
+                      "ar/learn/customizing-agents",
+                      "ar/learn/dalle-image-generation",
+                      "ar/learn/force-tool-output-as-result",
+                      "ar/learn/hierarchical-process",
+                      "ar/learn/human-input-on-execution",
+                      "ar/learn/human-in-the-loop",
+                      "ar/learn/human-feedback-in-flows",
+                      "ar/learn/kickoff-async",
+                      "ar/learn/kickoff-for-each",
+                      "ar/learn/llm-connections",
+                      "ar/learn/multimodal-agents",
+                      "ar/learn/replay-tasks-from-latest-crew-kickoff",
+                      "ar/learn/sequential-process",
+                      "ar/learn/using-annotations",
+                      "ar/learn/execution-hooks",
+                      "ar/learn/llm-hooks",
+                      "ar/learn/tool-hooks"
+                    ]
+                  },
+                  {
+                    "group": "Telemetry",
+                    "pages": [
+                      "ar/telemetry"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "المؤسسات",
+                "icon": "briefcase",
+                "groups": [
+                  {
+                    "group": "البدء",
+                    "pages": [
+                      "ar/enterprise/introduction"
+                    ]
+                  },
+                  {
+                    "group": "البناء",
+                    "pages": [
+                      "ar/enterprise/features/automations",
+                      "ar/enterprise/features/crew-studio",
+                      "ar/enterprise/features/marketplace",
+                      "ar/enterprise/features/agent-repositories",
+                      "ar/enterprise/features/tools-and-integrations",
+                      "ar/enterprise/features/pii-trace-redactions"
+                    ]
+                  },
+                  {
+                    "group": "العمليات",
+                    "pages": [
+                      "ar/enterprise/features/traces",
+                      "ar/enterprise/features/webhook-streaming",
+                      "ar/enterprise/features/hallucination-guardrail",
+                      "ar/enterprise/features/flow-hitl-management"
+                    ]
+                  },
+                  {
+                    "group": "الإدارة",
+                    "pages": [
+                      "ar/enterprise/features/rbac"
+                    ]
+                  },
+                  {
+                    "group": "التكاملات",
+                    "pages": [
+                      "ar/enterprise/integrations/asana",
+                      "ar/enterprise/integrations/box",
+                      "ar/enterprise/integrations/clickup",
+                      "ar/enterprise/integrations/github",
+                      "ar/enterprise/integrations/gmail",
+                      "ar/enterprise/integrations/google_calendar",
+                      "ar/enterprise/integrations/google_contacts",
+                      "ar/enterprise/integrations/google_docs",
+                      "ar/enterprise/integrations/google_drive",
+                      "ar/enterprise/integrations/google_sheets",
+                      "ar/enterprise/integrations/google_slides",
+                      "ar/enterprise/integrations/hubspot",
+                      "ar/enterprise/integrations/jira",
+                      "ar/enterprise/integrations/linear",
+                      "ar/enterprise/integrations/microsoft_excel",
+                      "ar/enterprise/integrations/microsoft_onedrive",
+                      "ar/enterprise/integrations/microsoft_outlook",
+                      "ar/enterprise/integrations/microsoft_sharepoint",
+                      "ar/enterprise/integrations/microsoft_teams",
+                      "ar/enterprise/integrations/microsoft_word",
+                      "ar/enterprise/integrations/notion",
+                      "ar/enterprise/integrations/salesforce",
+                      "ar/enterprise/integrations/shopify",
+                      "ar/enterprise/integrations/slack",
+                      "ar/enterprise/integrations/stripe",
+                      "ar/enterprise/integrations/zendesk"
+                    ]
+                  },
+                  {
+                    "group": "How-To Guides",
+                    "pages": [
+                      "ar/enterprise/guides/build-crew",
+                      "ar/enterprise/guides/prepare-for-deployment",
+                      "ar/enterprise/guides/deploy-to-amp",
+                      "ar/enterprise/guides/private-package-registry",
+                      "ar/enterprise/guides/kickoff-crew",
+                      "ar/enterprise/guides/training-crews",
+                      "ar/enterprise/guides/update-crew",
+                      "ar/enterprise/guides/enable-crew-studio",
+                      "ar/enterprise/guides/capture_telemetry_logs",
+                      "ar/enterprise/guides/azure-openai-setup",
+                      "ar/enterprise/guides/tool-repository",
+                      "ar/enterprise/guides/custom-mcp-server",
+                      "ar/enterprise/guides/react-component-export",
+                      "ar/enterprise/guides/team-management",
+                      "ar/enterprise/guides/human-in-the-loop",
+                      "ar/enterprise/guides/webhook-automation"
+                    ]
+                  },
+                  {
+                    "group": "المشغّلات",
+                    "pages": [
+                      "ar/enterprise/guides/automation-triggers",
+                      "ar/enterprise/guides/gmail-trigger",
+                      "ar/enterprise/guides/google-calendar-trigger",
+                      "ar/enterprise/guides/google-drive-trigger",
+                      "ar/enterprise/guides/outlook-trigger",
+                      "ar/enterprise/guides/onedrive-trigger",
+                      "ar/enterprise/guides/microsoft-teams-trigger",
+                      "ar/enterprise/guides/slack-trigger",
+                      "ar/enterprise/guides/hubspot-trigger",
+                      "ar/enterprise/guides/salesforce-trigger",
+                      "ar/enterprise/guides/zapier-trigger"
+                    ]
+                  },
+                  {
+                    "group": "موارد التعلّم",
+                    "pages": [
+                      "ar/enterprise/resources/frequently-asked-questions"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "API المرجع",
+                "icon": "magnifying-glass",
+                "groups": [
+                  {
+                    "group": "البدء",
+                    "pages": [
+                      "ar/api-reference/introduction",
+                      "ar/api-reference/inputs",
+                      "ar/api-reference/kickoff",
+                      "ar/api-reference/resume",
+                      "ar/api-reference/status"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "أمثلة",
+                "icon": "code",
+                "groups": [
+                  {
+                    "group": "أمثلة",
+                    "pages": [
+                      "ar/examples/example",
+                      "ar/examples/cookbooks"
+                    ]
+                  }
+                ]
+              },
+              {
+                "tab": "التغييرات السجلات",
+                "icon": "clock",
+                "groups": [
+                  {
+                    "group": "سجل التغييرات",
+                    "pages": [
+                      "ar/changelog"
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
           {
             "version": "v1.13.0",
             "tabs": [
diff --git a/docs/en/changelog.mdx b/docs/en/changelog.mdx
index 62945af05..13c737e4b 100644
--- a/docs/en/changelog.mdx
+++ b/docs/en/changelog.mdx
@@ -4,6 +4,39 @@ description: "Product updates, improvements, and bug fixes for CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="Apr 09, 2026">
+  ## v1.14.1
+
+  [View release on GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.1)
+
+  ## What's Changed
+
+  ### Features
+  - Add async checkpoint TUI browser
+  - Add aclose()/close() and async context manager to streaming outputs
+
+  ### Bug Fixes
+  - Fix regex for template pyproject.toml version bumps
+  - Sanitize tool names in hook decorator filters
+  - Fix checkpoint handlers registration when CheckpointConfig is created
+  - Bump transformers to 5.5.0 to resolve CVE-2026-1839
+  - Remove FilteredStream stdout/stderr wrapper
+
+  ### Documentation
+  - Update changelog and version for v1.14.1rc1
+
+  ### Refactoring
+  - Replace hardcoded denylist with dynamic BaseTool field exclusion in spec gen
+  - Replace regex with tomlkit in devtools CLI
+  - Use shared PRINTER singleton
+  - Make BaseProvider a BaseModel with provider_type discriminator
+
+  ## Contributors
+
+  @greysonlalonde, @iris-clawd, @joaomdmoura, @lorenzejay
+
+</Update>
+
 <Update label="Apr 09, 2026">
   ## v1.14.1rc1
 
diff --git a/docs/ko/changelog.mdx b/docs/ko/changelog.mdx
index 5524cd317..1a25fbdf4 100644
--- a/docs/ko/changelog.mdx
+++ b/docs/ko/changelog.mdx
@@ -4,6 +4,39 @@ description: "CrewAI의 제품 업데이트, 개선 사항 및 버그 수정"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="2026년 4월 9일">
+  ## v1.14.1
+
+  [GitHub 릴리스 보기](https://github.com/crewAIInc/crewAI/releases/tag/1.14.1)
+
+  ## 변경 사항
+
+  ### 기능
+  - 비동기 체크포인트 TUI 브라우저 추가
+  - 스트리밍 출력에 aclose()/close() 및 비동기 컨텍스트 관리자 추가
+
+  ### 버그 수정
+  - 템플릿 pyproject.toml 버전 증가를 위한 정규 표현식 수정
+  - 훅 데코레이터 필터에서 도구 이름 정리
+  - CheckpointConfig 생성 시 체크포인트 핸들러 등록 수정
+  - CVE-2026-1839 해결을 위해 transformers를 5.5.0으로 업데이트
+  - FilteredStream stdout/stderr 래퍼 제거
+
+  ### 문서
+  - v1.14.1rc1에 대한 변경 로그 및 버전 업데이트
+
+  ### 리팩토링
+  - 하드코딩된 거부 목록을 동적 BaseTool 필드 제외로 교체
+  - devtools CLI에서 정규 표현식을 tomlkit으로 교체
+  - 공유 PRINTER 싱글톤 사용
+  - BaseProvider를 provider_type 식별자가 있는 BaseModel로 변경
+
+  ## 기여자
+
+  @greysonlalonde, @iris-clawd, @joaomdmoura, @lorenzejay
+
+</Update>
+
 <Update label="2026년 4월 9일">
   ## v1.14.1rc1
 
diff --git a/docs/pt-BR/changelog.mdx b/docs/pt-BR/changelog.mdx
index fd7e7c7cd..b7c5a23f0 100644
--- a/docs/pt-BR/changelog.mdx
+++ b/docs/pt-BR/changelog.mdx
@@ -4,6 +4,39 @@ description: "Atualizações de produto, melhorias e correções do CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="09 abr 2026">
+  ## v1.14.1
+
+  [Ver release no GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.1)
+
+  ## O que Mudou
+
+  ### Funcionalidades
+  - Adicionar navegador TUI de ponto de verificação assíncrono
+  - Adicionar aclose()/close() e gerenciador de contexto assíncrono para saídas de streaming
+
+  ### Correções de Bugs
+  - Corrigir regex para aumentos de versão do template pyproject.toml
+  - Sanitizar nomes de ferramentas nos filtros do decorador de hook
+  - Corrigir registro de manipuladores de ponto de verificação quando CheckpointConfig é criado
+  - Atualizar transformers para 5.5.0 para resolver CVE-2026-1839
+  - Remover wrapper stdout/stderr de FilteredStream
+
+  ### Documentação
+  - Atualizar changelog e versão para v1.14.1rc1
+
+  ### Refatoração
+  - Substituir lista de negação codificada por exclusão dinâmica de campo BaseTool na geração de especificações
+  - Substituir regex por tomlkit na CLI do devtools
+  - Usar singleton PRINTER compartilhado
+  - Fazer BaseProvider um BaseModel com discriminador provider_type
+
+  ## Contribuidores
+
+  @greysonlalonde, @iris-clawd, @joaomdmoura, @lorenzejay
+
+</Update>
+
 <Update label="09 abr 2026">
   ## v1.14.1rc1
 

From 0e590ff66915c5f52359f4db83ead85a2e84c007 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 9 Apr 2026 04:29:53 +0800
Subject: [PATCH 14/70] refactor: use shared I18N_DEFAULT singleton

---
 lib/crewai/src/crewai/agent/core.py           | 20 ++++-----
 lib/crewai/src/crewai/agent/utils.py          | 27 +++++++-----
 .../langgraph/langgraph_adapter.py            |  3 +-
 .../openai_agents/openai_adapter.py           |  3 +-
 .../structured_output_converter.py            |  8 ++--
 .../crewai/agents/agent_builder/base_agent.py |  6 +--
 .../agent_builder/base_agent_executor.py      |  2 -
 .../src/crewai/agents/crew_agent_executor.py  | 23 +++-------
 lib/crewai/src/crewai/agents/parser.py        |  5 +--
 .../src/crewai/agents/planner_observer.py     |  9 ++--
 lib/crewai/src/crewai/agents/step_executor.py | 25 +++++------
 .../src/crewai/experimental/agent_executor.py | 21 +++------
 lib/crewai/src/crewai/flow/flow.py            |  6 +--
 lib/crewai/src/crewai/flow/human_feedback.py  |  4 +-
 lib/crewai/src/crewai/lite_agent.py           | 20 ++++-----
 lib/crewai/src/crewai/memory/analyze.py       |  4 +-
 lib/crewai/src/crewai/task.py                 | 11 +++--
 lib/crewai/src/crewai/telemetry/telemetry.py  |  5 ++-
 .../tools/agent_tools/add_image_tool.py       | 11 ++---
 .../crewai/tools/agent_tools/agent_tools.py   | 12 ++---
 .../tools/agent_tools/base_agent_tools.py     | 14 +++---
 lib/crewai/src/crewai/tools/memory_tools.py   |  7 ++-
 lib/crewai/src/crewai/tools/tool_usage.py     | 27 ++++++------
 .../src/crewai/utilities/agent_utils.py       | 30 +++++--------
 lib/crewai/src/crewai/utilities/converter.py  |  4 +-
 .../utilities/evaluators/task_evaluator.py    | 18 +++-----
 lib/crewai/src/crewai/utilities/i18n.py       |  3 ++
 lib/crewai/src/crewai/utilities/prompts.py    |  9 ++--
 .../src/crewai/utilities/reasoning_handler.py | 17 +++----
 lib/crewai/src/crewai/utilities/tool_utils.py | 10 ++---
 lib/crewai/tests/agents/test_agent.py         | 10 ++---
 .../tests/agents/test_agent_executor.py       |  2 -
 lib/crewai/tests/tools/test_tool_usage.py     | 14 ------
 .../tests/utilities/test_agent_utils.py       | 44 ++++++-------------
 .../utilities/test_structured_planning.py     |  2 -
 .../utilities/test_summarize_integration.py   | 21 +++++----
 36 files changed, 179 insertions(+), 278 deletions(-)

diff --git a/lib/crewai/src/crewai/agent/core.py b/lib/crewai/src/crewai/agent/core.py
index c86d7112c..eb73ba719 100644
--- a/lib/crewai/src/crewai/agent/core.py
+++ b/lib/crewai/src/crewai/agent/core.py
@@ -98,6 +98,7 @@ from crewai.utilities.converter import Converter, ConverterError
 from crewai.utilities.env import get_env_context
 from crewai.utilities.guardrail import process_guardrail
 from crewai.utilities.guardrail_types import GuardrailCallable, GuardrailType
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.llm_utils import create_llm
 from crewai.utilities.prompts import Prompts, StandardPromptResult, SystemPromptResult
 from crewai.utilities.pydantic_schema_utils import generate_model_description
@@ -499,8 +500,8 @@ class Agent(BaseAgent):
             self.tools_handler.last_used_tool = None
 
         task_prompt = task.prompt()
-        task_prompt = build_task_prompt_with_schema(task, task_prompt, self.i18n)
-        task_prompt = format_task_with_context(task_prompt, context, self.i18n)
+        task_prompt = build_task_prompt_with_schema(task, task_prompt)
+        task_prompt = format_task_with_context(task_prompt, context)
         return self._retrieve_memory_context(task, task_prompt)
 
     def _finalize_task_prompt(
@@ -562,7 +563,7 @@ class Agent(BaseAgent):
                         m.format() for m in matches
                     )
             if memory.strip() != "":
-                task_prompt += self.i18n.slice("memory").format(memory=memory)
+                task_prompt += I18N_DEFAULT.slice("memory").format(memory=memory)
 
             crewai_event_bus.emit(
                 self,
@@ -968,14 +969,13 @@ class Agent(BaseAgent):
             agent=self,
             has_tools=len(raw_tools) > 0,
             use_native_tool_calling=use_native_tool_calling,
-            i18n=self.i18n,
             use_system_prompt=self.use_system_prompt,
             system_template=self.system_template,
             prompt_template=self.prompt_template,
             response_template=self.response_template,
         ).task_execution()
 
-        stop_words = [self.i18n.slice("observation")]
+        stop_words = [I18N_DEFAULT.slice("observation")]
         if self.response_template:
             stop_words.append(
                 self.response_template.split("{{ .Response }}")[1].strip()
@@ -1017,7 +1017,6 @@ class Agent(BaseAgent):
             self.agent_executor = self.executor_class(
                 llm=self.llm,
                 task=task,
-                i18n=self.i18n,
                 agent=self,
                 crew=self.crew,
                 tools=parsed_tools,
@@ -1262,10 +1261,10 @@ class Agent(BaseAgent):
                 from_agent=self,
             ),
         )
-        query = self.i18n.slice("knowledge_search_query").format(
+        query = I18N_DEFAULT.slice("knowledge_search_query").format(
             task_prompt=task_prompt
         )
-        rewriter_prompt = self.i18n.slice("knowledge_search_query_system_prompt")
+        rewriter_prompt = I18N_DEFAULT.slice("knowledge_search_query_system_prompt")
         if not isinstance(self.llm, BaseLLM):
             self._logger.log(
                 "warning",
@@ -1384,7 +1383,6 @@ class Agent(BaseAgent):
             request_within_rpm_limit=rpm_limit_fn,
             callbacks=[TokenCalcHandler(self._token_process)],
             response_model=response_format,
-            i18n=self.i18n,
         )
 
         all_files: dict[str, Any] = {}
@@ -1420,7 +1418,7 @@ class Agent(BaseAgent):
                         m.format() for m in matches
                     )
                 if memory_block:
-                    formatted_messages += "\n\n" + self.i18n.slice("memory").format(
+                    formatted_messages += "\n\n" + I18N_DEFAULT.slice("memory").format(
                         memory=memory_block
                     )
                 crewai_event_bus.emit(
@@ -1624,7 +1622,7 @@ class Agent(BaseAgent):
             try:
                 model_schema = generate_model_description(response_format)
                 schema = json.dumps(model_schema, indent=2)
-                instructions = self.i18n.slice("formatted_task_instructions").format(
+                instructions = I18N_DEFAULT.slice("formatted_task_instructions").format(
                     output_format=schema
                 )
 
diff --git a/lib/crewai/src/crewai/agent/utils.py b/lib/crewai/src/crewai/agent/utils.py
index 8690c8faf..31f08903f 100644
--- a/lib/crewai/src/crewai/agent/utils.py
+++ b/lib/crewai/src/crewai/agent/utils.py
@@ -24,7 +24,6 @@ if TYPE_CHECKING:
     from crewai.agent.core import Agent
     from crewai.task import Task
     from crewai.tools.base_tool import BaseTool
-    from crewai.utilities.i18n import I18N
 
 
 def handle_reasoning(agent: Agent, task: Task) -> None:
@@ -59,46 +58,50 @@ def handle_reasoning(agent: Agent, task: Task) -> None:
         agent._logger.log("error", f"Error during planning: {e!s}")
 
 
-def build_task_prompt_with_schema(task: Task, task_prompt: str, i18n: I18N) -> str:
+def build_task_prompt_with_schema(task: Task, task_prompt: str) -> str:
     """Build task prompt with JSON/Pydantic schema instructions if applicable.
 
     Args:
         task: The task being executed.
         task_prompt: The initial task prompt.
-        i18n: Internationalization instance.
 
     Returns:
         The task prompt potentially augmented with schema instructions.
     """
+    from crewai.utilities.i18n import I18N_DEFAULT
+
     if (task.output_json or task.output_pydantic) and not task.response_model:
         if task.output_json:
             schema_dict = generate_model_description(task.output_json)
             schema = json.dumps(schema_dict["json_schema"]["schema"], indent=2)
-            task_prompt += "\n" + i18n.slice("formatted_task_instructions").format(
-                output_format=schema
-            )
+            task_prompt += "\n" + I18N_DEFAULT.slice(
+                "formatted_task_instructions"
+            ).format(output_format=schema)
         elif task.output_pydantic:
             schema_dict = generate_model_description(task.output_pydantic)
             schema = json.dumps(schema_dict["json_schema"]["schema"], indent=2)
-            task_prompt += "\n" + i18n.slice("formatted_task_instructions").format(
-                output_format=schema
-            )
+            task_prompt += "\n" + I18N_DEFAULT.slice(
+                "formatted_task_instructions"
+            ).format(output_format=schema)
     return task_prompt
 
 
-def format_task_with_context(task_prompt: str, context: str | None, i18n: I18N) -> str:
+def format_task_with_context(task_prompt: str, context: str | None) -> str:
     """Format task prompt with context if provided.
 
     Args:
         task_prompt: The task prompt.
         context: Optional context string.
-        i18n: Internationalization instance.
 
     Returns:
         The task prompt formatted with context if provided.
     """
+    from crewai.utilities.i18n import I18N_DEFAULT
+
     if context:
-        return i18n.slice("task_with_context").format(task=task_prompt, context=context)
+        return I18N_DEFAULT.slice("task_with_context").format(
+            task=task_prompt, context=context
+        )
     return task_prompt
 
 
diff --git a/lib/crewai/src/crewai/agents/agent_adapters/langgraph/langgraph_adapter.py b/lib/crewai/src/crewai/agents/agent_adapters/langgraph/langgraph_adapter.py
index 1710b56cb..33a705728 100644
--- a/lib/crewai/src/crewai/agents/agent_adapters/langgraph/langgraph_adapter.py
+++ b/lib/crewai/src/crewai/agents/agent_adapters/langgraph/langgraph_adapter.py
@@ -33,6 +33,7 @@ from crewai.tools.base_tool import BaseTool
 from crewai.types.callback import SerializableCallable
 from crewai.utilities import Logger
 from crewai.utilities.converter import Converter
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.import_utils import require
 
 
@@ -186,7 +187,7 @@ class LangGraphAgentAdapter(BaseAgentAdapter):
             task_prompt = task.prompt() if hasattr(task, "prompt") else str(task)
 
             if context:
-                task_prompt = self.i18n.slice("task_with_context").format(
+                task_prompt = I18N_DEFAULT.slice("task_with_context").format(
                     task=task_prompt, context=context
                 )
 
diff --git a/lib/crewai/src/crewai/agents/agent_adapters/openai_agents/openai_adapter.py b/lib/crewai/src/crewai/agents/agent_adapters/openai_agents/openai_adapter.py
index 82eb8640b..169d65af5 100644
--- a/lib/crewai/src/crewai/agents/agent_adapters/openai_agents/openai_adapter.py
+++ b/lib/crewai/src/crewai/agents/agent_adapters/openai_agents/openai_adapter.py
@@ -32,6 +32,7 @@ from crewai.events.types.agent_events import (
 from crewai.tools import BaseTool
 from crewai.tools.agent_tools.agent_tools import AgentTools
 from crewai.utilities import Logger
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.import_utils import require
 
 
@@ -133,7 +134,7 @@ class OpenAIAgentAdapter(BaseAgentAdapter):
         try:
             task_prompt: str = task.prompt()
             if context:
-                task_prompt = self.i18n.slice("task_with_context").format(
+                task_prompt = I18N_DEFAULT.slice("task_with_context").format(
                     task=task_prompt, context=context
                 )
             crewai_event_bus.emit(
diff --git a/lib/crewai/src/crewai/agents/agent_adapters/openai_agents/structured_output_converter.py b/lib/crewai/src/crewai/agents/agent_adapters/openai_agents/structured_output_converter.py
index 4033c8d50..358281cac 100644
--- a/lib/crewai/src/crewai/agents/agent_adapters/openai_agents/structured_output_converter.py
+++ b/lib/crewai/src/crewai/agents/agent_adapters/openai_agents/structured_output_converter.py
@@ -8,7 +8,7 @@ import json
 from typing import Any
 
 from crewai.agents.agent_adapters.base_converter_adapter import BaseConverterAdapter
-from crewai.utilities.i18n import get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 
 
 class OpenAIConverterAdapter(BaseConverterAdapter):
@@ -59,10 +59,8 @@ class OpenAIConverterAdapter(BaseConverterAdapter):
         if not self._output_format:
             return base_prompt
 
-        output_schema: str = (
-            get_i18n()
-            .slice("formatted_task_instructions")
-            .format(output_format=json.dumps(self._schema, indent=2))
+        output_schema: str = I18N_DEFAULT.slice("formatted_task_instructions").format(
+            output_format=json.dumps(self._schema, indent=2)
         )
 
         return f"{base_prompt}\n\n{output_schema}"
diff --git a/lib/crewai/src/crewai/agents/agent_builder/base_agent.py b/lib/crewai/src/crewai/agents/agent_builder/base_agent.py
index de9379d09..c55f5e417 100644
--- a/lib/crewai/src/crewai/agents/agent_builder/base_agent.py
+++ b/lib/crewai/src/crewai/agents/agent_builder/base_agent.py
@@ -43,7 +43,6 @@ from crewai.state.checkpoint_config import CheckpointConfig, _coerce_checkpoint
 from crewai.tools.base_tool import BaseTool, Tool
 from crewai.types.callback import SerializableCallable
 from crewai.utilities.config import process_config
-from crewai.utilities.i18n import I18N, get_i18n
 from crewai.utilities.logger import Logger
 from crewai.utilities.rpm_controller import RPMController
 from crewai.utilities.string_utils import interpolate_only
@@ -179,7 +178,7 @@ class BaseAgent(BaseModel, ABC, metaclass=AgentMeta):
         agent_executor: An instance of the CrewAgentExecutor class.
         llm (Any): Language model that will run the agent.
         crew (Any): Crew to which the agent belongs.
-        i18n (I18N): Internationalization settings.
+
         cache_handler ([CacheHandler]): An instance of the CacheHandler class.
         tools_handler ([ToolsHandler]): An instance of the ToolsHandler class.
         max_tokens: Maximum number of tokens for the agent to generate in a response.
@@ -269,9 +268,6 @@ class BaseAgent(BaseModel, ABC, metaclass=AgentMeta):
             _serialize_crew_ref, return_type=str | None, when_used="always"
         ),
     ] = Field(default=None, description="Crew to which the agent belongs.")
-    i18n: I18N = Field(
-        default_factory=get_i18n, description="Internationalization settings."
-    )
     cache_handler: CacheHandler | None = Field(
         default=None, description="An instance of the CacheHandler class."
     )
diff --git a/lib/crewai/src/crewai/agents/agent_builder/base_agent_executor.py b/lib/crewai/src/crewai/agents/agent_builder/base_agent_executor.py
index a44b81fc3..d251b1d36 100644
--- a/lib/crewai/src/crewai/agents/agent_builder/base_agent_executor.py
+++ b/lib/crewai/src/crewai/agents/agent_builder/base_agent_executor.py
@@ -14,7 +14,6 @@ if TYPE_CHECKING:
     from crewai.agents.agent_builder.base_agent import BaseAgent
     from crewai.crew import Crew
     from crewai.task import Task
-    from crewai.utilities.i18n import I18N
 
 
 class BaseAgentExecutor(BaseModel):
@@ -28,7 +27,6 @@ class BaseAgentExecutor(BaseModel):
     max_iter: int = Field(default=25)
     messages: list[LLMMessage] = Field(default_factory=list)
     _resuming: bool = PrivateAttr(default=False)
-    _i18n: I18N | None = PrivateAttr(default=None)
 
     def _save_to_memory(self, output: AgentFinish) -> None:
         """Save task result to unified memory (memory or crew._memory)."""
diff --git a/lib/crewai/src/crewai/agents/crew_agent_executor.py b/lib/crewai/src/crewai/agents/crew_agent_executor.py
index 6307d5b9c..909fa5c66 100644
--- a/lib/crewai/src/crewai/agents/crew_agent_executor.py
+++ b/lib/crewai/src/crewai/agents/crew_agent_executor.py
@@ -67,7 +67,7 @@ from crewai.utilities.agent_utils import (
 )
 from crewai.utilities.constants import TRAINING_DATA_FILE
 from crewai.utilities.file_store import aget_all_files, get_all_files
-from crewai.utilities.i18n import I18N, get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.printer import PRINTER
 from crewai.utilities.string_utils import sanitize_tool_name
 from crewai.utilities.token_counter_callback import TokenCalcHandler
@@ -135,9 +135,8 @@ class CrewAgentExecutor(BaseAgentExecutor):
 
     model_config = ConfigDict(arbitrary_types_allowed=True, populate_by_name=True)
 
-    def __init__(self, i18n: I18N | None = None, **kwargs: Any) -> None:
+    def __init__(self, **kwargs: Any) -> None:
         super().__init__(**kwargs)
-        self._i18n = i18n or get_i18n()
         if not self.before_llm_call_hooks:
             self.before_llm_call_hooks.extend(get_before_llm_call_hooks())
         if not self.after_llm_call_hooks:
@@ -328,7 +327,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                     formatted_answer = handle_max_iterations_exceeded(
                         formatted_answer,
                         printer=PRINTER,
-                        i18n=self._i18n,
                         messages=self.messages,
                         llm=cast("BaseLLM", self.llm),
                         callbacks=self.callbacks,
@@ -401,7 +399,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                         agent_action=formatted_answer,
                         fingerprint_context=fingerprint_context,
                         tools=self.tools,
-                        i18n=self._i18n,
                         agent_key=self.agent.key if self.agent else None,
                         agent_role=self.agent.role if self.agent else None,
                         tools_handler=self.tools_handler,
@@ -438,7 +435,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                         messages=self.messages,
                         llm=cast("BaseLLM", self.llm),
                         callbacks=self.callbacks,
-                        i18n=self._i18n,
                         verbose=self.agent.verbose,
                     )
                     continue
@@ -484,7 +480,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                     formatted_answer = handle_max_iterations_exceeded(
                         None,
                         printer=PRINTER,
-                        i18n=self._i18n,
                         messages=self.messages,
                         llm=cast("BaseLLM", self.llm),
                         callbacks=self.callbacks,
@@ -575,7 +570,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                         messages=self.messages,
                         llm=cast("BaseLLM", self.llm),
                         callbacks=self.callbacks,
-                        i18n=self._i18n,
                         verbose=self.agent.verbose,
                     )
                     continue
@@ -771,7 +765,7 @@ class CrewAgentExecutor(BaseAgentExecutor):
                     if tool_finish:
                         return tool_finish
 
-                reasoning_prompt = self._i18n.slice("post_tool_reasoning")
+                reasoning_prompt = I18N_DEFAULT.slice("post_tool_reasoning")
                 reasoning_message: LLMMessage = {
                     "role": "user",
                     "content": reasoning_prompt,
@@ -795,7 +789,7 @@ class CrewAgentExecutor(BaseAgentExecutor):
         if tool_finish:
             return tool_finish
 
-        reasoning_prompt = self._i18n.slice("post_tool_reasoning")
+        reasoning_prompt = I18N_DEFAULT.slice("post_tool_reasoning")
         reasoning_message = {
             "role": "user",
             "content": reasoning_prompt,
@@ -1170,7 +1164,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                     formatted_answer = handle_max_iterations_exceeded(
                         formatted_answer,
                         printer=PRINTER,
-                        i18n=self._i18n,
                         messages=self.messages,
                         llm=cast("BaseLLM", self.llm),
                         callbacks=self.callbacks,
@@ -1242,7 +1235,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                         agent_action=formatted_answer,
                         fingerprint_context=fingerprint_context,
                         tools=self.tools,
-                        i18n=self._i18n,
                         agent_key=self.agent.key if self.agent else None,
                         agent_role=self.agent.role if self.agent else None,
                         tools_handler=self.tools_handler,
@@ -1278,7 +1270,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                         messages=self.messages,
                         llm=cast("BaseLLM", self.llm),
                         callbacks=self.callbacks,
-                        i18n=self._i18n,
                         verbose=self.agent.verbose,
                     )
                     continue
@@ -1318,7 +1309,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                     formatted_answer = handle_max_iterations_exceeded(
                         None,
                         printer=PRINTER,
-                        i18n=self._i18n,
                         messages=self.messages,
                         llm=cast("BaseLLM", self.llm),
                         callbacks=self.callbacks,
@@ -1408,7 +1398,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                         messages=self.messages,
                         llm=cast("BaseLLM", self.llm),
                         callbacks=self.callbacks,
-                        i18n=self._i18n,
                         verbose=self.agent.verbose,
                     )
                     continue
@@ -1467,7 +1456,7 @@ class CrewAgentExecutor(BaseAgentExecutor):
             Updated action or final answer.
         """
         # Special case for add_image_tool
-        add_image_tool = self._i18n.tools("add_image")
+        add_image_tool = I18N_DEFAULT.tools("add_image")
         if (
             isinstance(add_image_tool, dict)
             and formatted_answer.tool.casefold().strip()
@@ -1673,5 +1662,5 @@ class CrewAgentExecutor(BaseAgentExecutor):
             Formatted message dict.
         """
         return format_message_for_llm(
-            self._i18n.slice("feedback_instructions").format(feedback=feedback)
+            I18N_DEFAULT.slice("feedback_instructions").format(feedback=feedback)
         )
diff --git a/lib/crewai/src/crewai/agents/parser.py b/lib/crewai/src/crewai/agents/parser.py
index 365443b45..bfe3a28b5 100644
--- a/lib/crewai/src/crewai/agents/parser.py
+++ b/lib/crewai/src/crewai/agents/parser.py
@@ -19,10 +19,7 @@ from crewai.agents.constants import (
     MISSING_ACTION_INPUT_AFTER_ACTION_ERROR_MESSAGE,
     UNABLE_TO_REPAIR_JSON_RESULTS,
 )
-from crewai.utilities.i18n import get_i18n
-
-
-_I18N = get_i18n()
+from crewai.utilities.i18n import I18N_DEFAULT as _I18N
 
 
 @dataclass
diff --git a/lib/crewai/src/crewai/agents/planner_observer.py b/lib/crewai/src/crewai/agents/planner_observer.py
index 16d1a747e..0705d3013 100644
--- a/lib/crewai/src/crewai/agents/planner_observer.py
+++ b/lib/crewai/src/crewai/agents/planner_observer.py
@@ -23,7 +23,7 @@ from crewai.events.types.observation_events import (
     StepObservationStartedEvent,
 )
 from crewai.utilities.agent_utils import extract_task_section
-from crewai.utilities.i18n import I18N, get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.llm_utils import create_llm
 from crewai.utilities.planning_types import StepObservation, TodoItem
 from crewai.utilities.types import LLMMessage
@@ -64,7 +64,6 @@ class PlannerObserver:
         self.task = task
         self.kickoff_input = kickoff_input
         self.llm = self._resolve_llm()
-        self._i18n: I18N = get_i18n()
 
     def _resolve_llm(self) -> Any:
         """Resolve which LLM to use for observation/planning.
@@ -246,7 +245,7 @@ class PlannerObserver:
             task_desc = extract_task_section(self.kickoff_input)
             task_goal = "Complete the task successfully"
 
-        system_prompt = self._i18n.retrieve("planning", "observation_system_prompt")
+        system_prompt = I18N_DEFAULT.retrieve("planning", "observation_system_prompt")
 
         # Build context of what's been done
         completed_summary = ""
@@ -273,7 +272,9 @@ class PlannerObserver:
                 remaining_lines
             )
 
-        user_prompt = self._i18n.retrieve("planning", "observation_user_prompt").format(
+        user_prompt = I18N_DEFAULT.retrieve(
+            "planning", "observation_user_prompt"
+        ).format(
             task_description=task_desc,
             task_goal=task_goal,
             completed_summary=completed_summary,
diff --git a/lib/crewai/src/crewai/agents/step_executor.py b/lib/crewai/src/crewai/agents/step_executor.py
index 48592efb4..3348692b6 100644
--- a/lib/crewai/src/crewai/agents/step_executor.py
+++ b/lib/crewai/src/crewai/agents/step_executor.py
@@ -38,7 +38,7 @@ from crewai.utilities.agent_utils import (
     process_llm_response,
     setup_native_tools,
 )
-from crewai.utilities.i18n import I18N, get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.planning_types import TodoItem
 from crewai.utilities.printer import PRINTER
 from crewai.utilities.step_execution_context import StepExecutionContext, StepResult
@@ -81,7 +81,7 @@ class StepExecutor:
         function_calling_llm: Optional separate LLM for function calling.
         request_within_rpm_limit: Optional RPM limit function.
         callbacks: Optional list of callbacks.
-        i18n: Optional i18n instance.
+
     """
 
     def __init__(
@@ -96,7 +96,6 @@ class StepExecutor:
         function_calling_llm: BaseLLM | None = None,
         request_within_rpm_limit: Callable[[], bool] | None = None,
         callbacks: list[Any] | None = None,
-        i18n: I18N | None = None,
     ) -> None:
         self.llm = llm
         self.tools = tools
@@ -108,7 +107,6 @@ class StepExecutor:
         self.function_calling_llm = function_calling_llm
         self.request_within_rpm_limit = request_within_rpm_limit
         self.callbacks = callbacks or []
-        self._i18n: I18N = i18n or get_i18n()
 
         # Native tool support — set up once
         self._use_native_tools = check_native_tool_support(
@@ -221,14 +219,14 @@ class StepExecutor:
         tools_section = ""
         if self.tools and not self._use_native_tools:
             tool_names = ", ".join(sanitize_tool_name(t.name) for t in self.tools)
-            tools_section = self._i18n.retrieve(
+            tools_section = I18N_DEFAULT.retrieve(
                 "planning", "step_executor_tools_section"
             ).format(tool_names=tool_names)
         elif self.tools:
             tool_names = ", ".join(sanitize_tool_name(t.name) for t in self.tools)
             tools_section = f"\n\nAvailable tools: {tool_names}"
 
-        return self._i18n.retrieve("planning", "step_executor_system_prompt").format(
+        return I18N_DEFAULT.retrieve("planning", "step_executor_system_prompt").format(
             role=role,
             backstory=backstory,
             goal=goal,
@@ -247,7 +245,7 @@ class StepExecutor:
             task_section = extract_task_section(context.task_description)
             if task_section:
                 parts.append(
-                    self._i18n.retrieve(
+                    I18N_DEFAULT.retrieve(
                         "planning", "step_executor_task_context"
                     ).format(
                         task_context=task_section,
@@ -255,14 +253,16 @@ class StepExecutor:
                 )
 
         parts.append(
-            self._i18n.retrieve("planning", "step_executor_user_prompt").format(
+            I18N_DEFAULT.retrieve("planning", "step_executor_user_prompt").format(
                 step_description=todo.description,
             )
         )
 
         if todo.tool_to_use:
             parts.append(
-                self._i18n.retrieve("planning", "step_executor_suggested_tool").format(
+                I18N_DEFAULT.retrieve(
+                    "planning", "step_executor_suggested_tool"
+                ).format(
                     tool_to_use=todo.tool_to_use,
                 )
             )
@@ -270,16 +270,16 @@ class StepExecutor:
         # Include dependency results (final results only, no traces)
         if context.dependency_results:
             parts.append(
-                self._i18n.retrieve("planning", "step_executor_context_header")
+                I18N_DEFAULT.retrieve("planning", "step_executor_context_header")
             )
             for step_num, result in sorted(context.dependency_results.items()):
                 parts.append(
-                    self._i18n.retrieve(
+                    I18N_DEFAULT.retrieve(
                         "planning", "step_executor_context_entry"
                     ).format(step_number=step_num, result=result)
                 )
 
-        parts.append(self._i18n.retrieve("planning", "step_executor_complete_step"))
+        parts.append(I18N_DEFAULT.retrieve("planning", "step_executor_complete_step"))
 
         return "\n".join(parts)
 
@@ -375,7 +375,6 @@ class StepExecutor:
                 agent_action=formatted,
                 fingerprint_context=fingerprint_context,
                 tools=self.tools,
-                i18n=self._i18n,
                 agent_key=self.agent.key if self.agent else None,
                 agent_role=self.agent.role if self.agent else None,
                 tools_handler=self.tools_handler,
diff --git a/lib/crewai/src/crewai/experimental/agent_executor.py b/lib/crewai/src/crewai/experimental/agent_executor.py
index 72b732766..ef33fab43 100644
--- a/lib/crewai/src/crewai/experimental/agent_executor.py
+++ b/lib/crewai/src/crewai/experimental/agent_executor.py
@@ -91,7 +91,7 @@ from crewai.utilities.agent_utils import (
     track_delegation_if_needed,
 )
 from crewai.utilities.constants import TRAINING_DATA_FILE
-from crewai.utilities.i18n import I18N, get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.planning_types import (
     PlanStep,
     StepObservation,
@@ -189,7 +189,6 @@ class AgentExecutor(Flow[AgentExecutorState], BaseAgentExecutor):  # type: ignor
     )
     callbacks: list[Any] = Field(default_factory=list, exclude=True)
     response_model: type[BaseModel] | None = Field(default=None, exclude=True)
-    i18n: I18N | None = Field(default=None, exclude=True)
     log_error_after: int = Field(default=3, exclude=True)
     before_llm_call_hooks: list[BeforeLLMCallHookType | BeforeLLMCallHookCallable] = (
         Field(default_factory=list, exclude=True)
@@ -198,7 +197,6 @@ class AgentExecutor(Flow[AgentExecutorState], BaseAgentExecutor):  # type: ignor
         default_factory=list, exclude=True
     )
 
-    _i18n: I18N = PrivateAttr(default_factory=get_i18n)
     _console: Console = PrivateAttr(default_factory=Console)
     _last_parser_error: OutputParserError | None = PrivateAttr(default=None)
     _last_context_error: Exception | None = PrivateAttr(default=None)
@@ -214,7 +212,6 @@ class AgentExecutor(Flow[AgentExecutorState], BaseAgentExecutor):  # type: ignor
     @model_validator(mode="after")
     def _setup_executor(self) -> Self:
         """Configure executor after Pydantic field initialization."""
-        self._i18n = self.i18n or get_i18n()
         self.before_llm_call_hooks.extend(get_before_llm_call_hooks())
         self.after_llm_call_hooks.extend(get_after_llm_call_hooks())
 
@@ -363,7 +360,6 @@ class AgentExecutor(Flow[AgentExecutorState], BaseAgentExecutor):  # type: ignor
                 function_calling_llm=self.function_calling_llm,
                 request_within_rpm_limit=self.request_within_rpm_limit,
                 callbacks=self.callbacks,
-                i18n=self._i18n,
             )
         return self._step_executor
 
@@ -1203,7 +1199,6 @@ class AgentExecutor(Flow[AgentExecutorState], BaseAgentExecutor):  # type: ignor
         formatted_answer = handle_max_iterations_exceeded(
             formatted_answer=None,
             printer=PRINTER,
-            i18n=self._i18n,
             messages=list(self.state.messages),
             llm=self.llm,
             callbacks=self.callbacks,
@@ -1430,7 +1425,6 @@ class AgentExecutor(Flow[AgentExecutorState], BaseAgentExecutor):  # type: ignor
                 agent_action=action,
                 fingerprint_context=fingerprint_context,
                 tools=self.tools,
-                i18n=self._i18n,
                 agent_key=self.agent.key if self.agent else None,
                 agent_role=self.agent.role if self.agent else None,
                 tools_handler=self.tools_handler,
@@ -1450,7 +1444,7 @@ class AgentExecutor(Flow[AgentExecutorState], BaseAgentExecutor):  # type: ignor
             action.result = str(e)
             self._append_message_to_state(action.text)
 
-            reasoning_prompt = self._i18n.slice("post_tool_reasoning")
+            reasoning_prompt = I18N_DEFAULT.slice("post_tool_reasoning")
             reasoning_message: LLMMessage = {
                 "role": "user",
                 "content": reasoning_prompt,
@@ -1471,7 +1465,7 @@ class AgentExecutor(Flow[AgentExecutorState], BaseAgentExecutor):  # type: ignor
             self.state.is_finished = True
             return "tool_result_is_final"
 
-        reasoning_prompt = self._i18n.slice("post_tool_reasoning")
+        reasoning_prompt = I18N_DEFAULT.slice("post_tool_reasoning")
         reasoning_message_post: LLMMessage = {
             "role": "user",
             "content": reasoning_prompt,
@@ -2222,10 +2216,10 @@ class AgentExecutor(Flow[AgentExecutorState], BaseAgentExecutor):  # type: ignor
         # Build synthesis prompt
         role = self.agent.role if self.agent else "Assistant"
 
-        system_prompt = self._i18n.retrieve(
+        system_prompt = I18N_DEFAULT.retrieve(
             "planning", "synthesis_system_prompt"
         ).format(role=role)
-        user_prompt = self._i18n.retrieve("planning", "synthesis_user_prompt").format(
+        user_prompt = I18N_DEFAULT.retrieve("planning", "synthesis_user_prompt").format(
             task_description=task_description,
             combined_steps=combined_steps,
         )
@@ -2472,7 +2466,7 @@ class AgentExecutor(Flow[AgentExecutorState], BaseAgentExecutor):  # type: ignor
             self.task.description if self.task else getattr(self, "_kickoff_input", "")
         )
 
-        enhancement = self._i18n.retrieve(
+        enhancement = I18N_DEFAULT.retrieve(
             "planning", "replan_enhancement_prompt"
         ).format(previous_context=previous_context)
 
@@ -2535,7 +2529,6 @@ class AgentExecutor(Flow[AgentExecutorState], BaseAgentExecutor):  # type: ignor
             messages=self.state.messages,
             llm=self.llm,
             callbacks=self.callbacks,
-            i18n=self._i18n,
             verbose=self.agent.verbose,
         )
 
@@ -2746,7 +2739,7 @@ class AgentExecutor(Flow[AgentExecutorState], BaseAgentExecutor):  # type: ignor
         Returns:
             Updated action or final answer.
         """
-        add_image_tool = self._i18n.tools("add_image")
+        add_image_tool = I18N_DEFAULT.tools("add_image")
         if (
             isinstance(add_image_tool, dict)
             and formatted_answer.tool.casefold().strip()
diff --git a/lib/crewai/src/crewai/flow/flow.py b/lib/crewai/src/crewai/flow/flow.py
index 97e6bdf20..16cc88db2 100644
--- a/lib/crewai/src/crewai/flow/flow.py
+++ b/lib/crewai/src/crewai/flow/flow.py
@@ -3194,7 +3194,7 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
 
         from crewai.llm import LLM
         from crewai.llms.base_llm import BaseLLM as BaseLLMClass
-        from crewai.utilities.i18n import get_i18n
+        from crewai.utilities.i18n import I18N_DEFAULT
 
         llm_instance: BaseLLMClass
         if isinstance(llm, str):
@@ -3214,9 +3214,7 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
                 description=f"The outcome that best matches the feedback. Must be one of: {', '.join(outcomes)}"
             )
 
-        # Load prompt from translations (using cached instance)
-        i18n = get_i18n()
-        prompt_template = i18n.slice("human_feedback_collapse")
+        prompt_template = I18N_DEFAULT.slice("human_feedback_collapse")
 
         prompt = prompt_template.format(
             feedback=feedback,
diff --git a/lib/crewai/src/crewai/flow/human_feedback.py b/lib/crewai/src/crewai/flow/human_feedback.py
index 5fedbd3a2..e6a51d9da 100644
--- a/lib/crewai/src/crewai/flow/human_feedback.py
+++ b/lib/crewai/src/crewai/flow/human_feedback.py
@@ -350,9 +350,9 @@ def human_feedback(
 
         def _get_hitl_prompt(key: str) -> str:
             """Read a HITL prompt from the i18n translations."""
-            from crewai.utilities.i18n import get_i18n
+            from crewai.utilities.i18n import I18N_DEFAULT
 
-            return get_i18n().slice(key)
+            return I18N_DEFAULT.slice(key)
 
         def _resolve_llm_instance() -> Any:
             """Resolve the ``llm`` parameter to a BaseLLM instance.
diff --git a/lib/crewai/src/crewai/lite_agent.py b/lib/crewai/src/crewai/lite_agent.py
index f96c84493..07813b60f 100644
--- a/lib/crewai/src/crewai/lite_agent.py
+++ b/lib/crewai/src/crewai/lite_agent.py
@@ -89,7 +89,7 @@ from crewai.utilities.converter import (
 )
 from crewai.utilities.guardrail import process_guardrail
 from crewai.utilities.guardrail_types import GuardrailCallable, GuardrailType
-from crewai.utilities.i18n import I18N, get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.llm_utils import create_llm
 from crewai.utilities.printer import PRINTER
 from crewai.utilities.pydantic_schema_utils import generate_model_description
@@ -227,9 +227,6 @@ class LiteAgent(FlowTrackable, BaseModel):
         default=None,
         description="Callback to check if the request is within the RPM8 limit",
     )
-    i18n: I18N = Field(
-        default_factory=get_i18n, description="Internationalization settings."
-    )
     response_format: type[BaseModel] | None = Field(
         default=None, description="Pydantic model for structured output"
     )
@@ -571,7 +568,7 @@ class LiteAgent(FlowTrackable, BaseModel):
                     f"- {m.record.content}" for m in matches
                 )
             if memory_block:
-                formatted = self.i18n.slice("memory").format(memory=memory_block)
+                formatted = I18N_DEFAULT.slice("memory").format(memory=memory_block)
                 if self._messages and self._messages[0].get("role") == "system":
                     existing_content = self._messages[0].get("content", "")
                     if not isinstance(existing_content, str):
@@ -644,7 +641,7 @@ class LiteAgent(FlowTrackable, BaseModel):
             try:
                 model_schema = generate_model_description(active_response_format)
                 schema = json.dumps(model_schema, indent=2)
-                instructions = self.i18n.slice("formatted_task_instructions").format(
+                instructions = I18N_DEFAULT.slice("formatted_task_instructions").format(
                     output_format=schema
                 )
 
@@ -793,7 +790,9 @@ class LiteAgent(FlowTrackable, BaseModel):
         base_prompt = ""
         if self._parsed_tools:
             # Use the prompt template for agents with tools
-            base_prompt = self.i18n.slice("lite_agent_system_prompt_with_tools").format(
+            base_prompt = I18N_DEFAULT.slice(
+                "lite_agent_system_prompt_with_tools"
+            ).format(
                 role=self.role,
                 backstory=self.backstory,
                 goal=self.goal,
@@ -802,7 +801,7 @@ class LiteAgent(FlowTrackable, BaseModel):
             )
         else:
             # Use the prompt template for agents without tools
-            base_prompt = self.i18n.slice(
+            base_prompt = I18N_DEFAULT.slice(
                 "lite_agent_system_prompt_without_tools"
             ).format(
                 role=self.role,
@@ -814,7 +813,7 @@ class LiteAgent(FlowTrackable, BaseModel):
         if active_response_format:
             model_description = generate_model_description(active_response_format)
             schema_json = json.dumps(model_description, indent=2)
-            base_prompt += self.i18n.slice("lite_agent_response_format").format(
+            base_prompt += I18N_DEFAULT.slice("lite_agent_response_format").format(
                 response_format=schema_json
             )
 
@@ -875,7 +874,6 @@ class LiteAgent(FlowTrackable, BaseModel):
                     formatted_answer = handle_max_iterations_exceeded(
                         formatted_answer,
                         printer=PRINTER,
-                        i18n=self.i18n,
                         messages=self._messages,
                         llm=cast(LLM, self.llm),
                         callbacks=self._callbacks,
@@ -914,7 +912,6 @@ class LiteAgent(FlowTrackable, BaseModel):
                         tool_result = execute_tool_and_check_finality(
                             agent_action=formatted_answer,
                             tools=self._parsed_tools,
-                            i18n=self.i18n,
                             agent_key=self.key,
                             agent_role=self.role,
                             agent=self.original_agent,
@@ -956,7 +953,6 @@ class LiteAgent(FlowTrackable, BaseModel):
                         messages=self._messages,
                         llm=cast(LLM, self.llm),
                         callbacks=self._callbacks,
-                        i18n=self.i18n,
                         verbose=self.verbose,
                     )
                     continue
diff --git a/lib/crewai/src/crewai/memory/analyze.py b/lib/crewai/src/crewai/memory/analyze.py
index e700f4281..65d671d0d 100644
--- a/lib/crewai/src/crewai/memory/analyze.py
+++ b/lib/crewai/src/crewai/memory/analyze.py
@@ -9,7 +9,7 @@ from typing import Any
 from pydantic import BaseModel, ConfigDict, Field
 
 from crewai.memory.types import MemoryRecord, ScopeInfo
-from crewai.utilities.i18n import get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 
 
 _logger = logging.getLogger(__name__)
@@ -149,7 +149,7 @@ def _get_prompt(key: str) -> str:
     Returns:
         The prompt string.
     """
-    return get_i18n().memory(key)
+    return I18N_DEFAULT.memory(key)
 
 
 def extract_memories_from_content(content: str, llm: Any) -> list[str]:
diff --git a/lib/crewai/src/crewai/task.py b/lib/crewai/src/crewai/task.py
index 5671282dc..4224828e3 100644
--- a/lib/crewai/src/crewai/task.py
+++ b/lib/crewai/src/crewai/task.py
@@ -80,7 +80,7 @@ from crewai.utilities.guardrail_types import (
     GuardrailType,
     GuardrailsType,
 )
-from crewai.utilities.i18n import I18N, get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.printer import PRINTER
 from crewai.utilities.string_utils import interpolate_only
 
@@ -115,7 +115,6 @@ class Task(BaseModel):
     used_tools: int = 0
     tools_errors: int = 0
     delegations: int = 0
-    i18n: I18N = Field(default_factory=get_i18n)
     name: str | None = Field(default=None)
     prompt_context: str | None = None
     description: str = Field(description="Description of the actual task.")
@@ -896,7 +895,7 @@ class Task(BaseModel):
 
         tasks_slices = [description]
 
-        output = self.i18n.slice("expected_output").format(
+        output = I18N_DEFAULT.slice("expected_output").format(
             expected_output=self.expected_output
         )
         tasks_slices = [description, output]
@@ -968,7 +967,7 @@ Follow these guidelines:
                 raise ValueError(f"Error interpolating output_file path: {e!s}") from e
 
         if inputs.get("crew_chat_messages"):
-            conversation_instruction = self.i18n.slice(
+            conversation_instruction = I18N_DEFAULT.slice(
                 "conversation_history_instruction"
             )
 
@@ -1219,7 +1218,7 @@ Follow these guidelines:
                 self.retry_count += 1
                 current_retry_count = self.retry_count
 
-            context = self.i18n.errors("validation_error").format(
+            context = I18N_DEFAULT.errors("validation_error").format(
                 guardrail_result_error=guardrail_result.error,
                 task_output=task_output.raw,
             )
@@ -1316,7 +1315,7 @@ Follow these guidelines:
                 self.retry_count += 1
                 current_retry_count = self.retry_count
 
-            context = self.i18n.errors("validation_error").format(
+            context = I18N_DEFAULT.errors("validation_error").format(
                 guardrail_result_error=guardrail_result.error,
                 task_output=task_output.raw,
             )
diff --git a/lib/crewai/src/crewai/telemetry/telemetry.py b/lib/crewai/src/crewai/telemetry/telemetry.py
index 7809c5b4c..94939bb7a 100644
--- a/lib/crewai/src/crewai/telemetry/telemetry.py
+++ b/lib/crewai/src/crewai/telemetry/telemetry.py
@@ -52,6 +52,7 @@ from crewai.telemetry.utils import (
     add_crew_attributes,
     close_span,
 )
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.logger_utils import suppress_warnings
 from crewai.utilities.string_utils import sanitize_tool_name
 
@@ -314,7 +315,7 @@ class Telemetry:
                                 "verbose?": agent.verbose,
                                 "max_iter": agent.max_iter,
                                 "max_rpm": agent.max_rpm,
-                                "i18n": agent.i18n.prompt_file,
+                                "i18n": I18N_DEFAULT.prompt_file,
                                 "function_calling_llm": (
                                     getattr(
                                         getattr(agent, "function_calling_llm", None),
@@ -844,7 +845,7 @@ class Telemetry:
                             "verbose?": agent.verbose,
                             "max_iter": agent.max_iter,
                             "max_rpm": agent.max_rpm,
-                            "i18n": agent.i18n.prompt_file,
+                            "i18n": I18N_DEFAULT.prompt_file,
                             "llm": agent.llm.model
                             if isinstance(agent.llm, BaseLLM)
                             else str(agent.llm),
diff --git a/lib/crewai/src/crewai/tools/agent_tools/add_image_tool.py b/lib/crewai/src/crewai/tools/agent_tools/add_image_tool.py
index e9ef66e81..8191144d9 100644
--- a/lib/crewai/src/crewai/tools/agent_tools/add_image_tool.py
+++ b/lib/crewai/src/crewai/tools/agent_tools/add_image_tool.py
@@ -3,10 +3,7 @@ from typing import Any
 from pydantic import BaseModel, Field
 
 from crewai.tools.base_tool import BaseTool
-from crewai.utilities import I18N
-
-
-i18n = I18N()
+from crewai.utilities.i18n import I18N_DEFAULT
 
 
 class AddImageToolSchema(BaseModel):
@@ -19,9 +16,9 @@ class AddImageToolSchema(BaseModel):
 class AddImageTool(BaseTool):
     """Tool for adding images to the content"""
 
-    name: str = Field(default_factory=lambda: i18n.tools("add_image")["name"])  # type: ignore[index]
+    name: str = Field(default_factory=lambda: I18N_DEFAULT.tools("add_image")["name"])  # type: ignore[index]
     description: str = Field(
-        default_factory=lambda: i18n.tools("add_image")["description"]  # type: ignore[index]
+        default_factory=lambda: I18N_DEFAULT.tools("add_image")["description"]  # type: ignore[index]
     )
     args_schema: type[BaseModel] = AddImageToolSchema
 
@@ -31,7 +28,7 @@ class AddImageTool(BaseTool):
         action: str | None = None,
         **kwargs: Any,
     ) -> dict[str, Any]:
-        action = action or i18n.tools("add_image")["default_action"]  # type: ignore
+        action = action or I18N_DEFAULT.tools("add_image")["default_action"]  # type: ignore
         content = [
             {"type": "text", "text": action},
             {
diff --git a/lib/crewai/src/crewai/tools/agent_tools/agent_tools.py b/lib/crewai/src/crewai/tools/agent_tools/agent_tools.py
index 51552f7a8..533217456 100644
--- a/lib/crewai/src/crewai/tools/agent_tools/agent_tools.py
+++ b/lib/crewai/src/crewai/tools/agent_tools/agent_tools.py
@@ -5,21 +5,19 @@ from typing import TYPE_CHECKING
 
 from crewai.tools.agent_tools.ask_question_tool import AskQuestionTool
 from crewai.tools.agent_tools.delegate_work_tool import DelegateWorkTool
-from crewai.utilities.i18n import get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 
 
 if TYPE_CHECKING:
     from crewai.agents.agent_builder.base_agent import BaseAgent
     from crewai.tools.base_tool import BaseTool
-    from crewai.utilities.i18n import I18N
 
 
 class AgentTools:
     """Manager class for agent-related tools"""
 
-    def __init__(self, agents: Sequence[BaseAgent], i18n: I18N | None = None) -> None:
+    def __init__(self, agents: Sequence[BaseAgent]) -> None:
         self.agents = agents
-        self.i18n = i18n if i18n is not None else get_i18n()
 
     def tools(self) -> list[BaseTool]:
         """Get all available agent tools"""
@@ -27,14 +25,12 @@ class AgentTools:
 
         delegate_tool = DelegateWorkTool(
             agents=self.agents,
-            i18n=self.i18n,
-            description=self.i18n.tools("delegate_work").format(coworkers=coworkers),  # type: ignore
+            description=I18N_DEFAULT.tools("delegate_work").format(coworkers=coworkers),  # type: ignore
         )
 
         ask_tool = AskQuestionTool(
             agents=self.agents,
-            i18n=self.i18n,
-            description=self.i18n.tools("ask_question").format(coworkers=coworkers),  # type: ignore
+            description=I18N_DEFAULT.tools("ask_question").format(coworkers=coworkers),  # type: ignore
         )
 
         return [delegate_tool, ask_tool]
diff --git a/lib/crewai/src/crewai/tools/agent_tools/base_agent_tools.py b/lib/crewai/src/crewai/tools/agent_tools/base_agent_tools.py
index 8e5b959a4..17e44e57a 100644
--- a/lib/crewai/src/crewai/tools/agent_tools/base_agent_tools.py
+++ b/lib/crewai/src/crewai/tools/agent_tools/base_agent_tools.py
@@ -6,7 +6,7 @@ from pydantic import Field
 from crewai.agents.agent_builder.base_agent import BaseAgent
 from crewai.task import Task
 from crewai.tools.base_tool import BaseTool
-from crewai.utilities.i18n import I18N, get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 
 
 logger = logging.getLogger(__name__)
@@ -16,9 +16,6 @@ class BaseAgentTool(BaseTool):
     """Base class for agent-related tools"""
 
     agents: list[BaseAgent] = Field(description="List of available agents")
-    i18n: I18N = Field(
-        default_factory=get_i18n, description="Internationalization settings"
-    )
 
     def sanitize_agent_name(self, name: str) -> str:
         """
@@ -93,7 +90,7 @@ class BaseAgentTool(BaseTool):
             )
         except (AttributeError, ValueError) as e:
             # Handle specific exceptions that might occur during role name processing
-            return self.i18n.errors("agent_tool_unexisting_coworker").format(
+            return I18N_DEFAULT.errors("agent_tool_unexisting_coworker").format(
                 coworkers="\n".join(
                     [
                         f"- {self.sanitize_agent_name(agent.role)}"
@@ -105,7 +102,7 @@ class BaseAgentTool(BaseTool):
 
         if not agent:
             # No matching agent found after sanitization
-            return self.i18n.errors("agent_tool_unexisting_coworker").format(
+            return I18N_DEFAULT.errors("agent_tool_unexisting_coworker").format(
                 coworkers="\n".join(
                     [
                         f"- {self.sanitize_agent_name(agent.role)}"
@@ -120,8 +117,7 @@ class BaseAgentTool(BaseTool):
             task_with_assigned_agent = Task(
                 description=task,
                 agent=selected_agent,
-                expected_output=selected_agent.i18n.slice("manager_request"),
-                i18n=selected_agent.i18n,
+                expected_output=I18N_DEFAULT.slice("manager_request"),
             )
             logger.debug(
                 f"Created task for agent '{self.sanitize_agent_name(selected_agent.role)}': {task}"
@@ -129,6 +125,6 @@ class BaseAgentTool(BaseTool):
             return selected_agent.execute_task(task_with_assigned_agent, context)
         except Exception as e:
             # Handle task creation or execution errors
-            return self.i18n.errors("agent_tool_execution_error").format(
+            return I18N_DEFAULT.errors("agent_tool_execution_error").format(
                 agent_role=self.sanitize_agent_name(selected_agent.role), error=str(e)
             )
diff --git a/lib/crewai/src/crewai/tools/memory_tools.py b/lib/crewai/src/crewai/tools/memory_tools.py
index c1874a532..e790c93f1 100644
--- a/lib/crewai/src/crewai/tools/memory_tools.py
+++ b/lib/crewai/src/crewai/tools/memory_tools.py
@@ -7,7 +7,7 @@ from typing import Any
 from pydantic import BaseModel, Field
 
 from crewai.tools.base_tool import BaseTool
-from crewai.utilities.i18n import get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 
 
 class RecallMemorySchema(BaseModel):
@@ -114,18 +114,17 @@ def create_memory_tools(memory: Any) -> list[BaseTool]:
     Returns:
         List containing a RecallMemoryTool and, if not read-only, a RememberTool.
     """
-    i18n = get_i18n()
     tools: list[BaseTool] = [
         RecallMemoryTool(
             memory=memory,
-            description=i18n.tools("recall_memory"),
+            description=I18N_DEFAULT.tools("recall_memory"),
         ),
     ]
     if not memory.read_only:
         tools.append(
             RememberTool(
                 memory=memory,
-                description=i18n.tools("save_to_memory"),
+                description=I18N_DEFAULT.tools("save_to_memory"),
             )
         )
     return tools
diff --git a/lib/crewai/src/crewai/tools/tool_usage.py b/lib/crewai/src/crewai/tools/tool_usage.py
index c99b32cf5..09b44be17 100644
--- a/lib/crewai/src/crewai/tools/tool_usage.py
+++ b/lib/crewai/src/crewai/tools/tool_usage.py
@@ -28,7 +28,7 @@ from crewai.utilities.agent_utils import (
     render_text_description_and_args,
 )
 from crewai.utilities.converter import Converter
-from crewai.utilities.i18n import I18N, get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.printer import PRINTER
 from crewai.utilities.string_utils import sanitize_tool_name
 
@@ -93,7 +93,6 @@ class ToolUsage:
         action: Any = None,
         fingerprint_context: dict[str, str] | None = None,
     ) -> None:
-        self._i18n: I18N = agent.i18n if agent else get_i18n()
         self._telemetry: Telemetry = Telemetry()
         self._run_attempts: int = 1
         self._max_parsing_attempts: int = 3
@@ -146,7 +145,7 @@ class ToolUsage:
         if (
             isinstance(tool, CrewStructuredTool)
             and sanitize_tool_name(tool.name)
-            == sanitize_tool_name(self._i18n.tools("add_image")["name"])  # type: ignore
+            == sanitize_tool_name(I18N_DEFAULT.tools("add_image")["name"])  # type: ignore
         ):
             try:
                 return self._use(tool_string=tool_string, tool=tool, calling=calling)
@@ -194,7 +193,7 @@ class ToolUsage:
         if (
             isinstance(tool, CrewStructuredTool)
             and sanitize_tool_name(tool.name)
-            == sanitize_tool_name(self._i18n.tools("add_image")["name"])  # type: ignore
+            == sanitize_tool_name(I18N_DEFAULT.tools("add_image")["name"])  # type: ignore
         ):
             try:
                 return await self._ause(
@@ -230,7 +229,7 @@ class ToolUsage:
         """
         if self._check_tool_repeated_usage(calling=calling):
             try:
-                result = self._i18n.errors("task_repeated_usage").format(
+                result = I18N_DEFAULT.errors("task_repeated_usage").format(
                     tool_names=self.tools_names
                 )
                 self._telemetry.tool_repeated_usage(
@@ -415,7 +414,7 @@ class ToolUsage:
                     self._run_attempts += 1
                     if self._run_attempts > self._max_parsing_attempts:
                         self._telemetry.tool_usage_error(llm=self.function_calling_llm)
-                        error_message = self._i18n.errors(
+                        error_message = I18N_DEFAULT.errors(
                             "tool_usage_exception"
                         ).format(
                             error=e,
@@ -423,7 +422,7 @@ class ToolUsage:
                             tool_inputs=tool.description,
                         )
                         result = ToolUsageError(
-                            f"\n{error_message}.\nMoving on then. {self._i18n.slice('format').format(tool_names=self.tools_names)}"
+                            f"\n{error_message}.\nMoving on then. {I18N_DEFAULT.slice('format').format(tool_names=self.tools_names)}"
                         ).message
                         if self.task:
                             self.task.increment_tools_errors()
@@ -461,7 +460,7 @@ class ToolUsage:
         # Repeated usage check happens before event emission - safe to return early
         if self._check_tool_repeated_usage(calling=calling):
             try:
-                result = self._i18n.errors("task_repeated_usage").format(
+                result = I18N_DEFAULT.errors("task_repeated_usage").format(
                     tool_names=self.tools_names
                 )
                 self._telemetry.tool_repeated_usage(
@@ -648,7 +647,7 @@ class ToolUsage:
                     self._run_attempts += 1
                     if self._run_attempts > self._max_parsing_attempts:
                         self._telemetry.tool_usage_error(llm=self.function_calling_llm)
-                        error_message = self._i18n.errors(
+                        error_message = I18N_DEFAULT.errors(
                             "tool_usage_exception"
                         ).format(
                             error=e,
@@ -656,7 +655,7 @@ class ToolUsage:
                             tool_inputs=tool.description,
                         )
                         result = ToolUsageError(
-                            f"\n{error_message}.\nMoving on then. {self._i18n.slice('format').format(tool_names=self.tools_names)}"
+                            f"\n{error_message}.\nMoving on then. {I18N_DEFAULT.slice('format').format(tool_names=self.tools_names)}"
                         ).message
                         if self.task:
                             self.task.increment_tools_errors()
@@ -699,7 +698,7 @@ class ToolUsage:
 
     def _remember_format(self, result: str) -> str:
         result = str(result)
-        result += "\n\n" + self._i18n.slice("tools").format(
+        result += "\n\n" + I18N_DEFAULT.slice("tools").format(
             tools=self.tools_description, tool_names=self.tools_names
         )
         return result
@@ -825,12 +824,12 @@ class ToolUsage:
         except Exception:
             if raise_error:
                 raise
-            return ToolUsageError(f"{self._i18n.errors('tool_arguments_error')}")
+            return ToolUsageError(f"{I18N_DEFAULT.errors('tool_arguments_error')}")
 
         if not isinstance(arguments, dict):
             if raise_error:
                 raise
-            return ToolUsageError(f"{self._i18n.errors('tool_arguments_error')}")
+            return ToolUsageError(f"{I18N_DEFAULT.errors('tool_arguments_error')}")
 
         return ToolCalling(
             tool_name=sanitize_tool_name(tool.name),
@@ -856,7 +855,7 @@ class ToolUsage:
                 if self.agent and self.agent.verbose:
                     PRINTER.print(content=f"\n\n{e}\n", color="red")
                 return ToolUsageError(
-                    f"{self._i18n.errors('tool_usage_error').format(error=e)}\nMoving on then. {self._i18n.slice('format').format(tool_names=self.tools_names)}"
+                    f"{I18N_DEFAULT.errors('tool_usage_error').format(error=e)}\nMoving on then. {I18N_DEFAULT.slice('format').format(tool_names=self.tools_names)}"
                 )
             return self._tool_calling(tool_string)
 
diff --git a/lib/crewai/src/crewai/utilities/agent_utils.py b/lib/crewai/src/crewai/utilities/agent_utils.py
index d448cd162..684fd9287 100644
--- a/lib/crewai/src/crewai/utilities/agent_utils.py
+++ b/lib/crewai/src/crewai/utilities/agent_utils.py
@@ -31,7 +31,7 @@ from crewai.utilities.errors import AgentRepositoryError
 from crewai.utilities.exceptions.context_window_exceeding_exception import (
     LLMContextLengthExceededError,
 )
-from crewai.utilities.i18n import I18N
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.printer import PRINTER, ColoredText, Printer
 from crewai.utilities.pydantic_schema_utils import generate_model_description
 from crewai.utilities.string_utils import sanitize_tool_name
@@ -254,7 +254,6 @@ def has_reached_max_iterations(iterations: int, max_iterations: int) -> bool:
 def handle_max_iterations_exceeded(
     formatted_answer: AgentAction | AgentFinish | None,
     printer: Printer,
-    i18n: I18N,
     messages: list[LLMMessage],
     llm: LLM | BaseLLM,
     callbacks: list[TokenCalcHandler],
@@ -265,7 +264,6 @@ def handle_max_iterations_exceeded(
     Args:
         formatted_answer: The last formatted answer from the agent.
         printer: Printer instance for output.
-        i18n: I18N instance for internationalization.
         messages: List of messages to send to the LLM.
         llm: The LLM instance to call.
         callbacks: List of callbacks for the LLM call.
@@ -282,10 +280,10 @@ def handle_max_iterations_exceeded(
 
     if formatted_answer and hasattr(formatted_answer, "text"):
         assistant_message = (
-            formatted_answer.text + f"\n{i18n.errors('force_final_answer')}"
+            formatted_answer.text + f"\n{I18N_DEFAULT.errors('force_final_answer')}"
         )
     else:
-        assistant_message = i18n.errors("force_final_answer")
+        assistant_message = I18N_DEFAULT.errors("force_final_answer")
 
     messages.append(format_message_for_llm(assistant_message, role="assistant"))
 
@@ -687,7 +685,6 @@ def handle_context_length(
     messages: list[LLMMessage],
     llm: LLM | BaseLLM,
     callbacks: list[TokenCalcHandler],
-    i18n: I18N,
     verbose: bool = True,
 ) -> None:
     """Handle context length exceeded by either summarizing or raising an error.
@@ -698,7 +695,6 @@ def handle_context_length(
         messages: List of messages to summarize
         llm: LLM instance for summarization
         callbacks: List of callbacks for LLM
-        i18n: I18N instance for messages
 
     Raises:
         SystemExit: If context length is exceeded and user opts not to summarize
@@ -710,7 +706,7 @@ def handle_context_length(
                 color="yellow",
             )
         summarize_messages(
-            messages=messages, llm=llm, callbacks=callbacks, i18n=i18n, verbose=verbose
+            messages=messages, llm=llm, callbacks=callbacks, verbose=verbose
         )
     else:
         if verbose:
@@ -863,7 +859,6 @@ async def _asummarize_chunks(
     chunks: list[list[LLMMessage]],
     llm: LLM | BaseLLM,
     callbacks: list[TokenCalcHandler],
-    i18n: I18N,
 ) -> list[SummaryContent]:
     """Summarize multiple message chunks concurrently using asyncio.
 
@@ -871,7 +866,6 @@ async def _asummarize_chunks(
         chunks: List of message chunks to summarize.
         llm: LLM instance (must support ``acall``).
         callbacks: List of callbacks for the LLM.
-        i18n: I18N instance for prompt templates.
 
     Returns:
         Ordered list of summary contents, one per chunk.
@@ -881,10 +875,10 @@ async def _asummarize_chunks(
         conversation_text = _format_messages_for_summary(chunk)
         summarization_messages = [
             format_message_for_llm(
-                i18n.slice("summarizer_system_message"), role="system"
+                I18N_DEFAULT.slice("summarizer_system_message"), role="system"
             ),
             format_message_for_llm(
-                i18n.slice("summarize_instruction").format(
+                I18N_DEFAULT.slice("summarize_instruction").format(
                     conversation=conversation_text
                 ),
             ),
@@ -901,7 +895,6 @@ def summarize_messages(
     messages: list[LLMMessage],
     llm: LLM | BaseLLM,
     callbacks: list[TokenCalcHandler],
-    i18n: I18N,
     verbose: bool = True,
 ) -> None:
     """Summarize messages to fit within context window.
@@ -917,7 +910,6 @@ def summarize_messages(
         messages: List of messages to summarize (modified in-place)
         llm: LLM instance for summarization
         callbacks: List of callbacks for LLM
-        i18n: I18N instance for messages
         verbose: Whether to print progress.
     """
     # 1. Extract & preserve file attachments from user messages
@@ -953,10 +945,10 @@ def summarize_messages(
             conversation_text = _format_messages_for_summary(chunk)
             summarization_messages = [
                 format_message_for_llm(
-                    i18n.slice("summarizer_system_message"), role="system"
+                    I18N_DEFAULT.slice("summarizer_system_message"), role="system"
                 ),
                 format_message_for_llm(
-                    i18n.slice("summarize_instruction").format(
+                    I18N_DEFAULT.slice("summarize_instruction").format(
                         conversation=conversation_text
                     ),
                 ),
@@ -971,9 +963,7 @@ def summarize_messages(
                 content=f"Summarizing {total_chunks} chunks in parallel...",
                 color="yellow",
             )
-        coro = _asummarize_chunks(
-            chunks=chunks, llm=llm, callbacks=callbacks, i18n=i18n
-        )
+        coro = _asummarize_chunks(chunks=chunks, llm=llm, callbacks=callbacks)
         if is_inside_event_loop():
             ctx = contextvars.copy_context()
             with concurrent.futures.ThreadPoolExecutor(max_workers=1) as pool:
@@ -988,7 +978,7 @@ def summarize_messages(
     messages.extend(system_messages)
 
     summary_message = format_message_for_llm(
-        i18n.slice("summary").format(merged_summary=merged_summary)
+        I18N_DEFAULT.slice("summary").format(merged_summary=merged_summary)
     )
     if preserved_files:
         summary_message["files"] = preserved_files
diff --git a/lib/crewai/src/crewai/utilities/converter.py b/lib/crewai/src/crewai/utilities/converter.py
index 328ecbdf9..26dce6bd0 100644
--- a/lib/crewai/src/crewai/utilities/converter.py
+++ b/lib/crewai/src/crewai/utilities/converter.py
@@ -8,7 +8,7 @@ from pydantic import BaseModel, ValidationError
 from typing_extensions import Unpack
 
 from crewai.agents.agent_builder.utilities.base_output_converter import OutputConverter
-from crewai.utilities.i18n import get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.internal_instructor import InternalInstructor
 from crewai.utilities.printer import PRINTER
 from crewai.utilities.pydantic_schema_utils import generate_model_description
@@ -21,7 +21,7 @@ if TYPE_CHECKING:
     from crewai.llms.base_llm import BaseLLM
 
 _JSON_PATTERN: Final[re.Pattern[str]] = re.compile(r"({.*})", re.DOTALL)
-_I18N = get_i18n()
+_I18N = I18N_DEFAULT
 
 
 class ConverterError(Exception):
diff --git a/lib/crewai/src/crewai/utilities/evaluators/task_evaluator.py b/lib/crewai/src/crewai/utilities/evaluators/task_evaluator.py
index 0a76c2a6c..5915c2346 100644
--- a/lib/crewai/src/crewai/utilities/evaluators/task_evaluator.py
+++ b/lib/crewai/src/crewai/utilities/evaluators/task_evaluator.py
@@ -8,7 +8,7 @@ from pydantic import BaseModel, Field
 from crewai.events.event_bus import crewai_event_bus
 from crewai.events.types.task_events import TaskEvaluationEvent
 from crewai.utilities.converter import Converter
-from crewai.utilities.i18n import get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.pydantic_schema_utils import generate_model_description
 from crewai.utilities.training_converter import TrainingConverter
 
@@ -98,11 +98,9 @@ class TaskEvaluator:
 
         if not self.llm.supports_function_calling():  # type: ignore[union-attr]
             schema_dict = generate_model_description(TaskEvaluation)
-            output_schema: str = (
-                get_i18n()
-                .slice("formatted_task_instructions")
-                .format(output_format=json.dumps(schema_dict, indent=2))
-            )
+            output_schema: str = I18N_DEFAULT.slice(
+                "formatted_task_instructions"
+            ).format(output_format=json.dumps(schema_dict, indent=2))
             instructions = f"{instructions}\n\n{output_schema}"
 
         converter = Converter(
@@ -174,11 +172,9 @@ class TaskEvaluator:
 
         if not self.llm.supports_function_calling():  # type: ignore[union-attr]
             schema_dict = generate_model_description(TrainingTaskEvaluation)
-            output_schema: str = (
-                get_i18n()
-                .slice("formatted_task_instructions")
-                .format(output_format=json.dumps(schema_dict, indent=2))
-            )
+            output_schema: str = I18N_DEFAULT.slice(
+                "formatted_task_instructions"
+            ).format(output_format=json.dumps(schema_dict, indent=2))
             instructions = f"{instructions}\n\n{output_schema}"
 
         converter = TrainingConverter(
diff --git a/lib/crewai/src/crewai/utilities/i18n.py b/lib/crewai/src/crewai/utilities/i18n.py
index 623d8a22e..8d091dd52 100644
--- a/lib/crewai/src/crewai/utilities/i18n.py
+++ b/lib/crewai/src/crewai/utilities/i18n.py
@@ -142,3 +142,6 @@ def get_i18n(prompt_file: str | None = None) -> I18N:
         Cached I18N instance.
     """
     return I18N(prompt_file=prompt_file)
+
+
+I18N_DEFAULT: I18N = get_i18n()
diff --git a/lib/crewai/src/crewai/utilities/prompts.py b/lib/crewai/src/crewai/utilities/prompts.py
index 821623b89..31c1a1b27 100644
--- a/lib/crewai/src/crewai/utilities/prompts.py
+++ b/lib/crewai/src/crewai/utilities/prompts.py
@@ -6,7 +6,7 @@ from typing import Any, Literal
 
 from pydantic import BaseModel, Field
 
-from crewai.utilities.i18n import I18N, get_i18n
+from crewai.utilities.i18n import I18N_DEFAULT
 
 
 class StandardPromptResult(BaseModel):
@@ -49,7 +49,6 @@ class Prompts(BaseModel):
         - Need to refactor so that prompt is not tightly coupled to agent.
     """
 
-    i18n: I18N = Field(default_factory=get_i18n)
     has_tools: bool = Field(
         default=False, description="Indicates if the agent has access to tools"
     )
@@ -140,13 +139,13 @@ class Prompts(BaseModel):
         if not system_template or not prompt_template:
             # If any of the required templates are missing, fall back to the default format
             prompt_parts: list[str] = [
-                self.i18n.slice(component) for component in components
+                I18N_DEFAULT.slice(component) for component in components
             ]
             prompt = "".join(prompt_parts)
         else:
             # All templates are provided, use them
             template_parts: list[str] = [
-                self.i18n.slice(component)
+                I18N_DEFAULT.slice(component)
                 for component in components
                 if component != "task"
             ]
@@ -154,7 +153,7 @@ class Prompts(BaseModel):
                 "{{ .System }}", "".join(template_parts)
             )
             prompt = prompt_template.replace(
-                "{{ .Prompt }}", "".join(self.i18n.slice("task"))
+                "{{ .Prompt }}", "".join(I18N_DEFAULT.slice("task"))
             )
             # Handle missing response_template
             if response_template:
diff --git a/lib/crewai/src/crewai/utilities/reasoning_handler.py b/lib/crewai/src/crewai/utilities/reasoning_handler.py
index eecd8ee9a..ab3cbba16 100644
--- a/lib/crewai/src/crewai/utilities/reasoning_handler.py
+++ b/lib/crewai/src/crewai/utilities/reasoning_handler.py
@@ -15,6 +15,7 @@ from crewai.events.types.reasoning_events import (
     AgentReasoningStartedEvent,
 )
 from crewai.llm import LLM
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.llm_utils import create_llm
 from crewai.utilities.planning_types import PlanStep
 from crewai.utilities.string_utils import sanitize_tool_name
@@ -481,17 +482,17 @@ class AgentReasoning:
         """Get the system prompt for planning.
 
         Returns:
-            The system prompt, either custom or from i18n.
+            The system prompt, either custom or from I18N_DEFAULT.
         """
         if self.config.system_prompt is not None:
             return self.config.system_prompt
 
         # Try new "planning" section first, fall back to "reasoning" for compatibility
         try:
-            return self.agent.i18n.retrieve("planning", "system_prompt")
+            return I18N_DEFAULT.retrieve("planning", "system_prompt")
         except (KeyError, AttributeError):
             # Fallback to reasoning section for backward compatibility
-            return self.agent.i18n.retrieve("reasoning", "initial_plan").format(
+            return I18N_DEFAULT.retrieve("reasoning", "initial_plan").format(
                 role=self.agent.role,
                 goal=self.agent.goal,
                 backstory=self._get_agent_backstory(),
@@ -527,7 +528,7 @@ class AgentReasoning:
 
         # Try new "planning" section first
         try:
-            return self.agent.i18n.retrieve("planning", "create_plan_prompt").format(
+            return I18N_DEFAULT.retrieve("planning", "create_plan_prompt").format(
                 description=self.description,
                 expected_output=self.expected_output,
                 tools=available_tools,
@@ -535,7 +536,7 @@ class AgentReasoning:
             )
         except (KeyError, AttributeError):
             # Fallback to reasoning section for backward compatibility
-            return self.agent.i18n.retrieve("reasoning", "create_plan_prompt").format(
+            return I18N_DEFAULT.retrieve("reasoning", "create_plan_prompt").format(
                 role=self.agent.role,
                 goal=self.agent.goal,
                 backstory=self._get_agent_backstory(),
@@ -584,12 +585,12 @@ class AgentReasoning:
 
         # Try new "planning" section first
         try:
-            return self.agent.i18n.retrieve("planning", "refine_plan_prompt").format(
+            return I18N_DEFAULT.retrieve("planning", "refine_plan_prompt").format(
                 current_plan=current_plan,
             )
         except (KeyError, AttributeError):
             # Fallback to reasoning section for backward compatibility
-            return self.agent.i18n.retrieve("reasoning", "refine_plan_prompt").format(
+            return I18N_DEFAULT.retrieve("reasoning", "refine_plan_prompt").format(
                 role=self.agent.role,
                 goal=self.agent.goal,
                 backstory=self._get_agent_backstory(),
@@ -642,7 +643,7 @@ def _call_llm_with_reasoning_prompt(
     Returns:
         The LLM response.
     """
-    system_prompt = reasoning_agent.i18n.retrieve("reasoning", plan_type).format(
+    system_prompt = I18N_DEFAULT.retrieve("reasoning", plan_type).format(
         role=reasoning_agent.role,
         goal=reasoning_agent.goal,
         backstory=backstory,
diff --git a/lib/crewai/src/crewai/utilities/tool_utils.py b/lib/crewai/src/crewai/utilities/tool_utils.py
index b77eb9192..c7a469468 100644
--- a/lib/crewai/src/crewai/utilities/tool_utils.py
+++ b/lib/crewai/src/crewai/utilities/tool_utils.py
@@ -13,7 +13,7 @@ from crewai.security.fingerprint import Fingerprint
 from crewai.tools.structured_tool import CrewStructuredTool
 from crewai.tools.tool_types import ToolResult
 from crewai.tools.tool_usage import ToolUsage, ToolUsageError
-from crewai.utilities.i18n import I18N
+from crewai.utilities.i18n import I18N_DEFAULT
 from crewai.utilities.logger import Logger
 from crewai.utilities.string_utils import sanitize_tool_name
 
@@ -30,7 +30,6 @@ if TYPE_CHECKING:
 async def aexecute_tool_and_check_finality(
     agent_action: AgentAction,
     tools: list[CrewStructuredTool],
-    i18n: I18N,
     agent_key: str | None = None,
     agent_role: str | None = None,
     tools_handler: ToolsHandler | None = None,
@@ -49,7 +48,6 @@ async def aexecute_tool_and_check_finality(
     Args:
         agent_action: The action containing the tool to execute.
         tools: List of available tools.
-        i18n: Internationalization settings.
         agent_key: Optional key for event emission.
         agent_role: Optional role for event emission.
         tools_handler: Optional tools handler for tool execution.
@@ -142,7 +140,7 @@ async def aexecute_tool_and_check_finality(
 
         return ToolResult(modified_result, tool.result_as_answer)
 
-    tool_result = i18n.errors("wrong_tool_name").format(
+    tool_result = I18N_DEFAULT.errors("wrong_tool_name").format(
         tool=sanitized_tool_name,
         tools=", ".join(tool_name_to_tool_map.keys()),
     )
@@ -152,7 +150,6 @@ async def aexecute_tool_and_check_finality(
 def execute_tool_and_check_finality(
     agent_action: AgentAction,
     tools: list[CrewStructuredTool],
-    i18n: I18N,
     agent_key: str | None = None,
     agent_role: str | None = None,
     tools_handler: ToolsHandler | None = None,
@@ -170,7 +167,6 @@ def execute_tool_and_check_finality(
     Args:
         agent_action: The action containing the tool to execute
         tools: List of available tools
-        i18n: Internationalization settings
         agent_key: Optional key for event emission
         agent_role: Optional role for event emission
         tools_handler: Optional tools handler for tool execution
@@ -263,7 +259,7 @@ def execute_tool_and_check_finality(
 
         return ToolResult(modified_result, tool.result_as_answer)
 
-    tool_result = i18n.errors("wrong_tool_name").format(
+    tool_result = I18N_DEFAULT.errors("wrong_tool_name").format(
         tool=sanitized_tool_name,
         tools=", ".join(tool_name_to_tool_map.keys()),
     )
diff --git a/lib/crewai/tests/agents/test_agent.py b/lib/crewai/tests/agents/test_agent.py
index 7706f9ade..4681c8842 100644
--- a/lib/crewai/tests/agents/test_agent.py
+++ b/lib/crewai/tests/agents/test_agent.py
@@ -1208,12 +1208,10 @@ def test_llm_call_with_error():
 def test_handle_context_length_exceeds_limit():
     # Import necessary modules
     from crewai.utilities.agent_utils import handle_context_length
-    from crewai.utilities.i18n import I18N
     from crewai.utilities.printer import Printer
 
     # Create mocks for dependencies
     printer = Printer()
-    i18n = I18N()
 
     # Create an agent just for its LLM
     agent = Agent(
@@ -1249,7 +1247,6 @@ def test_handle_context_length_exceeds_limit():
                 messages=messages,
                 llm=llm,
                 callbacks=callbacks,
-                i18n=i18n,
             )
 
         # Verify our patch was called and raised the correct error
@@ -1994,7 +1991,7 @@ def test_litellm_anthropic_error_handling():
 @pytest.mark.vcr()
 def test_get_knowledge_search_query():
     """Test that _get_knowledge_search_query calls the LLM with the correct prompts."""
-    from crewai.utilities.i18n import I18N
+    from crewai.utilities.i18n import I18N_DEFAULT
 
     content = "The capital of France is Paris."
     string_source = StringKnowledgeSource(content=content)
@@ -2013,7 +2010,6 @@ def test_get_knowledge_search_query():
         agent=agent,
     )
 
-    i18n = I18N()
     task_prompt = task.prompt()
 
     with (
@@ -2050,13 +2046,13 @@ def test_get_knowledge_search_query():
             [
                 {
                     "role": "system",
-                    "content": i18n.slice(
+                    "content": I18N_DEFAULT.slice(
                         "knowledge_search_query_system_prompt"
                     ).format(task_prompt=task.description),
                 },
                 {
                     "role": "user",
-                    "content": i18n.slice("knowledge_search_query").format(
+                    "content": I18N_DEFAULT.slice("knowledge_search_query").format(
                         task_prompt=task_prompt
                     ),
                 },
diff --git a/lib/crewai/tests/agents/test_agent_executor.py b/lib/crewai/tests/agents/test_agent_executor.py
index 7a6260a44..3413e30ac 100644
--- a/lib/crewai/tests/agents/test_agent_executor.py
+++ b/lib/crewai/tests/agents/test_agent_executor.py
@@ -48,8 +48,6 @@ def _build_executor(**kwargs: Any) -> AgentExecutor:
     executor._last_context_error = None
     executor._step_executor = None
     executor._planner_observer = None
-    from crewai.utilities.i18n import get_i18n
-    executor._i18n = kwargs.get("i18n") or get_i18n()
     return executor
 from crewai.agents.planner_observer import PlannerObserver
 from crewai.experimental.agent_executor import (
diff --git a/lib/crewai/tests/tools/test_tool_usage.py b/lib/crewai/tests/tools/test_tool_usage.py
index ba2e797d9..c7754e6ac 100644
--- a/lib/crewai/tests/tools/test_tool_usage.py
+++ b/lib/crewai/tests/tools/test_tool_usage.py
@@ -308,7 +308,6 @@ def test_validate_tool_input_invalid_input():
     mock_agent.key = "test_agent_key"  # Must be a string
     mock_agent.role = "test_agent_role"  # Must be a string
     mock_agent._original_role = "test_agent_role"  # Must be a string
-    mock_agent.i18n = MagicMock()
     mock_agent.verbose = False
 
     # Create mock action with proper string value
@@ -443,7 +442,6 @@ def test_tool_selection_error_event_direct():
     mock_agent = MagicMock()
     mock_agent.key = "test_key"
     mock_agent.role = "test_role"
-    mock_agent.i18n = MagicMock()
     mock_agent.verbose = False
 
     mock_task = MagicMock()
@@ -518,13 +516,6 @@ def test_tool_validate_input_error_event():
     mock_agent.verbose = False
     mock_agent._original_role = "test_role"
 
-    # Mock i18n with error message
-    mock_i18n = MagicMock()
-    mock_i18n.errors.return_value = (
-        "Tool input must be a valid dictionary in JSON or Python literal format"
-    )
-    mock_agent.i18n = mock_i18n
-
     # Mock task and tools handler
     mock_task = MagicMock()
     mock_tools_handler = MagicMock()
@@ -590,7 +581,6 @@ def test_tool_usage_finished_event_with_result():
     mock_agent.key = "test_agent_key"
     mock_agent.role = "test_agent_role"
     mock_agent._original_role = "test_agent_role"
-    mock_agent.i18n = MagicMock()
     mock_agent.verbose = False
 
     # Create mock task
@@ -670,7 +660,6 @@ def test_tool_usage_finished_event_with_cached_result():
     mock_agent.key = "test_agent_key"
     mock_agent.role = "test_agent_role"
     mock_agent._original_role = "test_agent_role"
-    mock_agent.i18n = MagicMock()
     mock_agent.verbose = False
 
     # Create mock task
@@ -761,9 +750,6 @@ def test_tool_error_does_not_emit_finished_event():
     mock_agent._original_role = "test_agent_role"
     mock_agent.verbose = False
     mock_agent.fingerprint = None
-    mock_agent.i18n.tools.return_value = {"name": "Add Image"}
-    mock_agent.i18n.errors.return_value = "Error: {error}"
-    mock_agent.i18n.slice.return_value = "Available tools: {tool_names}"
 
     mock_task = MagicMock()
     mock_task.delegations = 0
diff --git a/lib/crewai/tests/utilities/test_agent_utils.py b/lib/crewai/tests/utilities/test_agent_utils.py
index 3d249906a..42de64fe6 100644
--- a/lib/crewai/tests/utilities/test_agent_utils.py
+++ b/lib/crewai/tests/utilities/test_agent_utils.py
@@ -225,16 +225,6 @@ class TestConvertToolsToOpenaiSchema:
         assert max_results_prop["default"] == 10
 
 
-def _make_mock_i18n() -> MagicMock:
-    """Create a mock i18n with the new structured prompt keys."""
-    mock_i18n = MagicMock()
-    mock_i18n.slice.side_effect = lambda key: {
-        "summarizer_system_message": "You are a precise assistant that creates structured summaries.",
-        "summarize_instruction": "Summarize the conversation:\n{conversation}",
-        "summary": "<summary>\n{merged_summary}\n</summary>\nContinue the task.",
-    }.get(key, "")
-    return mock_i18n
-
 class MCPStyleInput(BaseModel):
     """Input schema mimicking an MCP tool with optional fields."""
 
@@ -330,7 +320,7 @@ class TestSummarizeMessages:
             messages=messages,
             llm=mock_llm,
             callbacks=[],
-            i18n=_make_mock_i18n(),
+
         )
 
         # System message preserved + summary message = 2
@@ -361,7 +351,7 @@ class TestSummarizeMessages:
             messages=messages,
             llm=mock_llm,
             callbacks=[],
-            i18n=_make_mock_i18n(),
+
         )
 
         assert len(messages) == 1
@@ -387,7 +377,7 @@ class TestSummarizeMessages:
             messages=messages,
             llm=mock_llm,
             callbacks=[],
-            i18n=_make_mock_i18n(),
+
         )
 
         assert len(messages) == 1
@@ -410,7 +400,7 @@ class TestSummarizeMessages:
             messages=messages,
             llm=mock_llm,
             callbacks=[],
-            i18n=_make_mock_i18n(),
+
         )
 
         assert id(messages) == original_list_id
@@ -432,7 +422,7 @@ class TestSummarizeMessages:
             messages=messages,
             llm=mock_llm,
             callbacks=[],
-            i18n=_make_mock_i18n(),
+
         )
 
         assert len(messages) == 2
@@ -456,7 +446,7 @@ class TestSummarizeMessages:
             messages=messages,
             llm=mock_llm,
             callbacks=[],
-            i18n=_make_mock_i18n(),
+
         )
 
         # Check what was passed to llm.call
@@ -482,7 +472,7 @@ class TestSummarizeMessages:
             messages=messages,
             llm=mock_llm,
             callbacks=[],
-            i18n=_make_mock_i18n(),
+
         )
 
         assert "The extracted summary content." in messages[0]["content"]
@@ -506,7 +496,7 @@ class TestSummarizeMessages:
             messages=messages,
             llm=mock_llm,
             callbacks=[],
-            i18n=_make_mock_i18n(),
+
         )
 
         # Verify the conversation text sent to LLM contains tool labels
@@ -528,7 +518,7 @@ class TestSummarizeMessages:
             messages=messages,
             llm=mock_llm,
             callbacks=[],
-            i18n=_make_mock_i18n(),
+
         )
 
         # No LLM call should have been made
@@ -733,7 +723,7 @@ class TestParallelSummarization:
             messages=messages,
             llm=mock_llm,
             callbacks=[],
-            i18n=_make_mock_i18n(),
+
         )
 
         # acall should have been awaited once per chunk
@@ -757,7 +747,7 @@ class TestParallelSummarization:
             messages=messages,
             llm=mock_llm,
             callbacks=[],
-            i18n=_make_mock_i18n(),
+
         )
 
         mock_llm.call.assert_called_once()
@@ -788,7 +778,7 @@ class TestParallelSummarization:
             messages=messages,
             llm=mock_llm,
             callbacks=[],
-            i18n=_make_mock_i18n(),
+
         )
 
         # The final summary message should have A, B, C in order
@@ -816,7 +806,7 @@ class TestParallelSummarization:
                 chunks=[chunk_a, chunk_b],
                 llm=mock_llm,
                 callbacks=[],
-                i18n=_make_mock_i18n(),
+    
             )
         )
 
@@ -843,7 +833,7 @@ class TestParallelSummarization:
             messages=messages,
             llm=mock_llm,
             callbacks=[],
-            i18n=_make_mock_i18n(),
+
         )
 
         assert mock_llm.acall.await_count == 2
@@ -940,10 +930,8 @@ class TestParallelSummarizationVCR:
     def test_parallel_summarize_openai(self) -> None:
         """Test that parallel summarization with gpt-4o-mini produces a valid summary."""
         from crewai.llm import LLM
-        from crewai.utilities.i18n import I18N
 
         llm = LLM(model="gpt-4o-mini", temperature=0)
-        i18n = I18N()
         messages = _build_long_conversation()
 
         original_system = messages[0]["content"]
@@ -959,7 +947,6 @@ class TestParallelSummarizationVCR:
                 messages=messages,
                 llm=llm,
                 callbacks=[],
-                i18n=i18n,
             )
 
         # System message preserved
@@ -975,10 +962,8 @@ class TestParallelSummarizationVCR:
     def test_parallel_summarize_preserves_files(self) -> None:
         """Test that file references survive parallel summarization."""
         from crewai.llm import LLM
-        from crewai.utilities.i18n import I18N
 
         llm = LLM(model="gpt-4o-mini", temperature=0)
-        i18n = I18N()
         messages = _build_long_conversation()
 
         mock_file = MagicMock()
@@ -989,7 +974,6 @@ class TestParallelSummarizationVCR:
                 messages=messages,
                 llm=llm,
                 callbacks=[],
-                i18n=i18n,
             )
 
         summary_msg = messages[-1]
diff --git a/lib/crewai/tests/utilities/test_structured_planning.py b/lib/crewai/tests/utilities/test_structured_planning.py
index 91bca9c0d..b76d9af5c 100644
--- a/lib/crewai/tests/utilities/test_structured_planning.py
+++ b/lib/crewai/tests/utilities/test_structured_planning.py
@@ -147,8 +147,6 @@ class TestAgentReasoningWithMockedLLM:
         agent.backstory = "Test backstory"
         agent.verbose = False
         agent.planning_config = PlanningConfig()
-        agent.i18n = MagicMock()
-        agent.i18n.retrieve.return_value = "Test prompt: {description}"
         # Mock the llm attribute
         agent.llm = MagicMock()
         agent.llm.supports_function_calling.return_value = True
diff --git a/lib/crewai/tests/utilities/test_summarize_integration.py b/lib/crewai/tests/utilities/test_summarize_integration.py
index 5b3e39d07..a5da3a108 100644
--- a/lib/crewai/tests/utilities/test_summarize_integration.py
+++ b/lib/crewai/tests/utilities/test_summarize_integration.py
@@ -14,7 +14,6 @@ from crewai.crew import Crew
 from crewai.llm import LLM
 from crewai.task import Task
 from crewai.utilities.agent_utils import summarize_messages
-from crewai.utilities.i18n import I18N
 
 
 def _build_conversation_messages(
@@ -90,7 +89,7 @@ class TestSummarizeDirectOpenAI:
     def test_summarize_direct_openai(self) -> None:
         """Test summarize_messages with gpt-4o-mini preserves system messages."""
         llm = LLM(model="gpt-4o-mini", temperature=0)
-        i18n = I18N()
+
         messages = _build_conversation_messages(include_system=True)
 
         original_system_content = messages[0]["content"]
@@ -99,7 +98,7 @@ class TestSummarizeDirectOpenAI:
             messages=messages,
             llm=llm,
             callbacks=[],
-            i18n=i18n,
+
         )
 
         # System message should be preserved
@@ -122,14 +121,14 @@ class TestSummarizeDirectAnthropic:
     def test_summarize_direct_anthropic(self) -> None:
         """Test summarize_messages with claude-3-5-haiku."""
         llm = LLM(model="anthropic/claude-3-5-haiku-latest", temperature=0)
-        i18n = I18N()
+
         messages = _build_conversation_messages(include_system=True)
 
         summarize_messages(
             messages=messages,
             llm=llm,
             callbacks=[],
-            i18n=i18n,
+
         )
 
         assert len(messages) >= 2
@@ -148,14 +147,14 @@ class TestSummarizeDirectGemini:
     def test_summarize_direct_gemini(self) -> None:
         """Test summarize_messages with gemini-2.0-flash."""
         llm = LLM(model="gemini/gemini-2.0-flash", temperature=0)
-        i18n = I18N()
+
         messages = _build_conversation_messages(include_system=True)
 
         summarize_messages(
             messages=messages,
             llm=llm,
             callbacks=[],
-            i18n=i18n,
+
         )
 
         assert len(messages) >= 2
@@ -174,14 +173,14 @@ class TestSummarizeDirectAzure:
     def test_summarize_direct_azure(self) -> None:
         """Test summarize_messages with azure/gpt-4o-mini."""
         llm = LLM(model="azure/gpt-4o-mini", temperature=0)
-        i18n = I18N()
+
         messages = _build_conversation_messages(include_system=True)
 
         summarize_messages(
             messages=messages,
             llm=llm,
             callbacks=[],
-            i18n=i18n,
+
         )
 
         assert len(messages) >= 2
@@ -261,7 +260,7 @@ class TestSummarizePreservesFiles:
     def test_summarize_preserves_files_integration(self) -> None:
         """Test that file references survive a real summarization call."""
         llm = LLM(model="gpt-4o-mini", temperature=0)
-        i18n = I18N()
+
         messages = _build_conversation_messages(
             include_system=True, include_files=True
         )
@@ -270,7 +269,7 @@ class TestSummarizePreservesFiles:
             messages=messages,
             llm=llm,
             callbacks=[],
-            i18n=i18n,
+
         )
 
         # System message preserved

From 8cdde16ac8fe4bf0285d9f177192ea8ae61984b5 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 9 Apr 2026 05:17:31 +0800
Subject: [PATCH 15/70] fix: bump cryptography to 46.0.7 for CVE-2026-39892

---
 pyproject.toml |  4 ++-
 uv.lock        | 76 +++++++++++++++++++++++++-------------------------
 2 files changed, 41 insertions(+), 39 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 5894a9b2f..caf6c61c8 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -161,13 +161,14 @@ info = "Commits must follow Conventional Commits 1.0.0."
 
 
 [tool.uv]
-exclude-newer = "3 days"
+exclude-newer = "2026-04-10"  # pinned for CVE-2026-39892; restore to "3 days" after 2026-04-11
 
 # composio-core pins rich<14 but textual requires rich>=14.
 # onnxruntime 1.24+ dropped Python 3.10 wheels; cap it so qdrant[fastembed] resolves on 3.10.
 # fastembed 0.7.x and docling 2.63 cap pillow<12; the removed APIs don't affect them.
 # langchain-core <1.2.11 has SSRF via image_url token counting (CVE-2026-26013).
 # transformers 4.57.6 has CVE-2026-1839; force 5.4+ (docling 2.84 allows huggingface-hub>=1).
+# cryptography 46.0.6 has CVE-2026-39892; force 46.0.7+.
 override-dependencies = [
     "rich>=13.7.1",
     "onnxruntime<1.24; python_version < '3.11'",
@@ -175,6 +176,7 @@ override-dependencies = [
     "langchain-core>=1.2.11,<2",
     "urllib3>=2.6.3",
     "transformers>=5.4.0; python_version >= '3.10'",
+    "cryptography>=46.0.7",
 ]
 
 [tool.uv.workspace]
diff --git a/uv.lock b/uv.lock
index 5f637e156..1bfe4937e 100644
--- a/uv.lock
+++ b/uv.lock
@@ -13,8 +13,7 @@ resolution-markers = [
 ]
 
 [options]
-exclude-newer = "2026-04-05T11:09:48.9111Z"
-exclude-newer-span = "P3D"
+exclude-newer = "2026-04-10T16:00:00Z"
 
 [manifest]
 members = [
@@ -24,6 +23,7 @@ members = [
     "crewai-tools",
 ]
 overrides = [
+    { name = "cryptography", specifier = ">=46.0.7" },
     { name = "langchain-core", specifier = ">=1.2.11,<2" },
     { name = "onnxruntime", marker = "python_full_version < '3.11'", specifier = "<1.24" },
     { name = "pillow", specifier = ">=12.1.1" },
@@ -1583,48 +1583,48 @@ provides-extras = ["apify", "beautifulsoup4", "bedrock", "browserbase", "composi
 
 [[package]]
 name = "cryptography"
-version = "46.0.6"
+version = "46.0.7"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "cffi", marker = "platform_python_implementation != 'PyPy'" },
     { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/a4/ba/04b1bd4218cbc58dc90ce967106d51582371b898690f3ae0402876cc4f34/cryptography-46.0.6.tar.gz", hash = "sha256:27550628a518c5c6c903d84f637fbecf287f6cb9ced3804838a1295dc1fd0759", size = 750542, upload-time = "2026-03-25T23:34:53.396Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/47/93/ac8f3d5ff04d54bc814e961a43ae5b0b146154c89c61b47bb07557679b18/cryptography-46.0.7.tar.gz", hash = "sha256:e4cfd68c5f3e0bfdad0d38e023239b96a2fe84146481852dffbcca442c245aa5", size = 750652, upload-time = "2026-04-08T01:57:54.692Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/47/23/9285e15e3bc57325b0a72e592921983a701efc1ee8f91c06c5f0235d86d9/cryptography-46.0.6-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:64235194bad039a10bb6d2d930ab3323baaec67e2ce36215fd0952fad0930ca8", size = 7176401, upload-time = "2026-03-25T23:33:22.096Z" },
-    { url = "https://files.pythonhosted.org/packages/60/f8/e61f8f13950ab6195b31913b42d39f0f9afc7d93f76710f299b5ec286ae6/cryptography-46.0.6-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:26031f1e5ca62fcb9d1fcb34b2b60b390d1aacaa15dc8b895a9ed00968b97b30", size = 4275275, upload-time = "2026-03-25T23:33:23.844Z" },
-    { url = "https://files.pythonhosted.org/packages/19/69/732a736d12c2631e140be2348b4ad3d226302df63ef64d30dfdb8db7ad1c/cryptography-46.0.6-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:9a693028b9cbe51b5a1136232ee8f2bc242e4e19d456ded3fa7c86e43c713b4a", size = 4425320, upload-time = "2026-03-25T23:33:25.703Z" },
-    { url = "https://files.pythonhosted.org/packages/d4/12/123be7292674abf76b21ac1fc0e1af50661f0e5b8f0ec8285faac18eb99e/cryptography-46.0.6-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:67177e8a9f421aa2d3a170c3e56eca4e0128883cf52a071a7cbf53297f18b175", size = 4278082, upload-time = "2026-03-25T23:33:27.423Z" },
-    { url = "https://files.pythonhosted.org/packages/5b/ba/d5e27f8d68c24951b0a484924a84c7cdaed7502bac9f18601cd357f8b1d2/cryptography-46.0.6-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:d9528b535a6c4f8ff37847144b8986a9a143585f0540fbcb1a98115b543aa463", size = 4926514, upload-time = "2026-03-25T23:33:29.206Z" },
-    { url = "https://files.pythonhosted.org/packages/34/71/1ea5a7352ae516d5512d17babe7e1b87d9db5150b21f794b1377eac1edc0/cryptography-46.0.6-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:22259338084d6ae497a19bae5d4c66b7ca1387d3264d1c2c0e72d9e9b6a77b97", size = 4457766, upload-time = "2026-03-25T23:33:30.834Z" },
-    { url = "https://files.pythonhosted.org/packages/01/59/562be1e653accee4fdad92c7a2e88fced26b3fdfce144047519bbebc299e/cryptography-46.0.6-cp311-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:760997a4b950ff00d418398ad73fbc91aa2894b5c1db7ccb45b4f68b42a63b3c", size = 3986535, upload-time = "2026-03-25T23:33:33.02Z" },
-    { url = "https://files.pythonhosted.org/packages/d6/8b/b1ebfeb788bf4624d36e45ed2662b8bd43a05ff62157093c1539c1288a18/cryptography-46.0.6-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:3dfa6567f2e9e4c5dceb8ccb5a708158a2a871052fa75c8b78cb0977063f1507", size = 4277618, upload-time = "2026-03-25T23:33:34.567Z" },
-    { url = "https://files.pythonhosted.org/packages/dd/52/a005f8eabdb28df57c20f84c44d397a755782d6ff6d455f05baa2785bd91/cryptography-46.0.6-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:cdcd3edcbc5d55757e5f5f3d330dd00007ae463a7e7aa5bf132d1f22a4b62b19", size = 4890802, upload-time = "2026-03-25T23:33:37.034Z" },
-    { url = "https://files.pythonhosted.org/packages/ec/4d/8e7d7245c79c617d08724e2efa397737715ca0ec830ecb3c91e547302555/cryptography-46.0.6-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:d4e4aadb7fc1f88687f47ca20bb7227981b03afaae69287029da08096853b738", size = 4457425, upload-time = "2026-03-25T23:33:38.904Z" },
-    { url = "https://files.pythonhosted.org/packages/1d/5c/f6c3596a1430cec6f949085f0e1a970638d76f81c3ea56d93d564d04c340/cryptography-46.0.6-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:2b417edbe8877cda9022dde3a008e2deb50be9c407eef034aeeb3a8b11d9db3c", size = 4405530, upload-time = "2026-03-25T23:33:40.842Z" },
-    { url = "https://files.pythonhosted.org/packages/7e/c9/9f9cea13ee2dbde070424e0c4f621c091a91ffcc504ffea5e74f0e1daeff/cryptography-46.0.6-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:380343e0653b1c9d7e1f55b52aaa2dbb2fdf2730088d48c43ca1c7c0abb7cc2f", size = 4667896, upload-time = "2026-03-25T23:33:42.781Z" },
-    { url = "https://files.pythonhosted.org/packages/ad/b5/1895bc0821226f129bc74d00eccfc6a5969e2028f8617c09790bf89c185e/cryptography-46.0.6-cp311-abi3-win32.whl", hash = "sha256:bcb87663e1f7b075e48c3be3ecb5f0b46c8fc50b50a97cf264e7f60242dca3f2", size = 3026348, upload-time = "2026-03-25T23:33:45.021Z" },
-    { url = "https://files.pythonhosted.org/packages/c3/f8/c9bcbf0d3e6ad288b9d9aa0b1dee04b063d19e8c4f871855a03ab3a297ab/cryptography-46.0.6-cp311-abi3-win_amd64.whl", hash = "sha256:6739d56300662c468fddb0e5e291f9b4d084bead381667b9e654c7dd81705124", size = 3483896, upload-time = "2026-03-25T23:33:46.649Z" },
-    { url = "https://files.pythonhosted.org/packages/c4/cc/f330e982852403da79008552de9906804568ae9230da8432f7496ce02b71/cryptography-46.0.6-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:12cae594e9473bca1a7aceb90536060643128bb274fcea0fc459ab90f7d1ae7a", size = 7162776, upload-time = "2026-03-25T23:34:13.308Z" },
-    { url = "https://files.pythonhosted.org/packages/49/b3/dc27efd8dcc4bff583b3f01d4a3943cd8b5821777a58b3a6a5f054d61b79/cryptography-46.0.6-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:639301950939d844a9e1c4464d7e07f902fe9a7f6b215bb0d4f28584729935d8", size = 4270529, upload-time = "2026-03-25T23:34:15.019Z" },
-    { url = "https://files.pythonhosted.org/packages/e6/05/e8d0e6eb4f0d83365b3cb0e00eb3c484f7348db0266652ccd84632a3d58d/cryptography-46.0.6-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:ed3775295fb91f70b4027aeba878d79b3e55c0b3e97eaa4de71f8f23a9f2eb77", size = 4414827, upload-time = "2026-03-25T23:34:16.604Z" },
-    { url = "https://files.pythonhosted.org/packages/2f/97/daba0f5d2dc6d855e2dcb70733c812558a7977a55dd4a6722756628c44d1/cryptography-46.0.6-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:8927ccfbe967c7df312ade694f987e7e9e22b2425976ddbf28271d7e58845290", size = 4271265, upload-time = "2026-03-25T23:34:18.586Z" },
-    { url = "https://files.pythonhosted.org/packages/89/06/fe1fce39a37ac452e58d04b43b0855261dac320a2ebf8f5260dd55b201a9/cryptography-46.0.6-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:b12c6b1e1651e42ab5de8b1e00dc3b6354fdfd778e7fa60541ddacc27cd21410", size = 4916800, upload-time = "2026-03-25T23:34:20.561Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/8a/b14f3101fe9c3592603339eb5d94046c3ce5f7fc76d6512a2d40efd9724e/cryptography-46.0.6-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:063b67749f338ca9c5a0b7fe438a52c25f9526b851e24e6c9310e7195aad3b4d", size = 4448771, upload-time = "2026-03-25T23:34:22.406Z" },
-    { url = "https://files.pythonhosted.org/packages/01/b3/0796998056a66d1973fd52ee89dc1bb3b6581960a91ad4ac705f182d398f/cryptography-46.0.6-cp38-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:02fad249cb0e090b574e30b276a3da6a149e04ee2f049725b1f69e7b8351ec70", size = 3978333, upload-time = "2026-03-25T23:34:24.281Z" },
-    { url = "https://files.pythonhosted.org/packages/c5/3d/db200af5a4ffd08918cd55c08399dc6c9c50b0bc72c00a3246e099d3a849/cryptography-46.0.6-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:7e6142674f2a9291463e5e150090b95a8519b2fb6e6aaec8917dd8d094ce750d", size = 4271069, upload-time = "2026-03-25T23:34:25.895Z" },
-    { url = "https://files.pythonhosted.org/packages/d7/18/61acfd5b414309d74ee838be321c636fe71815436f53c9f0334bf19064fa/cryptography-46.0.6-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:456b3215172aeefb9284550b162801d62f5f264a081049a3e94307fe20792cfa", size = 4878358, upload-time = "2026-03-25T23:34:27.67Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/65/5bf43286d566f8171917cae23ac6add941654ccf085d739195a4eacf1674/cryptography-46.0.6-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:341359d6c9e68834e204ceaf25936dffeafea3829ab80e9503860dcc4f4dac58", size = 4448061, upload-time = "2026-03-25T23:34:29.375Z" },
-    { url = "https://files.pythonhosted.org/packages/e0/25/7e49c0fa7205cf3597e525d156a6bce5b5c9de1fd7e8cb01120e459f205a/cryptography-46.0.6-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:9a9c42a2723999a710445bc0d974e345c32adfd8d2fac6d8a251fa829ad31cfb", size = 4399103, upload-time = "2026-03-25T23:34:32.036Z" },
-    { url = "https://files.pythonhosted.org/packages/44/46/466269e833f1c4718d6cd496ffe20c56c9c8d013486ff66b4f69c302a68d/cryptography-46.0.6-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:6617f67b1606dfd9fe4dbfa354a9508d4a6d37afe30306fe6c101b7ce3274b72", size = 4659255, upload-time = "2026-03-25T23:34:33.679Z" },
-    { url = "https://files.pythonhosted.org/packages/0a/09/ddc5f630cc32287d2c953fc5d32705e63ec73e37308e5120955316f53827/cryptography-46.0.6-cp38-abi3-win32.whl", hash = "sha256:7f6690b6c55e9c5332c0b59b9c8a3fb232ebf059094c17f9019a51e9827df91c", size = 3010660, upload-time = "2026-03-25T23:34:35.418Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/82/ca4893968aeb2709aacfb57a30dec6fa2ab25b10fa9f064b8882ce33f599/cryptography-46.0.6-cp38-abi3-win_amd64.whl", hash = "sha256:79e865c642cfc5c0b3eb12af83c35c5aeff4fa5c672dc28c43721c2c9fdd2f0f", size = 3471160, upload-time = "2026-03-25T23:34:37.191Z" },
-    { url = "https://files.pythonhosted.org/packages/2e/84/7ccff00ced5bac74b775ce0beb7d1be4e8637536b522b5df9b73ada42da2/cryptography-46.0.6-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:2ea0f37e9a9cf0df2952893ad145fd9627d326a59daec9b0802480fa3bcd2ead", size = 3475444, upload-time = "2026-03-25T23:34:38.944Z" },
-    { url = "https://files.pythonhosted.org/packages/bc/1f/4c926f50df7749f000f20eede0c896769509895e2648db5da0ed55db711d/cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:a3e84d5ec9ba01f8fd03802b2147ba77f0c8f2617b2aff254cedd551844209c8", size = 4218227, upload-time = "2026-03-25T23:34:40.871Z" },
-    { url = "https://files.pythonhosted.org/packages/c6/65/707be3ffbd5f786028665c3223e86e11c4cda86023adbc56bd72b1b6bab5/cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:12f0fa16cc247b13c43d56d7b35287ff1569b5b1f4c5e87e92cc4fcc00cd10c0", size = 4381399, upload-time = "2026-03-25T23:34:42.609Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/6d/73557ed0ef7d73d04d9aba745d2c8e95218213687ee5e76b7d236a5030fc/cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_34_aarch64.whl", hash = "sha256:50575a76e2951fe7dbd1f56d181f8c5ceeeb075e9ff88e7ad997d2f42af06e7b", size = 4217595, upload-time = "2026-03-25T23:34:44.205Z" },
-    { url = "https://files.pythonhosted.org/packages/9e/c5/e1594c4eec66a567c3ac4400008108a415808be2ce13dcb9a9045c92f1a0/cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_34_x86_64.whl", hash = "sha256:90e5f0a7b3be5f40c3a0a0eafb32c681d8d2c181fc2a1bdabe9b3f611d9f6b1a", size = 4380912, upload-time = "2026-03-25T23:34:46.328Z" },
-    { url = "https://files.pythonhosted.org/packages/1a/89/843b53614b47f97fe1abc13f9a86efa5ec9e275292c457af1d4a60dc80e0/cryptography-46.0.6-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:6728c49e3b2c180ef26f8e9f0a883a2c585638db64cf265b49c9ba10652d430e", size = 3409955, upload-time = "2026-03-25T23:34:48.465Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/5d/4a8f770695d73be252331e60e526291e3df0c9b27556a90a6b47bccca4c2/cryptography-46.0.7-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:ea42cbe97209df307fdc3b155f1b6fa2577c0defa8f1f7d3be7d31d189108ad4", size = 7179869, upload-time = "2026-04-08T01:56:17.157Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/45/6d80dc379b0bbc1f9d1e429f42e4cb9e1d319c7a8201beffd967c516ea01/cryptography-46.0.7-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:b36a4695e29fe69215d75960b22577197aca3f7a25b9cf9d165dcfe9d80bc325", size = 4275492, upload-time = "2026-04-08T01:56:19.36Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/9a/1765afe9f572e239c3469f2cb429f3ba7b31878c893b246b4b2994ffe2fe/cryptography-46.0.7-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:5ad9ef796328c5e3c4ceed237a183f5d41d21150f972455a9d926593a1dcb308", size = 4426670, upload-time = "2026-04-08T01:56:21.415Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/3e/af9246aaf23cd4ee060699adab1e47ced3f5f7e7a8ffdd339f817b446462/cryptography-46.0.7-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:73510b83623e080a2c35c62c15298096e2a5dc8d51c3b4e1740211839d0dea77", size = 4280275, upload-time = "2026-04-08T01:56:23.539Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/54/6bbbfc5efe86f9d71041827b793c24811a017c6ac0fd12883e4caa86b8ed/cryptography-46.0.7-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:cbd5fb06b62bd0721e1170273d3f4d5a277044c47ca27ee257025146c34cbdd1", size = 4928402, upload-time = "2026-04-08T01:56:25.624Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/cf/054b9d8220f81509939599c8bdbc0c408dbd2bdd41688616a20731371fe0/cryptography-46.0.7-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:420b1e4109cc95f0e5700eed79908cef9268265c773d3a66f7af1eef53d409ef", size = 4459985, upload-time = "2026-04-08T01:56:27.309Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/46/4e4e9c6040fb01c7467d47217d2f882daddeb8828f7df800cb806d8a2288/cryptography-46.0.7-cp311-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:24402210aa54baae71d99441d15bb5a1919c195398a87b563df84468160a65de", size = 3990652, upload-time = "2026-04-08T01:56:29.095Z" },
+    { url = "https://files.pythonhosted.org/packages/36/5f/313586c3be5a2fbe87e4c9a254207b860155a8e1f3cca99f9910008e7d08/cryptography-46.0.7-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:8a469028a86f12eb7d2fe97162d0634026d92a21f3ae0ac87ed1c4a447886c83", size = 4279805, upload-time = "2026-04-08T01:56:30.928Z" },
+    { url = "https://files.pythonhosted.org/packages/69/33/60dfc4595f334a2082749673386a4d05e4f0cf4df8248e63b2c3437585f2/cryptography-46.0.7-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:9694078c5d44c157ef3162e3bf3946510b857df5a3955458381d1c7cfc143ddb", size = 4892883, upload-time = "2026-04-08T01:56:32.614Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/0b/333ddab4270c4f5b972f980adef4faa66951a4aaf646ca067af597f15563/cryptography-46.0.7-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:42a1e5f98abb6391717978baf9f90dc28a743b7d9be7f0751a6f56a75d14065b", size = 4459756, upload-time = "2026-04-08T01:56:34.306Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/14/633913398b43b75f1234834170947957c6b623d1701ffc7a9600da907e89/cryptography-46.0.7-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:91bbcb08347344f810cbe49065914fe048949648f6bd5c2519f34619142bbe85", size = 4410244, upload-time = "2026-04-08T01:56:35.977Z" },
+    { url = "https://files.pythonhosted.org/packages/10/f2/19ceb3b3dc14009373432af0c13f46aa08e3ce334ec6eff13492e1812ccd/cryptography-46.0.7-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:5d1c02a14ceb9148cc7816249f64f623fbfee39e8c03b3650d842ad3f34d637e", size = 4674868, upload-time = "2026-04-08T01:56:38.034Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/bb/a5c213c19ee94b15dfccc48f363738633a493812687f5567addbcbba9f6f/cryptography-46.0.7-cp311-abi3-win32.whl", hash = "sha256:d23c8ca48e44ee015cd0a54aeccdf9f09004eba9fc96f38c911011d9ff1bd457", size = 3026504, upload-time = "2026-04-08T01:56:39.666Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/02/7788f9fefa1d060ca68717c3901ae7fffa21ee087a90b7f23c7a603c32ae/cryptography-46.0.7-cp311-abi3-win_amd64.whl", hash = "sha256:397655da831414d165029da9bc483bed2fe0e75dde6a1523ec2fe63f3c46046b", size = 3488363, upload-time = "2026-04-08T01:56:41.893Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/7f/cd42fc3614386bc0c12f0cb3c4ae1fc2bbca5c9662dfed031514911d513d/cryptography-46.0.7-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:462ad5cb1c148a22b2e3bcc5ad52504dff325d17daf5df8d88c17dda1f75f2a4", size = 7165618, upload-time = "2026-04-08T01:57:10.645Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/d0/36a49f0262d2319139d2829f773f1b97ef8aef7f97e6e5bd21455e5a8fb5/cryptography-46.0.7-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:84d4cced91f0f159a7ddacad249cc077e63195c36aac40b4150e7a57e84fffe7", size = 4270628, upload-time = "2026-04-08T01:57:12.885Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/6c/1a42450f464dda6ffbe578a911f773e54dd48c10f9895a23a7e88b3e7db5/cryptography-46.0.7-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:128c5edfe5e5938b86b03941e94fac9ee793a94452ad1365c9fc3f4f62216832", size = 4415405, upload-time = "2026-04-08T01:57:14.923Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/92/4ed714dbe93a066dc1f4b4581a464d2d7dbec9046f7c8b7016f5286329e2/cryptography-46.0.7-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:5e51be372b26ef4ba3de3c167cd3d1022934bc838ae9eaad7e644986d2a3d163", size = 4272715, upload-time = "2026-04-08T01:57:16.638Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/e6/a26b84096eddd51494bba19111f8fffe976f6a09f132706f8f1bf03f51f7/cryptography-46.0.7-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:cdf1a610ef82abb396451862739e3fc93b071c844399e15b90726ef7470eeaf2", size = 4918400, upload-time = "2026-04-08T01:57:19.021Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/08/ffd537b605568a148543ac3c2b239708ae0bd635064bab41359252ef88ed/cryptography-46.0.7-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:1d25aee46d0c6f1a501adcddb2d2fee4b979381346a78558ed13e50aa8a59067", size = 4450634, upload-time = "2026-04-08T01:57:21.185Z" },
+    { url = "https://files.pythonhosted.org/packages/16/01/0cd51dd86ab5b9befe0d031e276510491976c3a80e9f6e31810cce46c4ad/cryptography-46.0.7-cp38-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:cdfbe22376065ffcf8be74dc9a909f032df19bc58a699456a21712d6e5eabfd0", size = 3985233, upload-time = "2026-04-08T01:57:22.862Z" },
+    { url = "https://files.pythonhosted.org/packages/92/49/819d6ed3a7d9349c2939f81b500a738cb733ab62fbecdbc1e38e83d45e12/cryptography-46.0.7-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:abad9dac36cbf55de6eb49badd4016806b3165d396f64925bf2999bcb67837ba", size = 4271955, upload-time = "2026-04-08T01:57:24.814Z" },
+    { url = "https://files.pythonhosted.org/packages/80/07/ad9b3c56ebb95ed2473d46df0847357e01583f4c52a85754d1a55e29e4d0/cryptography-46.0.7-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:935ce7e3cfdb53e3536119a542b839bb94ec1ad081013e9ab9b7cfd478b05006", size = 4879888, upload-time = "2026-04-08T01:57:26.88Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/c7/201d3d58f30c4c2bdbe9b03844c291feb77c20511cc3586daf7edc12a47b/cryptography-46.0.7-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:35719dc79d4730d30f1c2b6474bd6acda36ae2dfae1e3c16f2051f215df33ce0", size = 4449961, upload-time = "2026-04-08T01:57:29.068Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/ef/649750cbf96f3033c3c976e112265c33906f8e462291a33d77f90356548c/cryptography-46.0.7-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:7bbc6ccf49d05ac8f7d7b5e2e2c33830d4fe2061def88210a126d130d7f71a85", size = 4401696, upload-time = "2026-04-08T01:57:31.029Z" },
+    { url = "https://files.pythonhosted.org/packages/41/52/a8908dcb1a389a459a29008c29966c1d552588d4ae6d43f3a1a4512e0ebe/cryptography-46.0.7-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:a1529d614f44b863a7b480c6d000fe93b59acee9c82ffa027cfadc77521a9f5e", size = 4664256, upload-time = "2026-04-08T01:57:33.144Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/fa/f0ab06238e899cc3fb332623f337a7364f36f4bb3f2534c2bb95a35b132c/cryptography-46.0.7-cp38-abi3-win32.whl", hash = "sha256:f247c8c1a1fb45e12586afbb436ef21ff1e80670b2861a90353d9b025583d246", size = 3013001, upload-time = "2026-04-08T01:57:34.933Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/f1/00ce3bde3ca542d1acd8f8cfa38e446840945aa6363f9b74746394b14127/cryptography-46.0.7-cp38-abi3-win_amd64.whl", hash = "sha256:506c4ff91eff4f82bdac7633318a526b1d1309fc07ca76a3ad182cb5b686d6d3", size = 3472985, upload-time = "2026-04-08T01:57:36.714Z" },
+    { url = "https://files.pythonhosted.org/packages/63/0c/dca8abb64e7ca4f6b2978769f6fea5ad06686a190cec381f0a796fdcaaba/cryptography-46.0.7-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:fc9ab8856ae6cf7c9358430e49b368f3108f050031442eaeb6b9d87e4dcf4e4f", size = 3476879, upload-time = "2026-04-08T01:57:38.664Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/ea/075aac6a84b7c271578d81a2f9968acb6e273002408729f2ddff517fed4a/cryptography-46.0.7-pp311-pypy311_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:d3b99c535a9de0adced13d159c5a9cf65c325601aa30f4be08afd680643e9c15", size = 4219700, upload-time = "2026-04-08T01:57:40.625Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/7b/1c55db7242b5e5612b29fc7a630e91ee7a6e3c8e7bf5406d22e206875fbd/cryptography-46.0.7-pp311-pypy311_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:d02c738dacda7dc2a74d1b2b3177042009d5cab7c7079db74afc19e56ca1b455", size = 4385982, upload-time = "2026-04-08T01:57:42.725Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/da/9870eec4b69c63ef5925bf7d8342b7e13bc2ee3d47791461c4e49ca212f4/cryptography-46.0.7-pp311-pypy311_pp73-manylinux_2_34_aarch64.whl", hash = "sha256:04959522f938493042d595a736e7dbdff6eb6cc2339c11465b3ff89343b65f65", size = 4219115, upload-time = "2026-04-08T01:57:44.939Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/72/05aa5832b82dd341969e9a734d1812a6aadb088d9eb6f0430fc337cc5a8f/cryptography-46.0.7-pp311-pypy311_pp73-manylinux_2_34_x86_64.whl", hash = "sha256:3986ac1dee6def53797289999eabe84798ad7817f3e97779b5061a95b0ee4968", size = 4385479, upload-time = "2026-04-08T01:57:46.86Z" },
+    { url = "https://files.pythonhosted.org/packages/20/2a/1b016902351a523aa2bd446b50a5bc1175d7a7d1cf90fe2ef904f9b84ebc/cryptography-46.0.7-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:258514877e15963bd43b558917bc9f54cf7cf866c38aa576ebf47a77ddbc43a4", size = 3412829, upload-time = "2026-04-08T01:57:48.874Z" },
 ]
 
 [[package]]

From 9ab67552a798323c881e6df40bd8aa47fb77cfc8 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 9 Apr 2026 05:31:31 +0800
Subject: [PATCH 16/70] fix: emit flow_finished event after HITL resume

resume_async() was missing trace infrastructure that kickoff_async()
sets up, causing flow_finished to never reach the platform after HITL
feedback. Add FlowStartedEvent emission to initialize the trace batch,
await event futures, finalize the trace batch, and guard with
suppress_flow_events.
---
 lib/crewai/src/crewai/flow/flow.py | 62 +++++++++++++++++++++++++-----
 1 file changed, 52 insertions(+), 10 deletions(-)

diff --git a/lib/crewai/src/crewai/flow/flow.py b/lib/crewai/src/crewai/flow/flow.py
index 16cc88db2..a057da581 100644
--- a/lib/crewai/src/crewai/flow/flow.py
+++ b/lib/crewai/src/crewai/flow/flow.py
@@ -1455,6 +1455,25 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
                 "No pending feedback context. Use from_pending() to restore a paused flow."
             )
 
+        if get_current_parent_id() is None:
+            reset_emission_counter()
+            reset_last_event_id()
+
+        if not self.suppress_flow_events:
+            future = crewai_event_bus.emit(
+                self,
+                FlowStartedEvent(
+                    type="flow_started",
+                    flow_name=self.name or self.__class__.__name__,
+                    inputs=None,
+                ),
+            )
+            if future and isinstance(future, Future):
+                try:
+                    await asyncio.wrap_future(future)
+                except Exception:
+                    logger.warning("FlowStartedEvent handler failed", exc_info=True)
+
         context = self._pending_feedback_context
         emit = context.emit
         default_outcome = context.default_outcome
@@ -1594,16 +1613,39 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
 
         final_result = self._method_outputs[-1] if self._method_outputs else result
 
-        # Emit flow finished
-        crewai_event_bus.emit(
-            self,
-            FlowFinishedEvent(
-                type="flow_finished",
-                flow_name=self.name or self.__class__.__name__,
-                result=final_result,
-                state=self._state,
-            ),
-        )
+        if self._event_futures:
+            await asyncio.gather(
+                *[
+                    asyncio.wrap_future(f)
+                    for f in self._event_futures
+                    if isinstance(f, Future)
+                ]
+            )
+            self._event_futures.clear()
+
+        if not self.suppress_flow_events:
+            future = crewai_event_bus.emit(
+                self,
+                FlowFinishedEvent(
+                    type="flow_finished",
+                    flow_name=self.name or self.__class__.__name__,
+                    result=final_result,
+                    state=self._copy_and_serialize_state(),
+                ),
+            )
+            if future and isinstance(future, Future):
+                try:
+                    await asyncio.wrap_future(future)
+                except Exception:
+                    logger.warning("FlowFinishedEvent handler failed", exc_info=True)
+
+            trace_listener = TraceCollectionListener()
+            if trace_listener.batch_manager.batch_owner_type == "flow":
+                if trace_listener.first_time_handler.is_first_time:
+                    trace_listener.first_time_handler.mark_events_collected()
+                    trace_listener.first_time_handler.handle_execution_completion()
+                else:
+                    trace_listener.batch_manager.finalize_batch()
 
         return final_result
 

From 3b52b1a80022e6a0c3a76dbf770829ff30e50e87 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 9 Apr 2026 07:21:39 +0800
Subject: [PATCH 17/70] feat: bump versions to 1.14.2a1

---
 lib/crewai-files/src/crewai_files/__init__.py           | 2 +-
 lib/crewai-tools/pyproject.toml                         | 2 +-
 lib/crewai-tools/src/crewai_tools/__init__.py           | 2 +-
 lib/crewai/pyproject.toml                               | 2 +-
 lib/crewai/src/crewai/__init__.py                       | 2 +-
 lib/crewai/src/crewai/cli/templates/crew/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/flow/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/tool/pyproject.toml | 2 +-
 lib/devtools/src/crewai_devtools/__init__.py            | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/lib/crewai-files/src/crewai_files/__init__.py b/lib/crewai-files/src/crewai_files/__init__.py
index ae22cac91..a5372d385 100644
--- a/lib/crewai-files/src/crewai_files/__init__.py
+++ b/lib/crewai-files/src/crewai_files/__init__.py
@@ -152,4 +152,4 @@ __all__ = [
     "wrap_file_source",
 ]
 
-__version__ = "1.14.1"
+__version__ = "1.14.2a1"
diff --git a/lib/crewai-tools/pyproject.toml b/lib/crewai-tools/pyproject.toml
index 6d9d54dca..65c4fb112 100644
--- a/lib/crewai-tools/pyproject.toml
+++ b/lib/crewai-tools/pyproject.toml
@@ -10,7 +10,7 @@ requires-python = ">=3.10, <3.14"
 dependencies = [
     "pytube~=15.0.0",
     "requests~=2.32.5",
-    "crewai==1.14.1",
+    "crewai==1.14.2a1",
     "tiktoken~=0.8.0",
     "beautifulsoup4~=4.13.4",
     "python-docx~=1.2.0",
diff --git a/lib/crewai-tools/src/crewai_tools/__init__.py b/lib/crewai-tools/src/crewai_tools/__init__.py
index e8719da6a..2fd505221 100644
--- a/lib/crewai-tools/src/crewai_tools/__init__.py
+++ b/lib/crewai-tools/src/crewai_tools/__init__.py
@@ -305,4 +305,4 @@ __all__ = [
     "ZapierActionTools",
 ]
 
-__version__ = "1.14.1"
+__version__ = "1.14.2a1"
diff --git a/lib/crewai/pyproject.toml b/lib/crewai/pyproject.toml
index 96fa9b511..fbe2bae52 100644
--- a/lib/crewai/pyproject.toml
+++ b/lib/crewai/pyproject.toml
@@ -55,7 +55,7 @@ Repository = "https://github.com/crewAIInc/crewAI"
 
 [project.optional-dependencies]
 tools = [
-    "crewai-tools==1.14.1",
+    "crewai-tools==1.14.2a1",
 ]
 embeddings = [
     "tiktoken~=0.8.0"
diff --git a/lib/crewai/src/crewai/__init__.py b/lib/crewai/src/crewai/__init__.py
index 9d5ffb5f2..c5b941468 100644
--- a/lib/crewai/src/crewai/__init__.py
+++ b/lib/crewai/src/crewai/__init__.py
@@ -46,7 +46,7 @@ def _suppress_pydantic_deprecation_warnings() -> None:
 
 _suppress_pydantic_deprecation_warnings()
 
-__version__ = "1.14.1"
+__version__ = "1.14.2a1"
 _telemetry_submitted = False
 
 
diff --git a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
index 9c137bd2e..789088440 100644
--- a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.1"
+    "crewai[tools]==1.14.2a1"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
index 0fbb2d52c..cdd22700f 100644
--- a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.1"
+    "crewai[tools]==1.14.2a1"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
index 6ded8a798..8e1cb7c6e 100644
--- a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
@@ -5,7 +5,7 @@ description = "Power up your crews with {{folder_name}}"
 readme = "README.md"
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.1"
+    "crewai[tools]==1.14.2a1"
 ]
 
 [tool.crewai]
diff --git a/lib/devtools/src/crewai_devtools/__init__.py b/lib/devtools/src/crewai_devtools/__init__.py
index f82569e9a..36dec0c9d 100644
--- a/lib/devtools/src/crewai_devtools/__init__.py
+++ b/lib/devtools/src/crewai_devtools/__init__.py
@@ -1,3 +1,3 @@
 """CrewAI development tools."""
 
-__version__ = "1.14.1"
+__version__ = "1.14.2a1"

From 06fe1636111b28300064bf6f2add94456081d996 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 9 Apr 2026 07:26:22 +0800
Subject: [PATCH 18/70] docs: update changelog and version for v1.14.2a1

---
 docs/ar/changelog.mdx    | 23 +++++++++++++++++++++++
 docs/en/changelog.mdx    | 23 +++++++++++++++++++++++
 docs/ko/changelog.mdx    | 23 +++++++++++++++++++++++
 docs/pt-BR/changelog.mdx | 23 +++++++++++++++++++++++
 4 files changed, 92 insertions(+)

diff --git a/docs/ar/changelog.mdx b/docs/ar/changelog.mdx
index f8997da03..177ac6142 100644
--- a/docs/ar/changelog.mdx
+++ b/docs/ar/changelog.mdx
@@ -4,6 +4,29 @@ description: "تحديثات المنتج والتحسينات وإصلاحات
 icon: "clock"
 mode: "wide"
 ---
+<Update label="9 أبريل 2026">
+  ## v1.14.2a1
+
+  [عرض الإصدار على GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a1)
+
+  ## ما الذي تغير
+
+  ### إصلاحات الأخطاء
+  - إصلاح إصدار حدث flow_finished بعد استئناف HITL
+  - إصلاح إصدار التشفير إلى 46.0.7 لمعالجة CVE-2026-39892
+
+  ### إعادة هيكلة
+  - إعادة هيكلة لاستخدام I18N_DEFAULT المشترك
+
+  ### الوثائق
+  - تحديث سجل التغييرات والإصدار لـ v1.14.1
+
+  ## المساهمون
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="9 أبريل 2026">
   ## v1.14.1
 
diff --git a/docs/en/changelog.mdx b/docs/en/changelog.mdx
index 13c737e4b..b7a9b2645 100644
--- a/docs/en/changelog.mdx
+++ b/docs/en/changelog.mdx
@@ -4,6 +4,29 @@ description: "Product updates, improvements, and bug fixes for CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="Apr 09, 2026">
+  ## v1.14.2a1
+
+  [View release on GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a1)
+
+  ## What's Changed
+
+  ### Bug Fixes
+  - Fix emission of flow_finished event after HITL resume
+  - Fix cryptography version to 46.0.7 to address CVE-2026-39892
+
+  ### Refactoring
+  - Refactor to use shared I18N_DEFAULT singleton
+
+  ### Documentation
+  - Update changelog and version for v1.14.1
+
+  ## Contributors
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="Apr 09, 2026">
   ## v1.14.1
 
diff --git a/docs/ko/changelog.mdx b/docs/ko/changelog.mdx
index 1a25fbdf4..f4e3ca546 100644
--- a/docs/ko/changelog.mdx
+++ b/docs/ko/changelog.mdx
@@ -4,6 +4,29 @@ description: "CrewAI의 제품 업데이트, 개선 사항 및 버그 수정"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="2026년 4월 9일">
+  ## v1.14.2a1
+
+  [GitHub 릴리스 보기](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a1)
+
+  ## 변경 사항
+
+  ### 버그 수정
+  - HITL 재개 후 flow_finished 이벤트 방출 수정
+  - CVE-2026-39892 문제를 해결하기 위해 암호화 버전을 46.0.7로 수정
+
+  ### 리팩토링
+  - 공유 I18N_DEFAULT 싱글톤을 사용하도록 리팩토링
+
+  ### 문서
+  - v1.14.1에 대한 변경 로그 및 버전 업데이트
+
+  ## 기여자
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="2026년 4월 9일">
   ## v1.14.1
 
diff --git a/docs/pt-BR/changelog.mdx b/docs/pt-BR/changelog.mdx
index b7c5a23f0..45cc9943f 100644
--- a/docs/pt-BR/changelog.mdx
+++ b/docs/pt-BR/changelog.mdx
@@ -4,6 +4,29 @@ description: "Atualizações de produto, melhorias e correções do CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="09 abr 2026">
+  ## v1.14.2a1
+
+  [Ver release no GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a1)
+
+  ## O que Mudou
+
+  ### Correções de Bugs
+  - Corrigir a emissão do evento flow_finished após a retomada do HITL
+  - Corrigir a versão da criptografia para 46.0.7 para resolver o CVE-2026-39892
+
+  ### Refatoração
+  - Refatorar para usar o singleton I18N_DEFAULT compartilhado
+
+  ### Documentação
+  - Atualizar o changelog e a versão para v1.14.1
+
+  ## Contribuidores
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="09 abr 2026">
   ## v1.14.1
 

From ce56472fc3bd2fede0a18d8a562461a3c423d0d4 Mon Sep 17 00:00:00 2001
From: alex-clawd <alex@crewai.com>
Date: Wed, 8 Apr 2026 23:21:38 -0700
Subject: [PATCH 19/70] =?UTF-8?q?fix:=20harden=20NL2SQLTool=20=E2=80=94=20?=
 =?UTF-8?q?read-only=20default,=20query=20validation,=20parameterized=20qu?=
 =?UTF-8?q?eries=20(#5311)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* fix: harden NL2SQLTool — read-only by default, parameterized queries, query validation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix: address CI lint failures and remove unused import

- Remove unused `sessionmaker` import from test_nl2sql_security.py
- Use `Self` return type on `_apply_env_override` (fixes UP037/F821)
- Fix ruff errors auto-fixed in lib/crewai (UP007, etc.)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix: expand _WRITE_COMMANDS and block multi-statement semicolon injection

- Add missing write commands: UPSERT, LOAD, COPY, VACUUM, ANALYZE,
  ANALYSE, REINDEX, CLUSTER, REFRESH, COMMENT, SET, RESET
- _validate_query() now splits on ';' and validates each statement
  independently; multi-statement queries are rejected outright in
  read-only mode to prevent 'SELECT 1; DROP TABLE users' bypass
- Extract single-statement logic into _validate_statement() helper
- Add TestSemicolonInjection and TestExtendedWriteCommands test classes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* ci: retrigger

* fix: use typing_extensions.Self for Python 3.10 compat

* chore: update tool specifications

* docs: document NL2SQLTool read-only default and DML configuration

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix: close three NL2SQLTool security gaps (writable CTEs, EXPLAIN ANALYZE, multi-stmt commit)

- Remove WITH from _READ_ONLY_COMMANDS; scan CTE body for write keywords so
  writable CTEs like `WITH d AS (DELETE …) SELECT …` are blocked in read-only mode.
- EXPLAIN ANALYZE/ANALYSE now resolves the underlying command; EXPLAIN ANALYZE DELETE
  is treated as a write and blocked in read-only mode.
- execute_sql commit decision now checks ALL semicolon-separated statements so
  a SELECT-first batch like `SELECT 1; DROP TABLE t` still triggers a commit
  when allow_dml=True.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix: handle parenthesized EXPLAIN options syntax; remove unused _seed_db

_validate_statement now strips parenthesized options from EXPLAIN (e.g.
EXPLAIN (ANALYZE) DELETE, EXPLAIN (ANALYZE, VERBOSE) DELETE) before
checking whether ANALYZE/ANALYSE is present — closing the bypass where
the options-list form was silently allowed in read-only mode.

Adds three new tests:
  - EXPLAIN (ANALYZE) DELETE  → blocked
  - EXPLAIN (ANALYZE, VERBOSE) DELETE  → blocked
  - EXPLAIN (VERBOSE) SELECT  → allowed

Also removes the unused _seed_db helper from test_nl2sql_security.py.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* chore: update tool specifications

* fix: smarter CTE write detection, fix commit logic for writable CTEs

- Replace naive token-set matching with positional AS() body inspection
  to avoid false positives on column names like 'comment', 'set', 'reset'
- Fix execute_sql commit logic to detect writable CTEs (WITH + DELETE/INSERT)
  not just top-level write commands
- Add tests for false positive cases and writable CTE commit behavior
- Format nl2sql_tool.py to pass ruff format check

* fix: catch write commands in CTE main query + handle whitespace in AS()

- WITH cte AS (SELECT 1) DELETE FROM users now correctly blocked
- AS followed by newline/tab/multi-space before ( now detected
- execute_sql commit logic updated for both cases
- 4 new tests

* fix: EXPLAIN ANALYZE VERBOSE handling, string literal paren bypass, commit logic for EXPLAIN ANALYZE

- EXPLAIN handler now consumes all known options (ANALYZE, ANALYSE, VERBOSE) before
  extracting the real command, fixing 'EXPLAIN ANALYZE VERBOSE SELECT' being blocked
- Paren walker in _extract_main_query_after_cte now skips string literals, preventing
  'WITH cte AS (SELECT '\''('\'' FROM t) DELETE FROM users' from bypassing detection
- _is_write_stmt in execute_sql now resolves EXPLAIN ANALYZE to underlying command
  via _resolve_explain_command, ensuring session.commit() fires for write operations
- 10 new tests covering all three fixes

* fix: deduplicate EXPLAIN parsing, fix AS( regex in strings, block unknown CTE commands, bump langchain-core

- Refactor _validate_statement to use _resolve_explain_command (single source of truth)
- _iter_as_paren_matches skips string literals so 'AS (' in data doesn't confuse CTE detection
- Unknown commands after CTE definitions now blocked in read-only mode
- Bump langchain-core override to >=1.2.28 (GHSA-926x-3r5x-gfhw)

* fix: add return type annotation to _iter_as_paren_matches

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 docs/ar/tools/database-data/nl2sqltool.mdx    |  70 +-
 docs/en/tools/database-data/nl2sqltool.mdx    |  70 +-
 docs/ko/tools/database-data/nl2sqltool.mdx    |  70 +-
 docs/pt-BR/tools/database-data/nl2sqltool.mdx |  70 +-
 .../crewai_tools/tools/nl2sql/nl2sql_tool.py  | 436 +++++++++++-
 .../tests/tools/test_nl2sql_security.py       | 671 ++++++++++++++++++
 lib/crewai-tools/tool.specs.json              |   9 +-
 pyproject.toml                                |   4 +-
 uv.lock                                       | 633 ++++++++++-------
 9 files changed, 1757 insertions(+), 276 deletions(-)
 create mode 100644 lib/crewai-tools/tests/tools/test_nl2sql_security.py

diff --git a/docs/ar/tools/database-data/nl2sqltool.mdx b/docs/ar/tools/database-data/nl2sqltool.mdx
index de52a5dd8..6ddc6e058 100644
--- a/docs/ar/tools/database-data/nl2sqltool.mdx
+++ b/docs/ar/tools/database-data/nl2sqltool.mdx
@@ -11,7 +11,7 @@ mode: "wide"
 
 يتيح ذلك سير عمل متعددة مثل أن يقوم وكيل بالوصول إلى قاعدة البيانات واسترجاع المعلومات بناءً على الهدف ثم استخدام تلك المعلومات لتوليد استجابة أو تقرير أو أي مخرجات أخرى. بالإضافة إلى ذلك، يوفر القدرة للوكيل على تحديث قاعدة البيانات بناءً على هدفه.
 
-**تنبيه**: تأكد من أن الوكيل لديه وصول إلى نسخة قراءة فقط أو أنه من المقبول أن يقوم الوكيل بتنفيذ استعلامات إدراج/تحديث على قاعدة البيانات.
+**تنبيه**: الأداة للقراءة فقط بشكل افتراضي (SELECT/SHOW/DESCRIBE/EXPLAIN فقط). تتطلب عمليات الكتابة تمرير `allow_dml=True` أو ضبط متغير البيئة `CREWAI_NL2SQL_ALLOW_DML=true`. عند تفعيل الكتابة، تأكد من أن الوكيل يستخدم مستخدم قاعدة بيانات محدود الصلاحيات أو نسخة قراءة كلما أمكن.
 
 ## نموذج الأمان
 
@@ -36,6 +36,74 @@ mode: "wide"
 - أضف خطافات `before_tool_call` لفرض أنماط الاستعلام المسموح بها
 - فعّل تسجيل الاستعلامات والتنبيهات للعبارات التدميرية
 
+## وضع القراءة فقط وتهيئة DML
+
+تعمل `NL2SQLTool` في **وضع القراءة فقط بشكل افتراضي**. لا يُسمح إلا بأنواع العبارات التالية دون تهيئة إضافية:
+
+- `SELECT`
+- `SHOW`
+- `DESCRIBE`
+- `EXPLAIN`
+
+أي محاولة لتنفيذ عملية كتابة (`INSERT`، `UPDATE`، `DELETE`، `DROP`، `CREATE`، `ALTER`، `TRUNCATE`، إلخ) ستُسبب خطأً ما لم يتم تفعيل DML صراحةً.
+
+كما تُحظر الاستعلامات متعددة العبارات التي تحتوي على فاصلة منقوطة (مثل `SELECT 1; DROP TABLE users`) في وضع القراءة فقط لمنع هجمات الحقن.
+
+### تفعيل عمليات الكتابة
+
+يمكنك تفعيل DML (لغة معالجة البيانات) بطريقتين:
+
+**الخيار الأول — معامل المُنشئ:**
+
+```python
+from crewai_tools import NL2SQLTool
+
+nl2sql = NL2SQLTool(
+    db_uri="postgresql://example@localhost:5432/test_db",
+    allow_dml=True,
+)
+```
+
+**الخيار الثاني — متغير البيئة:**
+
+```bash
+CREWAI_NL2SQL_ALLOW_DML=true
+```
+
+```python
+from crewai_tools import NL2SQLTool
+
+# DML مفعّل عبر متغير البيئة
+nl2sql = NL2SQLTool(db_uri="postgresql://example@localhost:5432/test_db")
+```
+
+### أمثلة الاستخدام
+
+**القراءة فقط (الافتراضي) — آمن للتحليلات والتقارير:**
+
+```python
+from crewai_tools import NL2SQLTool
+
+# يُسمح فقط بـ SELECT/SHOW/DESCRIBE/EXPLAIN
+nl2sql = NL2SQLTool(db_uri="postgresql://example@localhost:5432/test_db")
+```
+
+**مع تفعيل DML — مطلوب لأعباء عمل الكتابة:**
+
+```python
+from crewai_tools import NL2SQLTool
+
+# يُسمح بـ INSERT وUPDATE وDELETE وDROP وغيرها
+nl2sql = NL2SQLTool(
+    db_uri="postgresql://example@localhost:5432/test_db",
+    allow_dml=True,
+)
+```
+
+<Warning>
+يمنح تفعيل DML للوكيل القدرة على تعديل البيانات أو حذفها. لا تفعّله إلا عندما يتطلب حالة الاستخدام صراحةً وصولاً للكتابة، وتأكد من أن بيانات اعتماد قاعدة البيانات محدودة بالحد الأدنى من الصلاحيات المطلوبة.
+</Warning>
+
 ## المتطلبات
 
 - SqlAlchemy
diff --git a/docs/en/tools/database-data/nl2sqltool.mdx b/docs/en/tools/database-data/nl2sqltool.mdx
index ee423e791..833a43cab 100644
--- a/docs/en/tools/database-data/nl2sqltool.mdx
+++ b/docs/en/tools/database-data/nl2sqltool.mdx
@@ -13,7 +13,7 @@ This tool is used to convert natural language to SQL queries. When passed to the
 This enables multiple workflows like having an Agent to access the database fetch information based on the goal and then use the information to generate a response, report or any other output. 
 Along with that provides the ability for the Agent to update the database based on its goal.
 
-**Attention**: Make sure that the Agent has access to a Read-Replica or that is okay for the Agent to run insert/update queries on the database.
+**Attention**: By default the tool is read-only (SELECT/SHOW/DESCRIBE/EXPLAIN only). Write operations require `allow_dml=True` or the `CREWAI_NL2SQL_ALLOW_DML=true` environment variable. When write access is enabled, make sure the Agent uses a scoped database user or a read replica where possible.
 
 ## Security Model
 
@@ -38,6 +38,74 @@ Use all of the following in production:
 - Add `before_tool_call` hooks to enforce allowed query patterns
 - Enable query logging and alerting for destructive statements
 
+## Read-Only Mode & DML Configuration
+
+`NL2SQLTool` operates in **read-only mode by default**. Only the following statement types are permitted without additional configuration:
+
+- `SELECT`
+- `SHOW`
+- `DESCRIBE`
+- `EXPLAIN`
+
+Any attempt to execute a write operation (`INSERT`, `UPDATE`, `DELETE`, `DROP`, `CREATE`, `ALTER`, `TRUNCATE`, etc.) will raise an error unless DML is explicitly enabled.
+
+Multi-statement queries containing semicolons (e.g. `SELECT 1; DROP TABLE users`) are also blocked in read-only mode to prevent injection attacks.
+
+### Enabling Write Operations
+
+You can enable DML (Data Manipulation Language) in two ways:
+
+**Option 1 — constructor parameter:**
+
+```python
+from crewai_tools import NL2SQLTool
+
+nl2sql = NL2SQLTool(
+    db_uri="postgresql://example@localhost:5432/test_db",
+    allow_dml=True,
+)
+```
+
+**Option 2 — environment variable:**
+
+```bash
+CREWAI_NL2SQL_ALLOW_DML=true
+```
+
+```python
+from crewai_tools import NL2SQLTool
+
+# DML enabled via environment variable
+nl2sql = NL2SQLTool(db_uri="postgresql://example@localhost:5432/test_db")
+```
+
+### Usage Examples
+
+**Read-only (default) — safe for analytics and reporting:**
+
+```python
+from crewai_tools import NL2SQLTool
+
+# Only SELECT/SHOW/DESCRIBE/EXPLAIN are permitted
+nl2sql = NL2SQLTool(db_uri="postgresql://example@localhost:5432/test_db")
+```
+
+**DML enabled — required for write workloads:**
+
+```python
+from crewai_tools import NL2SQLTool
+
+# INSERT, UPDATE, DELETE, DROP, etc. are permitted
+nl2sql = NL2SQLTool(
+    db_uri="postgresql://example@localhost:5432/test_db",
+    allow_dml=True,
+)
+```
+
+<Warning>
+Enabling DML gives the agent the ability to modify or destroy data. Only enable this when your use case explicitly requires write access, and ensure the database credentials are scoped to the minimum required privileges.
+</Warning>
+
 ## Requirements
 
 - SqlAlchemy
diff --git a/docs/ko/tools/database-data/nl2sqltool.mdx b/docs/ko/tools/database-data/nl2sqltool.mdx
index 5f6583155..32894f44c 100644
--- a/docs/ko/tools/database-data/nl2sqltool.mdx
+++ b/docs/ko/tools/database-data/nl2sqltool.mdx
@@ -11,7 +11,75 @@ mode: "wide"
 
 이를 통해 에이전트가 데이터베이스에 접근하여 목표에 따라 정보를 가져오고, 해당 정보를 사용해 응답, 보고서 또는 기타 출력물을 생성하는 다양한 워크플로우가 가능해집니다. 또한 에이전트가 자신의 목표에 맞춰 데이터베이스를 업데이트할 수 있는 기능도 제공합니다.
 
-**주의**: 에이전트가 Read-Replica에 접근할 수 있거나, 에이전트가 데이터베이스에 insert/update 쿼리를 실행해도 괜찮은지 반드시 확인하십시오.
+**주의**: 도구는 기본적으로 읽기 전용(SELECT/SHOW/DESCRIBE/EXPLAIN만 허용)으로 동작합니다. 쓰기 작업을 수행하려면 `allow_dml=True` 매개변수 또는 `CREWAI_NL2SQL_ALLOW_DML=true` 환경 변수가 필요합니다. 쓰기 접근이 활성화된 경우, 가능하면 권한이 제한된 데이터베이스 사용자나 읽기 복제본을 사용하십시오.
+
+## 읽기 전용 모드 및 DML 구성
+
+`NL2SQLTool`은 기본적으로 **읽기 전용 모드**로 동작합니다. 추가 구성 없이 허용되는 구문 유형은 다음과 같습니다:
+
+- `SELECT`
+- `SHOW`
+- `DESCRIBE`
+- `EXPLAIN`
+
+DML을 명시적으로 활성화하지 않으면 쓰기 작업(`INSERT`, `UPDATE`, `DELETE`, `DROP`, `CREATE`, `ALTER`, `TRUNCATE` 등)을 실행하려고 할 때 오류가 발생합니다.
+
+읽기 전용 모드에서는 세미콜론이 포함된 다중 구문 쿼리(예: `SELECT 1; DROP TABLE users`)도 인젝션 공격을 방지하기 위해 차단됩니다.
+
+### 쓰기 작업 활성화
+
+DML(데이터 조작 언어)을 활성화하는 방법은 두 가지입니다:
+
+**옵션 1 — 생성자 매개변수:**
+
+```python
+from crewai_tools import NL2SQLTool
+
+nl2sql = NL2SQLTool(
+    db_uri="postgresql://example@localhost:5432/test_db",
+    allow_dml=True,
+)
+```
+
+**옵션 2 — 환경 변수:**
+
+```bash
+CREWAI_NL2SQL_ALLOW_DML=true
+```
+
+```python
+from crewai_tools import NL2SQLTool
+
+# 환경 변수를 통해 DML 활성화
+nl2sql = NL2SQLTool(db_uri="postgresql://example@localhost:5432/test_db")
+```
+
+### 사용 예시
+
+**읽기 전용(기본값) — 분석 및 보고 워크로드에 안전:**
+
+```python
+from crewai_tools import NL2SQLTool
+
+# SELECT/SHOW/DESCRIBE/EXPLAIN만 허용
+nl2sql = NL2SQLTool(db_uri="postgresql://example@localhost:5432/test_db")
+```
+
+**DML 활성화 — 쓰기 워크로드에 필요:**
+
+```python
+from crewai_tools import NL2SQLTool
+
+# INSERT, UPDATE, DELETE, DROP 등이 허용됨
+nl2sql = NL2SQLTool(
+    db_uri="postgresql://example@localhost:5432/test_db",
+    allow_dml=True,
+)
+```
+
+<Warning>
+DML을 활성화하면 에이전트가 데이터를 수정하거나 삭제할 수 있습니다. 사용 사례에서 명시적으로 쓰기 접근이 필요한 경우에만 활성화하고, 데이터베이스 자격 증명이 최소 필요 권한으로 제한되어 있는지 확인하십시오.
+</Warning>
 
 ## 요구 사항
 
diff --git a/docs/pt-BR/tools/database-data/nl2sqltool.mdx b/docs/pt-BR/tools/database-data/nl2sqltool.mdx
index f414ab4e2..8ef3cc160 100644
--- a/docs/pt-BR/tools/database-data/nl2sqltool.mdx
+++ b/docs/pt-BR/tools/database-data/nl2sqltool.mdx
@@ -11,7 +11,75 @@ Esta ferramenta é utilizada para converter linguagem natural em consultas SQL.
 
 Isso possibilita múltiplos fluxos de trabalho, como por exemplo ter um Agente acessando o banco de dados para buscar informações com base em um objetivo e, então, usar essas informações para gerar uma resposta, relatório ou qualquer outro tipo de saída. Além disso, permite que o Agente atualize o banco de dados de acordo com seu objetivo.
 
-**Atenção**: Certifique-se de que o Agente tenha acesso a um Read-Replica ou que seja permitido que o Agente execute consultas de inserção/atualização no banco de dados.
+**Atenção**: Por padrão, a ferramenta opera em modo somente leitura (apenas SELECT/SHOW/DESCRIBE/EXPLAIN). Operações de escrita exigem `allow_dml=True` ou a variável de ambiente `CREWAI_NL2SQL_ALLOW_DML=true`. Quando o acesso de escrita estiver habilitado, certifique-se de que o Agente use um usuário de banco de dados com privilégios mínimos ou um Read-Replica sempre que possível.
+
+## Modo Somente Leitura e Configuração de DML
+
+O `NL2SQLTool` opera em **modo somente leitura por padrão**. Apenas os seguintes tipos de instrução são permitidos sem configuração adicional:
+
+- `SELECT`
+- `SHOW`
+- `DESCRIBE`
+- `EXPLAIN`
+
+Qualquer tentativa de executar uma operação de escrita (`INSERT`, `UPDATE`, `DELETE`, `DROP`, `CREATE`, `ALTER`, `TRUNCATE`, etc.) resultará em erro, a menos que o DML seja habilitado explicitamente.
+
+Consultas com múltiplas instruções contendo ponto e vírgula (ex.: `SELECT 1; DROP TABLE users`) também são bloqueadas no modo somente leitura para prevenir ataques de injeção.
+
+### Habilitando Operações de Escrita
+
+Você pode habilitar DML (Linguagem de Manipulação de Dados) de duas formas:
+
+**Opção 1 — parâmetro do construtor:**
+
+```python
+from crewai_tools import NL2SQLTool
+
+nl2sql = NL2SQLTool(
+    db_uri="postgresql://example@localhost:5432/test_db",
+    allow_dml=True,
+)
+```
+
+**Opção 2 — variável de ambiente:**
+
+```bash
+CREWAI_NL2SQL_ALLOW_DML=true
+```
+
+```python
+from crewai_tools import NL2SQLTool
+
+# DML habilitado via variável de ambiente
+nl2sql = NL2SQLTool(db_uri="postgresql://example@localhost:5432/test_db")
+```
+
+### Exemplos de Uso
+
+**Somente leitura (padrão) — seguro para análise e relatórios:**
+
+```python
+from crewai_tools import NL2SQLTool
+
+# Apenas SELECT/SHOW/DESCRIBE/EXPLAIN são permitidos
+nl2sql = NL2SQLTool(db_uri="postgresql://example@localhost:5432/test_db")
+```
+
+**Com DML habilitado — necessário para workloads de escrita:**
+
+```python
+from crewai_tools import NL2SQLTool
+
+# INSERT, UPDATE, DELETE, DROP, etc. são permitidos
+nl2sql = NL2SQLTool(
+    db_uri="postgresql://example@localhost:5432/test_db",
+    allow_dml=True,
+)
+```
+
+<Warning>
+Habilitar DML concede ao agente a capacidade de modificar ou destruir dados. Ative apenas quando o seu caso de uso exigir explicitamente acesso de escrita e certifique-se de que as credenciais do banco de dados estejam limitadas aos privilégios mínimos necessários.
+</Warning>
 
 ## Requisitos
 
diff --git a/lib/crewai-tools/src/crewai_tools/tools/nl2sql/nl2sql_tool.py b/lib/crewai-tools/src/crewai_tools/tools/nl2sql/nl2sql_tool.py
index bfb9c02dd..4e20b4354 100644
--- a/lib/crewai-tools/src/crewai_tools/tools/nl2sql/nl2sql_tool.py
+++ b/lib/crewai-tools/src/crewai_tools/tools/nl2sql/nl2sql_tool.py
@@ -1,7 +1,17 @@
+from collections.abc import Iterator
+import logging
+import os
+import re
 from typing import Any
 
+
+try:
+    from typing import Self
+except ImportError:
+    from typing_extensions import Self
+
 from crewai.tools import BaseTool
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, Field, model_validator
 
 
 try:
@@ -12,6 +22,186 @@ try:
 except ImportError:
     SQLALCHEMY_AVAILABLE = False
 
+logger = logging.getLogger(__name__)
+
+# Commands allowed in read-only mode
+# NOTE: WITH is intentionally excluded — writable CTEs start with WITH, so the
+# CTE body must be inspected separately (see _validate_statement).
+_READ_ONLY_COMMANDS = {"SELECT", "SHOW", "DESCRIBE", "DESC", "EXPLAIN"}
+
+# Commands that mutate state and are blocked by default
+_WRITE_COMMANDS = {
+    "INSERT",
+    "UPDATE",
+    "DELETE",
+    "DROP",
+    "ALTER",
+    "CREATE",
+    "TRUNCATE",
+    "GRANT",
+    "REVOKE",
+    "EXEC",
+    "EXECUTE",
+    "CALL",
+    "MERGE",
+    "REPLACE",
+    "UPSERT",
+    "LOAD",
+    "COPY",
+    "VACUUM",
+    "ANALYZE",
+    "ANALYSE",
+    "REINDEX",
+    "CLUSTER",
+    "REFRESH",
+    "COMMENT",
+    "SET",
+    "RESET",
+}
+
+
+# Subset of write commands that can realistically appear *inside* a CTE body.
+# Narrower than _WRITE_COMMANDS to avoid false positives on identifiers like
+# ``comment``, ``set``, or ``reset`` which are common column/table names.
+_CTE_WRITE_INDICATORS = {
+    "INSERT",
+    "UPDATE",
+    "DELETE",
+    "DROP",
+    "ALTER",
+    "CREATE",
+    "TRUNCATE",
+    "MERGE",
+}
+
+
+_AS_PAREN_RE = re.compile(r"\bAS\s*\(", re.IGNORECASE)
+
+
+def _iter_as_paren_matches(stmt: str) -> Iterator[re.Match[str]]:
+    """Yield regex matches for ``AS\\s*(`` outside of string literals."""
+    # Build a set of character positions that are inside string literals.
+    in_string: set[int] = set()
+    i = 0
+    while i < len(stmt):
+        if stmt[i] == "'":
+            start = i
+            end = _skip_string_literal(stmt, i)
+            in_string.update(range(start, end))
+            i = end
+        else:
+            i += 1
+
+    for m in _AS_PAREN_RE.finditer(stmt):
+        if m.start() not in in_string:
+            yield m
+
+
+def _detect_writable_cte(stmt: str) -> str | None:
+    """Return the first write command inside a CTE body, or None.
+
+    Instead of tokenizing the whole statement (which falsely matches column
+    names like ``comment``), this walks through parenthesized CTE bodies and
+    checks only the *first keyword after* an opening ``AS (`` for a write
+    command.  Uses a regex to handle any whitespace (spaces, tabs, newlines)
+    between ``AS`` and ``(``.  Skips matches inside string literals.
+    """
+    for m in _iter_as_paren_matches(stmt):
+        body = stmt[m.end() :].lstrip()
+        first_word = body.split()[0].upper().strip("()") if body.split() else ""
+        if first_word in _CTE_WRITE_INDICATORS:
+            return first_word
+    return None
+
+
+def _skip_string_literal(stmt: str, pos: int) -> int:
+    """Skip past a string literal starting at pos (single-quoted).
+
+    Handles escaped quotes ('') inside the literal.
+    Returns the index after the closing quote.
+    """
+    quote_char = stmt[pos]
+    i = pos + 1
+    while i < len(stmt):
+        if stmt[i] == quote_char:
+            # Check for escaped quote ('')
+            if i + 1 < len(stmt) and stmt[i + 1] == quote_char:
+                i += 2
+                continue
+            return i + 1
+        i += 1
+    return i  # Unterminated literal — return end
+
+
+def _find_matching_close_paren(stmt: str, start: int) -> int:
+    """Find the matching close paren, skipping string literals."""
+    depth = 1
+    i = start
+    while i < len(stmt) and depth > 0:
+        ch = stmt[i]
+        if ch == "'":
+            i = _skip_string_literal(stmt, i)
+            continue
+        if ch == "(":
+            depth += 1
+        elif ch == ")":
+            depth -= 1
+        i += 1
+    return i
+
+
+def _extract_main_query_after_cte(stmt: str) -> str | None:
+    """Extract the main (outer) query that follows all CTE definitions.
+
+    For ``WITH cte AS (SELECT 1) DELETE FROM users``, returns ``DELETE FROM users``.
+    Returns None if no main query is found after the last CTE body.
+    Handles parentheses inside string literals (e.g., ``SELECT '(' FROM t``).
+    """
+    last_cte_end = 0
+    for m in _iter_as_paren_matches(stmt):
+        last_cte_end = _find_matching_close_paren(stmt, m.end())
+
+    if last_cte_end > 0:
+        remainder = stmt[last_cte_end:].strip().lstrip(",").strip()
+        if remainder:
+            return remainder
+    return None
+
+
+def _resolve_explain_command(stmt: str) -> str | None:
+    """Resolve the underlying command from an EXPLAIN [ANALYZE] [VERBOSE] statement.
+
+    Returns the real command (e.g., 'DELETE') if ANALYZE is present, else None.
+    Handles both space-separated and parenthesized syntax.
+    """
+    rest = stmt.strip()[len("EXPLAIN") :].strip()
+    if not rest:
+        return None
+
+    analyze_found = False
+    explain_opts = {"ANALYZE", "ANALYSE", "VERBOSE"}
+
+    if rest.startswith("("):
+        close = rest.find(")")
+        if close != -1:
+            options_str = rest[1:close].upper()
+            analyze_found = any(
+                opt.strip() in ("ANALYZE", "ANALYSE") for opt in options_str.split(",")
+            )
+            rest = rest[close + 1 :].strip()
+    else:
+        while rest:
+            first_opt = rest.split()[0].upper().rstrip(";") if rest.split() else ""
+            if first_opt in ("ANALYZE", "ANALYSE"):
+                analyze_found = True
+            if first_opt not in explain_opts:
+                break
+            rest = rest[len(first_opt) :].strip()
+
+    if analyze_found and rest:
+        return rest.split()[0].upper().rstrip(";")
+    return None
+
 
 class NL2SQLToolInput(BaseModel):
     sql_query: str = Field(
@@ -21,20 +211,70 @@ class NL2SQLToolInput(BaseModel):
 
 
 class NL2SQLTool(BaseTool):
+    """Tool that converts natural language to SQL and executes it against a database.
+
+    By default the tool operates in **read-only mode**: only SELECT, SHOW,
+    DESCRIBE, EXPLAIN, and read-only CTEs (WITH … SELECT) are permitted.  Write
+    operations (INSERT, UPDATE, DELETE, DROP, ALTER, CREATE, TRUNCATE, …) are
+    blocked unless ``allow_dml=True`` is set explicitly or the environment
+    variable ``CREWAI_NL2SQL_ALLOW_DML=true`` is present.
+
+    Writable CTEs (``WITH d AS (DELETE …) SELECT …``) and
+    ``EXPLAIN ANALYZE <write-stmt>`` are treated as write operations and are
+    blocked in read-only mode.
+
+    The ``_fetch_all_available_columns`` helper uses parameterised queries so
+    that table names coming from the database catalogue cannot be used as an
+    injection vector.
+    """
+
     name: str = "NL2SQLTool"
-    description: str = "Converts natural language to SQL queries and executes them."
+    description: str = (
+        "Converts natural language to SQL queries and executes them against a "
+        "database. Read-only by default — only SELECT/SHOW/DESCRIBE/EXPLAIN "
+        "queries (and read-only CTEs) are allowed unless configured with "
+        "allow_dml=True."
+    )
     db_uri: str = Field(
         title="Database URI",
         description="The URI of the database to connect to.",
     )
+    allow_dml: bool = Field(
+        default=False,
+        title="Allow DML",
+        description=(
+            "When False (default) only read statements are permitted. "
+            "Set to True to allow INSERT/UPDATE/DELETE/DROP and other "
+            "write operations."
+        ),
+    )
     tables: list[dict[str, Any]] = Field(default_factory=list)
     columns: dict[str, list[dict[str, Any]] | str] = Field(default_factory=dict)
     args_schema: type[BaseModel] = NL2SQLToolInput
 
+    @model_validator(mode="after")
+    def _apply_env_override(self) -> Self:
+        """Allow CREWAI_NL2SQL_ALLOW_DML=true to override allow_dml at runtime."""
+        if os.environ.get("CREWAI_NL2SQL_ALLOW_DML", "").strip().lower() == "true":
+            if not self.allow_dml:
+                logger.warning(
+                    "NL2SQLTool: CREWAI_NL2SQL_ALLOW_DML env var is set — "
+                    "DML/DDL operations are enabled. Ensure this is intentional."
+                )
+            self.allow_dml = True
+        return self
+
     def model_post_init(self, __context: Any) -> None:
         if not SQLALCHEMY_AVAILABLE:
             raise ImportError(
-                "sqlalchemy is not installed. Please install it with `pip install crewai-tools[sqlalchemy]`"
+                "sqlalchemy is not installed. Please install it with "
+                "`pip install crewai-tools[sqlalchemy]`"
+            )
+
+        if self.allow_dml:
+            logger.warning(
+                "NL2SQLTool: allow_dml=True — write operations (INSERT/UPDATE/"
+                "DELETE/DROP/…) are permitted. Use with caution."
             )
 
         data: dict[str, list[dict[str, Any]] | str] = {}
@@ -50,42 +290,216 @@ class NL2SQLTool(BaseTool):
         self.tables = tables
         self.columns = data
 
+    # ------------------------------------------------------------------
+    # Query validation
+    # ------------------------------------------------------------------
+
+    def _validate_query(self, sql_query: str) -> None:
+        """Raise ValueError if *sql_query* is not permitted under the current config.
+
+        Splits the query on semicolons and validates each statement
+        independently.  When ``allow_dml=False`` (the default), multi-statement
+        queries are rejected outright to prevent ``SELECT 1; DROP TABLE users``
+        style bypasses.  When ``allow_dml=True`` every statement is checked and
+        a warning is emitted for write operations.
+        """
+        statements = [s.strip() for s in sql_query.split(";") if s.strip()]
+
+        if not statements:
+            raise ValueError("NL2SQLTool received an empty SQL query.")
+
+        if not self.allow_dml and len(statements) > 1:
+            raise ValueError(
+                "NL2SQLTool blocked a multi-statement query in read-only mode. "
+                "Semicolons are not permitted when allow_dml=False."
+            )
+
+        for stmt in statements:
+            self._validate_statement(stmt)
+
+    def _validate_statement(self, stmt: str) -> None:
+        """Validate a single SQL statement (no semicolons)."""
+        command = self._extract_command(stmt)
+
+        # EXPLAIN ANALYZE / EXPLAIN ANALYSE actually *executes* the underlying
+        # query.  Resolve the real command so write operations are caught.
+        # Handles both space-separated ("EXPLAIN ANALYZE DELETE …") and
+        # parenthesized ("EXPLAIN (ANALYZE) DELETE …", "EXPLAIN (ANALYZE, VERBOSE) DELETE …").
+        # EXPLAIN ANALYZE actually executes the underlying query — resolve the
+        # real command so write operations are caught.
+        if command == "EXPLAIN":
+            resolved = _resolve_explain_command(stmt)
+            if resolved:
+                command = resolved
+
+        # WITH starts a CTE.  Read-only CTEs are fine; writable CTEs
+        # (e.g. WITH d AS (DELETE …) SELECT …) must be blocked in read-only mode.
+        if command == "WITH":
+            # Check for write commands inside CTE bodies.
+            write_found = _detect_writable_cte(stmt)
+            if write_found:
+                found = write_found
+                if not self.allow_dml:
+                    raise ValueError(
+                        f"NL2SQLTool is configured in read-only mode and blocked a "
+                        f"writable CTE containing a '{found}' statement. To allow "
+                        f"write operations set allow_dml=True or "
+                        f"CREWAI_NL2SQL_ALLOW_DML=true."
+                    )
+                logger.warning(
+                    "NL2SQLTool: executing writable CTE with '%s' because allow_dml=True.",
+                    found,
+                )
+                return
+
+            # Check the main query after the CTE definitions.
+            main_query = _extract_main_query_after_cte(stmt)
+            if main_query:
+                main_cmd = main_query.split()[0].upper().rstrip(";")
+                if main_cmd in _WRITE_COMMANDS:
+                    if not self.allow_dml:
+                        raise ValueError(
+                            f"NL2SQLTool is configured in read-only mode and blocked a "
+                            f"'{main_cmd}' statement after a CTE. To allow write "
+                            f"operations set allow_dml=True or "
+                            f"CREWAI_NL2SQL_ALLOW_DML=true."
+                        )
+                    logger.warning(
+                        "NL2SQLTool: executing '%s' after CTE because allow_dml=True.",
+                        main_cmd,
+                    )
+                elif main_cmd not in _READ_ONLY_COMMANDS:
+                    if not self.allow_dml:
+                        raise ValueError(
+                            f"NL2SQLTool blocked an unrecognised SQL command '{main_cmd}' "
+                            f"after a CTE. Only {sorted(_READ_ONLY_COMMANDS)} are allowed "
+                            f"in read-only mode."
+                        )
+            return
+
+        if command in _WRITE_COMMANDS:
+            if not self.allow_dml:
+                raise ValueError(
+                    f"NL2SQLTool is configured in read-only mode and blocked a "
+                    f"'{command}' statement. To allow write operations set "
+                    f"allow_dml=True or CREWAI_NL2SQL_ALLOW_DML=true."
+                )
+            logger.warning(
+                "NL2SQLTool: executing write statement '%s' because allow_dml=True.",
+                command,
+            )
+        elif command not in _READ_ONLY_COMMANDS:
+            # Unknown command — block by default unless DML is explicitly enabled
+            if not self.allow_dml:
+                raise ValueError(
+                    f"NL2SQLTool blocked an unrecognised SQL command '{command}'. "
+                    f"Only {sorted(_READ_ONLY_COMMANDS)} are allowed in read-only "
+                    f"mode."
+                )
+
+    @staticmethod
+    def _extract_command(sql_query: str) -> str:
+        """Return the uppercased first keyword of *sql_query*."""
+        stripped = sql_query.strip().lstrip("(")
+        first_token = stripped.split()[0] if stripped.split() else ""
+        return first_token.upper().rstrip(";")
+
+    # ------------------------------------------------------------------
+    # Schema introspection helpers
+    # ------------------------------------------------------------------
+
     def _fetch_available_tables(self) -> list[dict[str, Any]] | str:
         return self.execute_sql(
-            "SELECT table_name FROM information_schema.tables WHERE table_schema = 'public';"
+            "SELECT table_name FROM information_schema.tables "
+            "WHERE table_schema = 'public';"
         )
 
     def _fetch_all_available_columns(
         self, table_name: str
     ) -> list[dict[str, Any]] | str:
+        """Fetch columns for *table_name* using a parameterised query.
+
+        The table name is bound via SQLAlchemy's ``:param`` syntax to prevent
+        SQL injection from catalogue values.
+        """
         return self.execute_sql(
-            f"SELECT column_name, data_type FROM information_schema.columns WHERE table_name = '{table_name}';"  # noqa: S608
+            "SELECT column_name, data_type FROM information_schema.columns "
+            "WHERE table_name = :table_name",
+            params={"table_name": table_name},
         )
 
+    # ------------------------------------------------------------------
+    # Core execution
+    # ------------------------------------------------------------------
+
     def _run(self, sql_query: str) -> list[dict[str, Any]] | str:
         try:
+            self._validate_query(sql_query)
             data = self.execute_sql(sql_query)
+        except ValueError:
+            raise
         except Exception as exc:
             data = (
                 f"Based on these tables {self.tables} and columns {self.columns}, "
-                "you can create SQL queries to retrieve data from the database."
-                f"Get the original request {sql_query} and the error {exc} and create the correct SQL query."
+                "you can create SQL queries to retrieve data from the database. "
+                f"Get the original request {sql_query} and the error {exc} and "
+                "create the correct SQL query."
             )
 
         return data
 
-    def execute_sql(self, sql_query: str) -> list[dict[str, Any]] | str:
+    def execute_sql(
+        self,
+        sql_query: str,
+        params: dict[str, Any] | None = None,
+    ) -> list[dict[str, Any]] | str:
+        """Execute *sql_query* and return the results as a list of dicts.
+
+        Parameters
+        ----------
+        sql_query:
+            The SQL statement to run.
+        params:
+            Optional mapping of bind parameters (e.g. ``{"table_name": "users"}``).
+        """
         if not SQLALCHEMY_AVAILABLE:
             raise ImportError(
-                "sqlalchemy is not installed. Please install it with `pip install crewai-tools[sqlalchemy]`"
+                "sqlalchemy is not installed. Please install it with "
+                "`pip install crewai-tools[sqlalchemy]`"
             )
 
+        # Check ALL statements so that e.g. "SELECT 1; DROP TABLE t" triggers a
+        # commit when allow_dml=True, regardless of statement order.
+        _stmts = [s.strip() for s in sql_query.split(";") if s.strip()]
+
+        def _is_write_stmt(s: str) -> bool:
+            cmd = self._extract_command(s)
+            if cmd in _WRITE_COMMANDS:
+                return True
+            if cmd == "EXPLAIN":
+                # Resolve the underlying command for EXPLAIN ANALYZE
+                resolved = _resolve_explain_command(s)
+                if resolved and resolved in _WRITE_COMMANDS:
+                    return True
+            if cmd == "WITH":
+                if _detect_writable_cte(s):
+                    return True
+                main_q = _extract_main_query_after_cte(s)
+                if main_q:
+                    return main_q.split()[0].upper().rstrip(";") in _WRITE_COMMANDS
+            return False
+
+        is_write = any(_is_write_stmt(s) for s in _stmts)
+
         engine = create_engine(self.db_uri)
         Session = sessionmaker(bind=engine)  # noqa: N806
         session = Session()
         try:
-            result = session.execute(text(sql_query))
-            session.commit()
+            result = session.execute(text(sql_query), params or {})
+
+            # Only commit when the operation actually mutates state
+            if self.allow_dml and is_write:
+                session.commit()
 
             if result.returns_rows:  # type: ignore[attr-defined]
                 columns = result.keys()
diff --git a/lib/crewai-tools/tests/tools/test_nl2sql_security.py b/lib/crewai-tools/tests/tools/test_nl2sql_security.py
new file mode 100644
index 000000000..abef973ff
--- /dev/null
+++ b/lib/crewai-tools/tests/tools/test_nl2sql_security.py
@@ -0,0 +1,671 @@
+"""Security tests for NL2SQLTool.
+
+Uses an in-memory SQLite database so no external service is needed.
+SQLite does not have information_schema, so we patch the schema-introspection
+helpers to avoid bootstrap failures and focus purely on the security logic.
+"""
+import os
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+# Skip the entire module if SQLAlchemy is not installed
+pytest.importorskip("sqlalchemy")
+
+from sqlalchemy import create_engine, text  # noqa: E402
+
+from crewai_tools.tools.nl2sql.nl2sql_tool import NL2SQLTool  # noqa: E402
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+SQLITE_URI = "sqlite://"  # in-memory
+
+
+def _make_tool(allow_dml: bool = False, **kwargs) -> NL2SQLTool:
+    """Return a NL2SQLTool wired to an in-memory SQLite DB.
+
+    Schema-introspection is patched out so we can create the tool without a
+    real PostgreSQL information_schema.
+    """
+    with (
+        patch.object(NL2SQLTool, "_fetch_available_tables", return_value=[]),
+        patch.object(NL2SQLTool, "_fetch_all_available_columns", return_value=[]),
+    ):
+        return NL2SQLTool(db_uri=SQLITE_URI, allow_dml=allow_dml, **kwargs)
+
+
+# ---------------------------------------------------------------------------
+# Read-only enforcement (allow_dml=False)
+# ---------------------------------------------------------------------------
+
+
+class TestReadOnlyMode:
+    def test_select_allowed_by_default(self):
+        tool = _make_tool()
+        # SQLite supports SELECT without information_schema
+        result = tool.execute_sql("SELECT 1 AS val")
+        assert result == [{"val": 1}]
+
+    @pytest.mark.parametrize(
+        "stmt",
+        [
+            "INSERT INTO t VALUES (1)",
+            "UPDATE t SET col = 1",
+            "DELETE FROM t",
+            "DROP TABLE t",
+            "ALTER TABLE t ADD col TEXT",
+            "CREATE TABLE t (id INTEGER)",
+            "TRUNCATE TABLE t",
+            "GRANT SELECT ON t TO user1",
+            "REVOKE SELECT ON t FROM user1",
+            "EXEC sp_something",
+            "EXECUTE sp_something",
+            "CALL proc()",
+        ],
+    )
+    def test_write_statements_blocked_by_default(self, stmt: str):
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query(stmt)
+
+    def test_explain_allowed(self):
+        tool = _make_tool()
+        # Should not raise
+        tool._validate_query("EXPLAIN SELECT 1")
+
+    def test_read_only_cte_allowed(self):
+        tool = _make_tool()
+        tool._validate_query("WITH cte AS (SELECT 1) SELECT * FROM cte")
+
+    def test_show_allowed(self):
+        tool = _make_tool()
+        tool._validate_query("SHOW TABLES")
+
+    def test_describe_allowed(self):
+        tool = _make_tool()
+        tool._validate_query("DESCRIBE users")
+
+
+# ---------------------------------------------------------------------------
+# DML enabled (allow_dml=True)
+# ---------------------------------------------------------------------------
+
+
+class TestDMLEnabled:
+    def test_insert_allowed_when_dml_enabled(self):
+        tool = _make_tool(allow_dml=True)
+        # Should not raise
+        tool._validate_query("INSERT INTO t VALUES (1)")
+
+    def test_delete_allowed_when_dml_enabled(self):
+        tool = _make_tool(allow_dml=True)
+        tool._validate_query("DELETE FROM t WHERE id = 1")
+
+    def test_drop_allowed_when_dml_enabled(self):
+        tool = _make_tool(allow_dml=True)
+        tool._validate_query("DROP TABLE t")
+
+    def test_dml_actually_persists(self):
+        """End-to-end: INSERT commits when allow_dml=True."""
+        # Use a file-based SQLite so we can verify persistence across sessions
+        import tempfile, os
+        with tempfile.NamedTemporaryFile(suffix=".db", delete=False) as f:
+            db_path = f.name
+        uri = f"sqlite:///{db_path}"
+        try:
+            tool = _make_tool(allow_dml=True)
+            tool.db_uri = uri
+
+            engine = create_engine(uri)
+            with engine.connect() as conn:
+                conn.execute(text("CREATE TABLE items (id INTEGER PRIMARY KEY)"))
+                conn.commit()
+
+            tool.execute_sql("INSERT INTO items VALUES (42)")
+
+            with engine.connect() as conn:
+                rows = conn.execute(text("SELECT id FROM items")).fetchall()
+            assert (42,) in rows
+        finally:
+            os.unlink(db_path)
+
+
+# ---------------------------------------------------------------------------
+# Parameterised query — SQL injection prevention
+# ---------------------------------------------------------------------------
+
+
+class TestParameterisedQueries:
+    def test_table_name_is_parameterised(self):
+        """_fetch_all_available_columns must not interpolate table_name into SQL."""
+        tool = _make_tool()
+        captured_calls = []
+
+        def recording_execute_sql(self_inner, sql_query, params=None):
+            captured_calls.append((sql_query, params))
+            return []
+
+        with patch.object(NL2SQLTool, "execute_sql", recording_execute_sql):
+            tool._fetch_all_available_columns("users'; DROP TABLE users; --")
+
+        assert len(captured_calls) == 1
+        sql, params = captured_calls[0]
+        # The raw SQL must NOT contain the injected string
+        assert "DROP" not in sql
+        # The table name must be passed as a parameter
+        assert params is not None
+        assert params.get("table_name") == "users'; DROP TABLE users; --"
+        # The SQL template must use the :param syntax
+        assert ":table_name" in sql
+
+    def test_injection_string_not_in_sql_template(self):
+        """The f-string vulnerability is gone — table name never lands in the SQL."""
+        tool = _make_tool()
+        injection = "'; DROP TABLE users; --"
+        captured = {}
+
+        def spy(self_inner, sql_query, params=None):
+            captured["sql"] = sql_query
+            captured["params"] = params
+            return []
+
+        with patch.object(NL2SQLTool, "execute_sql", spy):
+            tool._fetch_all_available_columns(injection)
+
+        assert injection not in captured["sql"]
+        assert captured["params"]["table_name"] == injection
+
+
+# ---------------------------------------------------------------------------
+# session.commit() not called for read-only queries
+# ---------------------------------------------------------------------------
+
+
+class TestNoCommitForReadOnly:
+    def test_select_does_not_commit(self):
+        tool = _make_tool(allow_dml=False)
+
+        mock_session = MagicMock()
+        mock_result = MagicMock()
+        mock_result.returns_rows = True
+        mock_result.keys.return_value = ["val"]
+        mock_result.fetchall.return_value = [(1,)]
+        mock_session.execute.return_value = mock_result
+
+        mock_session_cls = MagicMock(return_value=mock_session)
+
+        with (
+            patch("crewai_tools.tools.nl2sql.nl2sql_tool.create_engine"),
+            patch(
+                "crewai_tools.tools.nl2sql.nl2sql_tool.sessionmaker",
+                return_value=mock_session_cls,
+            ),
+        ):
+            tool.execute_sql("SELECT 1")
+
+        mock_session.commit.assert_not_called()
+
+    def test_write_with_dml_enabled_does_commit(self):
+        tool = _make_tool(allow_dml=True)
+
+        mock_session = MagicMock()
+        mock_result = MagicMock()
+        mock_result.returns_rows = False
+        mock_session.execute.return_value = mock_result
+
+        mock_session_cls = MagicMock(return_value=mock_session)
+
+        with (
+            patch("crewai_tools.tools.nl2sql.nl2sql_tool.create_engine"),
+            patch(
+                "crewai_tools.tools.nl2sql.nl2sql_tool.sessionmaker",
+                return_value=mock_session_cls,
+            ),
+        ):
+            tool.execute_sql("INSERT INTO t VALUES (1)")
+
+        mock_session.commit.assert_called_once()
+
+
+# ---------------------------------------------------------------------------
+# Environment-variable escape hatch
+# ---------------------------------------------------------------------------
+
+
+class TestEnvVarEscapeHatch:
+    def test_env_var_enables_dml(self):
+        with patch.dict(os.environ, {"CREWAI_NL2SQL_ALLOW_DML": "true"}):
+            tool = _make_tool(allow_dml=False)
+        assert tool.allow_dml is True
+
+    def test_env_var_case_insensitive(self):
+        with patch.dict(os.environ, {"CREWAI_NL2SQL_ALLOW_DML": "TRUE"}):
+            tool = _make_tool(allow_dml=False)
+        assert tool.allow_dml is True
+
+    def test_env_var_absent_keeps_default(self):
+        env = {k: v for k, v in os.environ.items() if k != "CREWAI_NL2SQL_ALLOW_DML"}
+        with patch.dict(os.environ, env, clear=True):
+            tool = _make_tool(allow_dml=False)
+        assert tool.allow_dml is False
+
+    def test_env_var_false_does_not_enable_dml(self):
+        with patch.dict(os.environ, {"CREWAI_NL2SQL_ALLOW_DML": "false"}):
+            tool = _make_tool(allow_dml=False)
+        assert tool.allow_dml is False
+
+    def test_dml_write_blocked_without_env_var(self):
+        env = {k: v for k, v in os.environ.items() if k != "CREWAI_NL2SQL_ALLOW_DML"}
+        with patch.dict(os.environ, env, clear=True):
+            tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query("DROP TABLE sensitive_data")
+
+
+# ---------------------------------------------------------------------------
+# _run() propagates ValueError from _validate_query
+# ---------------------------------------------------------------------------
+
+
+class TestRunValidation:
+    def test_run_raises_on_blocked_query(self):
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._run("DELETE FROM users")
+
+    def test_run_returns_results_for_select(self):
+        tool = _make_tool(allow_dml=False)
+        result = tool._run("SELECT 1 AS n")
+        assert result == [{"n": 1}]
+
+
+# ---------------------------------------------------------------------------
+# Multi-statement / semicolon injection prevention
+# ---------------------------------------------------------------------------
+
+
+class TestSemicolonInjection:
+    def test_multi_statement_blocked_in_read_only_mode(self):
+        """SELECT 1; DROP TABLE users must be rejected when allow_dml=False."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="multi-statement"):
+            tool._validate_query("SELECT 1; DROP TABLE users")
+
+    def test_multi_statement_blocked_even_with_only_selects(self):
+        """Two SELECT statements are still rejected in read-only mode."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="multi-statement"):
+            tool._validate_query("SELECT 1; SELECT 2")
+
+    def test_trailing_semicolon_allowed_single_statement(self):
+        """A single statement with a trailing semicolon should pass."""
+        tool = _make_tool(allow_dml=False)
+        # Should not raise — the part after the semicolon is empty
+        tool._validate_query("SELECT 1;")
+
+    def test_multi_statement_allowed_when_dml_enabled(self):
+        """Multiple statements are permitted when allow_dml=True."""
+        tool = _make_tool(allow_dml=True)
+        # Should not raise
+        tool._validate_query("SELECT 1; INSERT INTO t VALUES (1)")
+
+    def test_multi_statement_write_still_blocked_individually(self):
+        """Even with allow_dml=False, a single write statement is blocked."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query("DROP TABLE users")
+
+
+# ---------------------------------------------------------------------------
+# Writable CTEs (WITH … DELETE/INSERT/UPDATE)
+# ---------------------------------------------------------------------------
+
+
+class TestWritableCTE:
+    def test_writable_cte_delete_blocked_in_read_only(self):
+        """WITH d AS (DELETE FROM users RETURNING *) SELECT * FROM d — blocked."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query(
+                "WITH deleted AS (DELETE FROM users RETURNING *) SELECT * FROM deleted"
+            )
+
+    def test_writable_cte_insert_blocked_in_read_only(self):
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query(
+                "WITH ins AS (INSERT INTO t VALUES (1) RETURNING id) SELECT * FROM ins"
+            )
+
+    def test_writable_cte_update_blocked_in_read_only(self):
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query(
+                "WITH upd AS (UPDATE t SET x=1 RETURNING id) SELECT * FROM upd"
+            )
+
+    def test_writable_cte_allowed_when_dml_enabled(self):
+        tool = _make_tool(allow_dml=True)
+        # Should not raise
+        tool._validate_query(
+            "WITH deleted AS (DELETE FROM users RETURNING *) SELECT * FROM deleted"
+        )
+
+    def test_plain_read_only_cte_still_allowed(self):
+        tool = _make_tool(allow_dml=False)
+        # No write commands in the CTE body — must pass
+        tool._validate_query("WITH cte AS (SELECT id FROM users) SELECT * FROM cte")
+
+    def test_cte_with_comment_column_not_false_positive(self):
+        """Column named 'comment' should NOT trigger writable CTE detection."""
+        tool = _make_tool(allow_dml=False)
+        # 'comment' is a column name, not a SQL command
+        tool._validate_query(
+            "WITH cte AS (SELECT comment FROM posts) SELECT * FROM cte"
+        )
+
+    def test_cte_with_set_column_not_false_positive(self):
+        """Column named 'set' should NOT trigger writable CTE detection."""
+        tool = _make_tool(allow_dml=False)
+        tool._validate_query(
+            "WITH cte AS (SELECT set, reset FROM config) SELECT * FROM cte"
+        )
+
+
+# ---------------------------------------------------------------------------
+# EXPLAIN ANALYZE executes the underlying query
+# ---------------------------------------------------------------------------
+
+
+    def test_cte_with_write_main_query_blocked(self):
+        """WITH cte AS (SELECT 1) DELETE FROM users — main query must be caught."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query(
+                "WITH cte AS (SELECT 1) DELETE FROM users"
+            )
+
+    def test_cte_with_write_main_query_allowed_with_dml(self):
+        """Main query write after CTE should pass when allow_dml=True."""
+        tool = _make_tool(allow_dml=True)
+        tool._validate_query(
+            "WITH cte AS (SELECT id FROM users) INSERT INTO archive SELECT * FROM cte"
+        )
+
+    def test_cte_with_newline_before_paren_blocked(self):
+        """AS followed by newline then ( should still detect writable CTE."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query(
+                "WITH cte AS\n(DELETE FROM users RETURNING *) SELECT * FROM cte"
+            )
+
+    def test_cte_with_tab_before_paren_blocked(self):
+        """AS followed by tab then ( should still detect writable CTE."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query(
+                "WITH cte AS\t(DELETE FROM users RETURNING *) SELECT * FROM cte"
+            )
+
+
+class TestExplainAnalyze:
+    def test_explain_analyze_delete_blocked_in_read_only(self):
+        """EXPLAIN ANALYZE DELETE actually runs the delete — block it."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query("EXPLAIN ANALYZE DELETE FROM users")
+
+    def test_explain_analyse_delete_blocked_in_read_only(self):
+        """British spelling ANALYSE is also caught."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query("EXPLAIN ANALYSE DELETE FROM users")
+
+    def test_explain_analyze_drop_blocked_in_read_only(self):
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query("EXPLAIN ANALYZE DROP TABLE users")
+
+    def test_explain_analyze_select_allowed_in_read_only(self):
+        """EXPLAIN ANALYZE on a SELECT is safe — must be permitted."""
+        tool = _make_tool(allow_dml=False)
+        tool._validate_query("EXPLAIN ANALYZE SELECT * FROM users")
+
+    def test_explain_without_analyze_allowed(self):
+        tool = _make_tool(allow_dml=False)
+        tool._validate_query("EXPLAIN SELECT * FROM users")
+
+    def test_explain_analyze_delete_allowed_when_dml_enabled(self):
+        tool = _make_tool(allow_dml=True)
+        tool._validate_query("EXPLAIN ANALYZE DELETE FROM users")
+
+    def test_explain_paren_analyze_delete_blocked_in_read_only(self):
+        """EXPLAIN (ANALYZE) DELETE actually runs the delete — block it."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query("EXPLAIN (ANALYZE) DELETE FROM users")
+
+    def test_explain_paren_analyze_verbose_delete_blocked_in_read_only(self):
+        """EXPLAIN (ANALYZE, VERBOSE) DELETE actually runs the delete — block it."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query("EXPLAIN (ANALYZE, VERBOSE) DELETE FROM users")
+
+    def test_explain_paren_verbose_select_allowed_in_read_only(self):
+        """EXPLAIN (VERBOSE) SELECT is safe — no ANALYZE means no execution."""
+        tool = _make_tool(allow_dml=False)
+        tool._validate_query("EXPLAIN (VERBOSE) SELECT * FROM users")
+
+
+# ---------------------------------------------------------------------------
+# Multi-statement commit covers ALL statements (not just the first)
+# ---------------------------------------------------------------------------
+
+
+class TestMultiStatementCommit:
+    def test_select_then_insert_triggers_commit(self):
+        """SELECT 1; INSERT … — commit must happen because INSERT is a write."""
+        tool = _make_tool(allow_dml=True)
+
+        mock_session = MagicMock()
+        mock_result = MagicMock()
+        mock_result.returns_rows = False
+        mock_session.execute.return_value = mock_result
+        mock_session_cls = MagicMock(return_value=mock_session)
+
+        with (
+            patch("crewai_tools.tools.nl2sql.nl2sql_tool.create_engine"),
+            patch(
+                "crewai_tools.tools.nl2sql.nl2sql_tool.sessionmaker",
+                return_value=mock_session_cls,
+            ),
+        ):
+            tool.execute_sql("SELECT 1; INSERT INTO t VALUES (1)")
+
+        mock_session.commit.assert_called_once()
+
+    def test_select_only_multi_statement_does_not_commit(self):
+        """Two SELECTs must not trigger a commit even when allow_dml=True."""
+        tool = _make_tool(allow_dml=True)
+
+        mock_session = MagicMock()
+        mock_result = MagicMock()
+        mock_result.returns_rows = True
+        mock_result.keys.return_value = ["v"]
+        mock_result.fetchall.return_value = [(1,)]
+        mock_session.execute.return_value = mock_result
+        mock_session_cls = MagicMock(return_value=mock_session)
+
+        with (
+            patch("crewai_tools.tools.nl2sql.nl2sql_tool.create_engine"),
+            patch(
+                "crewai_tools.tools.nl2sql.nl2sql_tool.sessionmaker",
+                return_value=mock_session_cls,
+            ),
+        ):
+            tool.execute_sql("SELECT 1; SELECT 2")
+
+    def test_writable_cte_triggers_commit(self):
+        """WITH d AS (DELETE ...) must trigger commit when allow_dml=True."""
+        tool = _make_tool(allow_dml=True)
+
+        mock_session = MagicMock()
+        mock_result = MagicMock()
+        mock_result.returns_rows = True
+        mock_result.keys.return_value = ["id"]
+        mock_result.fetchall.return_value = [(1,)]
+        mock_session.execute.return_value = mock_result
+        mock_session_cls = MagicMock(return_value=mock_session)
+
+        with (
+            patch("crewai_tools.tools.nl2sql.nl2sql_tool.create_engine"),
+            patch(
+                "crewai_tools.tools.nl2sql.nl2sql_tool.sessionmaker",
+                return_value=mock_session_cls,
+            ),
+        ):
+            tool.execute_sql(
+                "WITH d AS (DELETE FROM users RETURNING *) SELECT * FROM d"
+            )
+            mock_session.commit.assert_called_once()
+
+
+# ---------------------------------------------------------------------------
+# Extended _WRITE_COMMANDS coverage
+# ---------------------------------------------------------------------------
+
+
+class TestExtendedWriteCommands:
+    @pytest.mark.parametrize(
+        "stmt",
+        [
+            "UPSERT INTO t VALUES (1)",
+            "LOAD DATA INFILE 'f.csv' INTO TABLE t",
+            "COPY t FROM '/tmp/f.csv'",
+            "VACUUM ANALYZE t",
+            "ANALYZE t",
+            "ANALYSE t",
+            "REINDEX TABLE t",
+            "CLUSTER t USING idx",
+            "REFRESH MATERIALIZED VIEW v",
+            "COMMENT ON TABLE t IS 'desc'",
+            "SET search_path = myschema",
+            "RESET search_path",
+        ],
+    )
+    def test_extended_write_commands_blocked_by_default(self, stmt: str):
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query(stmt)
+
+
+# ---------------------------------------------------------------------------
+# EXPLAIN ANALYZE VERBOSE handling
+# ---------------------------------------------------------------------------
+
+
+class TestExplainAnalyzeVerbose:
+    def test_explain_analyze_verbose_select_allowed(self):
+        """EXPLAIN ANALYZE VERBOSE SELECT should be allowed (read-only)."""
+        tool = _make_tool(allow_dml=False)
+        tool._validate_query("EXPLAIN ANALYZE VERBOSE SELECT * FROM users")
+
+    def test_explain_analyze_verbose_delete_blocked(self):
+        """EXPLAIN ANALYZE VERBOSE DELETE should be blocked."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query("EXPLAIN ANALYZE VERBOSE DELETE FROM users")
+
+    def test_explain_verbose_select_allowed(self):
+        """EXPLAIN VERBOSE SELECT (no ANALYZE) should be allowed."""
+        tool = _make_tool(allow_dml=False)
+        tool._validate_query("EXPLAIN VERBOSE SELECT * FROM users")
+
+
+# ---------------------------------------------------------------------------
+# CTE with string literal parens
+# ---------------------------------------------------------------------------
+
+
+class TestCTEStringLiteralParens:
+    def test_cte_string_paren_does_not_bypass(self):
+        """Parens inside string literals should not confuse the paren walker."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query(
+                "WITH cte AS (SELECT '(' FROM t) DELETE FROM users"
+            )
+
+    def test_cte_string_paren_read_only_allowed(self):
+        """Read-only CTE with string literal parens should be allowed."""
+        tool = _make_tool(allow_dml=False)
+        tool._validate_query(
+            "WITH cte AS (SELECT '(' FROM t) SELECT * FROM cte"
+        )
+
+
+# ---------------------------------------------------------------------------
+# EXPLAIN ANALYZE commit logic
+# ---------------------------------------------------------------------------
+
+
+class TestExplainAnalyzeCommit:
+    def test_explain_analyze_delete_triggers_commit(self):
+        """EXPLAIN ANALYZE DELETE should trigger commit when allow_dml=True."""
+        tool = _make_tool(allow_dml=True)
+
+        mock_session = MagicMock()
+        mock_result = MagicMock()
+        mock_result.returns_rows = True
+        mock_result.keys.return_value = ["QUERY PLAN"]
+        mock_result.fetchall.return_value = [("Delete on users",)]
+        mock_session.execute.return_value = mock_result
+        mock_session_cls = MagicMock(return_value=mock_session)
+
+        with (
+            patch("crewai_tools.tools.nl2sql.nl2sql_tool.create_engine"),
+            patch(
+                "crewai_tools.tools.nl2sql.nl2sql_tool.sessionmaker",
+                return_value=mock_session_cls,
+            ),
+        ):
+            tool.execute_sql("EXPLAIN ANALYZE DELETE FROM users")
+            mock_session.commit.assert_called_once()
+
+
+# ---------------------------------------------------------------------------
+# AS( inside string literals must not confuse CTE detection
+# ---------------------------------------------------------------------------
+
+
+class TestCTEStringLiteralAS:
+    def test_as_paren_inside_string_does_not_bypass(self):
+        """'AS (' inside a string literal must not be treated as a CTE body."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="read-only mode"):
+            tool._validate_query(
+                "WITH cte AS (SELECT 'AS (' FROM t) DELETE FROM users"
+            )
+
+    def test_as_paren_inside_string_read_only_ok(self):
+        """Read-only CTE with 'AS (' in a string should be allowed."""
+        tool = _make_tool(allow_dml=False)
+        tool._validate_query(
+            "WITH cte AS (SELECT 'AS (' FROM t) SELECT * FROM cte"
+        )
+
+
+# ---------------------------------------------------------------------------
+# Unknown command after CTE should be blocked
+# ---------------------------------------------------------------------------
+
+
+class TestCTEUnknownCommand:
+    def test_unknown_command_after_cte_blocked(self):
+        """WITH cte AS (SELECT 1) FOOBAR should be blocked as unknown."""
+        tool = _make_tool(allow_dml=False)
+        with pytest.raises(ValueError, match="unrecognised"):
+            tool._validate_query("WITH cte AS (SELECT 1) FOOBAR")
diff --git a/lib/crewai-tools/tool.specs.json b/lib/crewai-tools/tool.specs.json
index 76ff76a4b..a00501503 100644
--- a/lib/crewai-tools/tool.specs.json
+++ b/lib/crewai-tools/tool.specs.json
@@ -14051,7 +14051,7 @@
       }
     },
     {
-      "description": "Converts natural language to SQL queries and executes them.",
+      "description": "Converts natural language to SQL queries and executes them against a database. Read-only by default \u2014 only SELECT/SHOW/DESCRIBE/EXPLAIN queries (and read-only CTEs) are allowed unless configured with allow_dml=True.",
       "env_vars": [],
       "humanized_name": "NL2SQLTool",
       "init_params_schema": {
@@ -14092,7 +14092,14 @@
             "type": "object"
           }
         },
+        "description": "Tool that converts natural language to SQL and executes it against a database.\n\nBy default the tool operates in **read-only mode**: only SELECT, SHOW,\nDESCRIBE, EXPLAIN, and read-only CTEs (WITH \u2026 SELECT) are permitted.  Write\noperations (INSERT, UPDATE, DELETE, DROP, ALTER, CREATE, TRUNCATE, \u2026) are\nblocked unless ``allow_dml=True`` is set explicitly or the environment\nvariable ``CREWAI_NL2SQL_ALLOW_DML=true`` is present.\n\nWritable CTEs (``WITH d AS (DELETE \u2026) SELECT \u2026``) and\n``EXPLAIN ANALYZE <write-stmt>`` are treated as write operations and are\nblocked in read-only mode.\n\nThe ``_fetch_all_available_columns`` helper uses parameterised queries so\nthat table names coming from the database catalogue cannot be used as an\ninjection vector.",
         "properties": {
+          "allow_dml": {
+            "default": false,
+            "description": "When False (default) only read statements are permitted. Set to True to allow INSERT/UPDATE/DELETE/DROP and other write operations.",
+            "title": "Allow DML",
+            "type": "boolean"
+          },
           "columns": {
             "additionalProperties": {
               "anyOf": [
diff --git a/pyproject.toml b/pyproject.toml
index caf6c61c8..58faa76be 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -166,14 +166,14 @@ exclude-newer = "2026-04-10"  # pinned for CVE-2026-39892; restore to "3 days" a
 # composio-core pins rich<14 but textual requires rich>=14.
 # onnxruntime 1.24+ dropped Python 3.10 wheels; cap it so qdrant[fastembed] resolves on 3.10.
 # fastembed 0.7.x and docling 2.63 cap pillow<12; the removed APIs don't affect them.
-# langchain-core <1.2.11 has SSRF via image_url token counting (CVE-2026-26013).
+# langchain-core <1.2.28 has GHSA-926x-3r5x-gfhw (incomplete f-string validation).
 # transformers 4.57.6 has CVE-2026-1839; force 5.4+ (docling 2.84 allows huggingface-hub>=1).
 # cryptography 46.0.6 has CVE-2026-39892; force 46.0.7+.
 override-dependencies = [
     "rich>=13.7.1",
     "onnxruntime<1.24; python_version < '3.11'",
     "pillow>=12.1.1",
-    "langchain-core>=1.2.11,<2",
+    "langchain-core>=1.2.28,<2",
     "urllib3>=2.6.3",
     "transformers>=5.4.0; python_version >= '3.10'",
     "cryptography>=46.0.7",
diff --git a/uv.lock b/uv.lock
index 1bfe4937e..2df411274 100644
--- a/uv.lock
+++ b/uv.lock
@@ -13,7 +13,7 @@ resolution-markers = [
 ]
 
 [options]
-exclude-newer = "2026-04-10T16:00:00Z"
+exclude-newer = "2026-04-11T07:00:00Z"
 
 [manifest]
 members = [
@@ -24,7 +24,7 @@ members = [
 ]
 overrides = [
     { name = "cryptography", specifier = ">=46.0.7" },
-    { name = "langchain-core", specifier = ">=1.2.11,<2" },
+    { name = "langchain-core", specifier = ">=1.2.28,<2" },
     { name = "onnxruntime", marker = "python_full_version < '3.11'", specifier = "<1.24" },
     { name = "pillow", specifier = ">=12.1.1" },
     { name = "rich", specifier = ">=13.7.1" },
@@ -673,7 +673,7 @@ wheels = [
 
 [[package]]
 name = "browserbase"
-version = "1.7.0"
+version = "1.8.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "anyio" },
@@ -683,9 +683,9 @@ dependencies = [
     { name = "sniffio" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/d8/72/27d4ca6fec8d107f3ee905675ce7a48b47fcf7918a5ce17fdbe40846beef/browserbase-1.7.0.tar.gz", hash = "sha256:e5b7acd33fad07666c1b9c7a33acea14d46a1693adaf5620c52839a746a342b8", size = 143680, upload-time = "2026-03-16T21:01:26.837Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/4b/07/4ab4b91921833d0fb1731940d74141396d83120821f4c85482ed80bb2457/browserbase-1.8.0.tar.gz", hash = "sha256:dc62910c2f1fab3e944f338af9fbf82f53bbffcb3aeb6382b4e435a752383011", size = 147213, upload-time = "2026-04-06T19:31:26.848Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/93/59/ae53543ca44b232f64f18413eaf5c3eb968d690ae6960ffb4b4d1a9449d9/browserbase-1.7.0-py3-none-any.whl", hash = "sha256:6ff0ad602f18a7b2034e9e564fbaee05f02954456f1709fc36061f53755356ce", size = 107840, upload-time = "2026-03-16T21:01:25.698Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/c3/a29e57566c52fdb24712dcbb93a9bc97937c0c75874d8880a41a651daa5c/browserbase-1.8.0-py3-none-any.whl", hash = "sha256:4c4215973cc99f2f6d34550ae105c3f1f83b5fe22df2845bea0920b10f809526", size = 110012, upload-time = "2026-04-06T19:31:25.765Z" },
 ]
 
 [[package]]
@@ -871,7 +871,8 @@ source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "bcrypt" },
     { name = "build" },
-    { name = "grpcio" },
+    { name = "grpcio", version = "1.78.0", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
+    { name = "grpcio", version = "1.80.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
     { name = "httpx" },
     { name = "importlib-resources" },
     { name = "jsonschema" },
@@ -1518,7 +1519,8 @@ tavily-python = [
     { name = "tavily-python" },
 ]
 weaviate-client = [
-    { name = "weaviate-client" },
+    { name = "weaviate-client", version = "4.16.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
+    { name = "weaviate-client", version = "4.18.3", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
 ]
 xml = [
     { name = "unstructured", extra = ["all-docs", "local-inference"] },
@@ -1647,10 +1649,10 @@ wheels = [
 
 [[package]]
 name = "cuda-pathfinder"
-version = "1.5.0"
+version = "1.5.2"
 source = { registry = "https://pypi.org/simple" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/93/66/0c02bd330e7d976f83fa68583d6198d76f23581bcbb5c0e98a6148f326e5/cuda_pathfinder-1.5.0-py3-none-any.whl", hash = "sha256:498f90a9e9de36044a7924742aecce11c50c49f735f1bc53e05aa46de9ea4110", size = 49739, upload-time = "2026-03-24T21:14:30.869Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/f9/1b9b60a30fc463c14cdea7a77228131a0ccc89572e8df9cb86c9648271ab/cuda_pathfinder-1.5.2-py3-none-any.whl", hash = "sha256:0c5f160a7756c5b072723cbbd6d861e38917ef956c68150b02f0b6e9271c71fa", size = 49988, upload-time = "2026-04-06T23:01:05.17Z" },
 ]
 
 [[package]]
@@ -1864,7 +1866,7 @@ wheels = [
 
 [[package]]
 name = "docling-core"
-version = "2.71.0"
+version = "2.72.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "defusedxml" },
@@ -1879,9 +1881,9 @@ dependencies = [
     { name = "typer" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/c4/5e/0e5463bcbb2de3ae8f35f76a1e98b201b373b71783120f57daa4d5bc4683/docling_core-2.71.0.tar.gz", hash = "sha256:4caa9f50c68b9dd332584ae16170b36db05d773532b14d7078b580d89d8bd2a4", size = 302901, upload-time = "2026-03-30T15:48:20.997Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/45/87/7b49ca0f4e39b051292694eb82e5ff3a7e6ae88a5bc11b8004747afb6e47/docling_core-2.72.0.tar.gz", hash = "sha256:981b789f7097c26b2fa84d0d28cdeaa58ddd8b49e277dce7e44b1b826b8f90f0", size = 304572, upload-time = "2026-04-07T12:35:55.736Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/50/5d/604cd8d076cacea11018e20c461bad6df1b769e1aa901b70d06bca33b0f6/docling_core-2.71.0-py3-none-any.whl", hash = "sha256:4761857816853b2b35263b5b4518e1ea6214e0565db0bbf1d929fb976665d1a0", size = 268049, upload-time = "2026-03-30T15:48:18.998Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/e5/dfbcbfb3d258d5c44043cc1cd314d0447c8f08563ff8fa5a2f77d34eab31/docling_core-2.72.0-py3-none-any.whl", hash = "sha256:3592c35a423093c7fe087416a43de7db0bd1539148f2fa9ac775c41e4ec015a4", size = 269342, upload-time = "2026-04-07T12:35:54.06Z" },
 ]
 
 [package.optional-dependencies]
@@ -1922,7 +1924,7 @@ wheels = [
 
 [[package]]
 name = "docling-parse"
-version = "5.7.0"
+version = "5.8.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "docling-core" },
@@ -1931,24 +1933,24 @@ dependencies = [
     { name = "pywin32", marker = "sys_platform == 'win32'" },
     { name = "tabulate" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/22/ce/2dff1c13dffd5557833b83697556126cbe78ad3d60adfbd9c915e6b8b464/docling_parse-5.7.0.tar.gz", hash = "sha256:c77209c2e093ca5f8266952bd13b95aef09dfa38e6995ecf855971819786c93d", size = 64359331, upload-time = "2026-04-01T08:46:45.447Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/be/57/7b98e3ccf1ed40977bf832f028c68c248b0df1c25a5a33a50c2b2943ea72/docling_parse-5.8.0.tar.gz", hash = "sha256:cbb1d591dd94edab4ab3b81e9e42a3e4c7fe9ab3c3e690dccd498602aae63c5a", size = 65990181, upload-time = "2026-04-08T09:41:39.651Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/22/7b/79a3aadb6b58b1e29660db833202d40a648a032475f52dadd994bc6a778e/docling_parse-5.7.0-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:e4d218e0983cdf447eb994b657fed7ba9b324ab2544b7a004ef97736b3b44b7c", size = 8531704, upload-time = "2026-04-01T08:46:04.047Z" },
-    { url = "https://files.pythonhosted.org/packages/16/ff/08d6c25131e1dc8ab9cc745ea7b86168be9367c094389c98b29ed62152d0/docling_parse-5.7.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:78631d7a9dafe716fb92af00199a585e9959454dd87d178d82ad583cc62af68c", size = 9303534, upload-time = "2026-04-01T08:46:06.096Z" },
-    { url = "https://files.pythonhosted.org/packages/a8/20/ecd4da5492d6fafae8402d79251c389ac74e428bcab98c9c32a5d7439157/docling_parse-5.7.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e4f78f8a570bb33e9557ec3c93e4939bec8bf4d9d96032e34616a877a3bda84f", size = 9544737, upload-time = "2026-04-01T08:46:08.458Z" },
-    { url = "https://files.pythonhosted.org/packages/54/cb/175436f1fb29a5338bc6cc32a88ab319910dec55bf873f35cf4f8221cc2f/docling_parse-5.7.0-cp310-cp310-win_amd64.whl", hash = "sha256:8acf03df37e475c523d3e2fd9101ec21f4f7de532adc4dd7b9394890dcc0547c", size = 10349252, upload-time = "2026-04-01T08:46:10.559Z" },
-    { url = "https://files.pythonhosted.org/packages/61/90/164b10d24064e3186ba679b80f118a09644f67e938a90324d3a9b1294d64/docling_parse-5.7.0-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:4a4df3a79b413e2fcaa9f4494c355045778b18fd71db070e6f9166e19d00b193", size = 8533116, upload-time = "2026-04-01T08:46:12.367Z" },
-    { url = "https://files.pythonhosted.org/packages/44/c1/5181c34b2c6841222fff3a4a4ad082b4441c33a7e47227d21582021e7ed6/docling_parse-5.7.0-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7fcab1f5c4a82925305897d198ad19a27e05a6859fe0c917c321040490d968dc", size = 9261386, upload-time = "2026-04-01T08:46:14.248Z" },
-    { url = "https://files.pythonhosted.org/packages/62/1a/8dd86721b8dc653e750e1531359abb0548568a92c08d781348fafb17ff29/docling_parse-5.7.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:af12d1a011687cb46a0879d4b6dcb8534be393cb70de5d7428a335706af53dcc", size = 9592996, upload-time = "2026-04-01T08:46:15.881Z" },
-    { url = "https://files.pythonhosted.org/packages/bf/c4/744e9f6150c7373d6ffa61ebed7957819f4c0e00c6794ea1473f9a11c799/docling_parse-5.7.0-cp311-cp311-win_amd64.whl", hash = "sha256:660bbcc1fe7736289cb1e57ea8f770266e7095c3708e40b35b3c0e7d9ca08d81", size = 10350448, upload-time = "2026-04-01T08:46:17.948Z" },
-    { url = "https://files.pythonhosted.org/packages/97/9d/14269974385ae0b1d6fb31df0224e0ae83aefb9931288282222f908fd704/docling_parse-5.7.0-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:a645b47bc637a63e87b86b3995fe319b63be116e1b7bc9ec1fd44edb00356f6d", size = 8534658, upload-time = "2026-04-01T08:46:19.878Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/d1/f2a7815da9c8df51306fe941b4c829fa53bdaf866331caa0917508c1bade/docling_parse-5.7.0-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7503f5321ef94b455c4cd56e3d437699205d2150f2f3c93889dd64309b34d342", size = 9262244, upload-time = "2026-04-01T08:46:21.623Z" },
-    { url = "https://files.pythonhosted.org/packages/3b/e6/17d7c19e4e4193aec5219ebbb4a8baf0afafa6d82c11df04a05e8483c759/docling_parse-5.7.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:92e819292ab3ee2852a296b0189dfa972916446518fe977eefdfb2ea6823d86e", size = 9595224, upload-time = "2026-04-01T08:46:25.001Z" },
-    { url = "https://files.pythonhosted.org/packages/e5/b1/9f9a1006de94e6775b2a332fd72a5d91478e4a9eda878a369d33e0ab23a6/docling_parse-5.7.0-cp312-cp312-win_amd64.whl", hash = "sha256:763b53a30ea171e3a58f92d2892682692ae6a34001dfcad4f01806c18cbd021b", size = 10351618, upload-time = "2026-04-01T08:46:26.878Z" },
-    { url = "https://files.pythonhosted.org/packages/c9/da/d781ee9da13b4d952e3baf5d7d01f429d60afe30ef90b1d70afc5960613c/docling_parse-5.7.0-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:d480fff217fc62183ca97259347c09f46e7539fcacedfb860ecdae628c0247a0", size = 8534712, upload-time = "2026-04-01T08:46:28.887Z" },
-    { url = "https://files.pythonhosted.org/packages/a6/23/4205b2d8e0007d18d2bef7c67257272594f23a26882acdec06b13aabe858/docling_parse-5.7.0-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b2247152e4438d01cc51bc9d5d6524a8da06362d3a80ec84397f6b3b414b577f", size = 9263031, upload-time = "2026-04-01T08:46:30.859Z" },
-    { url = "https://files.pythonhosted.org/packages/01/61/8fbe76e34cd6715a5974f599ca1524f730847d6eebe73f7a230f391fab9b/docling_parse-5.7.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:41785ee7b472d7a688f183e33c927c6b364ac8432898ff4616b99de1b1ae518d", size = 9595643, upload-time = "2026-04-01T08:46:32.819Z" },
-    { url = "https://files.pythonhosted.org/packages/ee/62/6607673219fa157628f5c2ccb7e8bf1715f36c54cebaf46f031cc1bd6727/docling_parse-5.7.0-cp313-cp313-win_amd64.whl", hash = "sha256:f122a81390e2869e03cf110de0ff4db6f5c57ce7d95def82fe0c5f1c3838fdf7", size = 10351630, upload-time = "2026-04-01T08:46:35.132Z" },
+    { url = "https://files.pythonhosted.org/packages/06/38/02a686660fe89a6f6775618ae43f9d4b76f615edc7374a1e8e1bf648fb73/docling_parse-5.8.0-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:241d09a904d8e4b70a2c040252a75a088e971a7926a46973389cb3235a5cab74", size = 8539476, upload-time = "2026-04-08T09:40:53.245Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/38/ebd2fd850eef60d9c201cfb28b24bc3c8a27efeb34e817c12f544453a3c2/docling_parse-5.8.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a2e81da134baff612ea38ff0af3bf17deef196195d2415bfcf4f531bc7d0dd84", size = 9311993, upload-time = "2026-04-08T09:40:55.362Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/ba/c05c35a75b358ddaafdf0cd1e3f3737091722c6547b692cd66a99071159a/docling_parse-5.8.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b149bd7eeb91a5c6bdbc4a9bd87055a2a06d9ea959bf34d309580c1722d2e2b9", size = 9553650, upload-time = "2026-04-08T09:40:57.636Z" },
+    { url = "https://files.pythonhosted.org/packages/63/7a/3670258908f6e5cf04251b9547967ebbf28211e29ede30eb5da41e0b509a/docling_parse-5.8.0-cp310-cp310-win_amd64.whl", hash = "sha256:ac2c03347de9a0f02cdd46385ee4ae05f91eefc72aeac4749389d17f661dd7d5", size = 10357004, upload-time = "2026-04-08T09:40:59.921Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/09/57e47cc861f4e98201d6b881c6a7683e84f8ad20e2c1d619fe94c39ab7f2/docling_parse-5.8.0-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:fd1ae1cc22a96ccef76f82756ff7958d2a1eb38804e7cd9eed6ae951e2480c30", size = 8540650, upload-time = "2026-04-08T09:41:01.933Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/55/0265703d03377ad7ad3c4d482b00265275061ac15470dc815815944637cf/docling_parse-5.8.0-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b3908496e6949d2e56e361fc743a8f9248cb0f76807a1860027dde02be14f854", size = 9269550, upload-time = "2026-04-08T09:41:04.454Z" },
+    { url = "https://files.pythonhosted.org/packages/96/03/962449ed1b6692e16c3cae0cf00fd60145d620dd1886aedacd1636727dec/docling_parse-5.8.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:860fbd5f2d30774d1c739d373aec14b7e074fdace191e5ac16750e7b14f136f4", size = 9601965, upload-time = "2026-04-08T09:41:06.807Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/18/5bee07b6ef6451b71904e0d21d7721af964fd92f3465305ef791d7a3cf56/docling_parse-5.8.0-cp311-cp311-win_amd64.whl", hash = "sha256:854630f6ef7889d1757611194330d88fbbe53c0b202b5a010a467bf059f715da", size = 10358059, upload-time = "2026-04-08T09:41:09.049Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/61/3038e3a759df3aff0f02628eaeb71f6068b428ddd62981e639c5acf1eca8/docling_parse-5.8.0-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:a37c8c0aab730a9857c726420925cccc304a16abd91f054b25726394ee1ac836", size = 8541739, upload-time = "2026-04-08T09:41:11.525Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/98/b9307f84a7753cc369bbdd81f0183f308e8be1efeb2998193a494f8a8f44/docling_parse-5.8.0-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8b2c7455b058525cdd46d4c6b7c429871f096aa7718ce1b8481dae426358cf29", size = 9269677, upload-time = "2026-04-08T09:41:13.721Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/a6/686adf6ed39d9de9912b233b8d0bd4f5e8113023aef47630ffde12ff0ba4/docling_parse-5.8.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:987d8eacb0f515f53a860329acc5c826487a9d2ff4430f08bd37498854cdab42", size = 9604016, upload-time = "2026-04-08T09:41:15.762Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/1b/90c5447a00a652a81e2b4fea86b33a694b1e0fec3b9fb1862f9b6f48f54a/docling_parse-5.8.0-cp312-cp312-win_amd64.whl", hash = "sha256:6f72b0fdd370e825777f7a9989c390c630774870390c7277b7f016bfae395d6a", size = 10360133, upload-time = "2026-04-08T09:41:18.085Z" },
+    { url = "https://files.pythonhosted.org/packages/33/c9/799cc497b71537bafb6b8bf66fcccf303f8a84684503e8783d489db03aab/docling_parse-5.8.0-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:292b82a9773c66a76e5ee376cfdde4a4d6a8edae6a4493aba4013d939e7a213f", size = 8541804, upload-time = "2026-04-08T09:41:20.358Z" },
+    { url = "https://files.pythonhosted.org/packages/93/29/1030c13b257be7a4317bc7837c22366eff6d961ca6d6604b426dc8a9adcd/docling_parse-5.8.0-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:85c896983aaa7b95f409ed52014da59a945f2b914291c0782740e6a5b6d39028", size = 9269366, upload-time = "2026-04-08T09:41:22.437Z" },
+    { url = "https://files.pythonhosted.org/packages/54/22/40990653103c2eb83b073d2aca47aa95b767f1360214fca4c6339df105c3/docling_parse-5.8.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:2d9139f8da5e6553a36afb40dba614011ebd1bf97e5d17896ace07191a289c4b", size = 9604422, upload-time = "2026-04-08T09:41:24.619Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/9e/4ab1b16f6ba17f9695df79faa08a332b09a2d333d609036a7d0106538d57/docling_parse-5.8.0-cp313-cp313-win_amd64.whl", hash = "sha256:7343ee48b0480593ed08b04ed0b09421724a6dec63d82c23fac436129b32c66a", size = 10360242, upload-time = "2026-04-08T09:41:27.132Z" },
 ]
 
 [[package]]
@@ -2014,7 +2016,7 @@ wheels = [
 
 [[package]]
 name = "exa-py"
-version = "2.10.2"
+version = "2.11.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpcore" },
@@ -2025,9 +2027,9 @@ dependencies = [
     { name = "requests" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/fe/4f/f06a6f277d668f143e330fe503b0027cc5fed753b22c3e161f8cbbccdf65/exa_py-2.10.2.tar.gz", hash = "sha256:f781f30b199f1102333384728adae64bb15a6bbcabfa97e91fd705f90acffc45", size = 53792, upload-time = "2026-03-26T20:29:35.764Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/c5/08/af21dace845b5cd67d728e9d7747e4d1024ec90bd83e007d78f969dc6e19/exa_py-2.11.0.tar.gz", hash = "sha256:989103cbd83aae6dbe88cb70e11522a4bb06026fdb54b8659e3a7922da41fc93", size = 54905, upload-time = "2026-04-04T00:04:32.455Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/e2/bc/7a34e904a415040ba626948d0b0a36a08cd073f12b13342578a68331be3c/exa_py-2.10.2-py3-none-any.whl", hash = "sha256:ecb2a7581f4b7a8aeb6b434acce1bbc40f92ed1d4126b2aa6029913acd904a47", size = 72248, upload-time = "2026-03-26T20:29:37.306Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/c9/129dd486505e3c0dadda0d6c83c560060f76d4cf14ef4b7b93053846598a/exa_py-2.11.0-py3-none-any.whl", hash = "sha256:3b0070a6ce98e02895755f0f81752dff64e2e121cf9d9a82facf715a4b9a5238", size = 73424, upload-time = "2026-04-04T00:04:33.699Z" },
 ]
 
 [[package]]
@@ -2053,14 +2055,14 @@ wheels = [
 
 [[package]]
 name = "faker"
-version = "40.12.0"
+version = "40.13.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "tzdata", marker = "sys_platform == 'win32'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/66/c1/f8224fe97fea2f98d455c22438c1b09b10e14ef2cb95ae4f7cec9aa59659/faker-40.12.0.tar.gz", hash = "sha256:58b5a9054c367bd5fb2e948634105364cc570e78a98a8e5161a74691c45f158f", size = 1962003, upload-time = "2026-03-30T18:00:56.596Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/89/95/4822ffe94723553789aef783104f4f18fc20d7c4c68e1bbd633e11d09758/faker-40.13.0.tar.gz", hash = "sha256:a0751c84c3abac17327d7bb4c98e8afe70ebf7821e01dd7d0b15cd8856415525", size = 1962043, upload-time = "2026-04-06T16:44:55.68Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/2b/5c/39452a6b6aa76ffa518fa7308e1975b37e9ba77caa6172a69d61e7180221/faker-40.12.0-py3-none-any.whl", hash = "sha256:6238a4058a8b581892e3d78fe5fdfa7568739e1c8283e4ede83f1dde0bfc1a3b", size = 1994601, upload-time = "2026-03-30T18:00:54.804Z" },
+    { url = "https://files.pythonhosted.org/packages/da/8a/708103325edff16a0b0e004de0d37db8ba216a32713948c64d71f6d4a4c2/faker-40.13.0-py3-none-any.whl", hash = "sha256:c1298fd0d819b3688fb5fd358c4ba8f56c7c8c740b411fd3dbd8e30bf2c05019", size = 1994597, upload-time = "2026-04-06T16:44:53.698Z" },
 ]
 
 [[package]]
@@ -2185,7 +2187,7 @@ wheels = [
 
 [[package]]
 name = "firecrawl-py"
-version = "4.21.1"
+version = "4.22.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "aiohttp" },
@@ -2196,9 +2198,9 @@ dependencies = [
     { name = "requests" },
     { name = "websockets" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/9c/3e/a2426b461e57f10327ba8ec56511a0ab0a817a433c933380c61b80e9b5c3/firecrawl_py-4.21.1.tar.gz", hash = "sha256:e82eab65ee4d46f38293c30d43e065a78d40ec9efd2872dd543c58e03ea58b54", size = 174335, upload-time = "2026-04-02T18:29:01.975Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/64/87/08cd440a3b942be5983c1a2db921d55697bdb91f7ead9a925b75715039a0/firecrawl_py-4.22.1.tar.gz", hash = "sha256:fb44d4c63ba91c076ae2f0b688f1556327c971baea45e7fb67d6ed5d393542a2", size = 174394, upload-time = "2026-04-07T01:54:19.682Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/f3/ee/b1030a89dc28f0f54bb8bf387333bc67d905920b2165cb0fa94692f3c6b3/firecrawl_py-4.21.1-py3-none-any.whl", hash = "sha256:b54c645ae7cb73f2a683c4448cc0dfc195eea6948ef529be5ba52f0ec2210366", size = 217676, upload-time = "2026-04-02T18:29:00.433Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/a7/54199470a5bf8e09bdf9511f80e766a11b20daafc3b0e1e638ec04e24fc9/firecrawl_py-4.22.1-py3-none-any.whl", hash = "sha256:3df92a7888f9d5907a6fbbe50ade330d2925f5bf51f8efa507c2ab9891df9a0a", size = 217741, upload-time = "2026-04-07T01:54:18.403Z" },
 ]
 
 [[package]]
@@ -2399,7 +2401,8 @@ wheels = [
 
 [package.optional-dependencies]
 grpc = [
-    { name = "grpcio" },
+    { name = "grpcio", version = "1.78.0", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
+    { name = "grpcio", version = "1.80.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
     { name = "grpcio-status" },
 ]
 
@@ -2428,7 +2431,8 @@ source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "google-api-core", extra = ["grpc"] },
     { name = "google-auth" },
-    { name = "grpcio" },
+    { name = "grpcio", version = "1.78.0", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
+    { name = "grpcio", version = "1.80.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
     { name = "proto-plus" },
     { name = "protobuf" },
 ]
@@ -2472,53 +2476,64 @@ wheels = [
 
 [[package]]
 name = "greenlet"
-version = "3.3.2"
+version = "3.4.0"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/a3/51/1664f6b78fc6ebbd98019a1fd730e83fa78f2db7058f72b1463d3612b8db/greenlet-3.3.2.tar.gz", hash = "sha256:2eaf067fc6d886931c7962e8c6bede15d2f01965560f3359b27c80bde2d151f2", size = 188267, upload-time = "2026-02-20T20:54:15.531Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/86/94/a5935717b307d7c71fe877b52b884c6af707d2d2090db118a03fbd799369/greenlet-3.4.0.tar.gz", hash = "sha256:f50a96b64dafd6169e595a5c56c9146ef80333e67d4476a65a9c55f400fc22ff", size = 195913, upload-time = "2026-04-08T17:08:00.863Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/38/3f/9859f655d11901e7b2996c6e3d33e0caa9a1d4572c3bc61ed0faa64b2f4c/greenlet-3.3.2-cp310-cp310-macosx_11_0_universal2.whl", hash = "sha256:9bc885b89709d901859cf95179ec9f6bb67a3d2bb1f0e88456461bd4b7f8fd0d", size = 277747, upload-time = "2026-02-20T20:16:21.325Z" },
-    { url = "https://files.pythonhosted.org/packages/fb/07/cb284a8b5c6498dbd7cba35d31380bb123d7dceaa7907f606c8ff5993cbf/greenlet-3.3.2-cp310-cp310-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b568183cf65b94919be4438dc28416b234b678c608cafac8874dfeeb2a9bbe13", size = 579202, upload-time = "2026-02-20T20:47:28.955Z" },
-    { url = "https://files.pythonhosted.org/packages/ed/45/67922992b3a152f726163b19f890a85129a992f39607a2a53155de3448b8/greenlet-3.3.2-cp310-cp310-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:527fec58dc9f90efd594b9b700662ed3fb2493c2122067ac9c740d98080a620e", size = 590620, upload-time = "2026-02-20T20:55:55.581Z" },
-    { url = "https://files.pythonhosted.org/packages/03/5f/6e2a7d80c353587751ef3d44bb947f0565ec008a2e0927821c007e96d3a7/greenlet-3.3.2-cp310-cp310-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:508c7f01f1791fbc8e011bd508f6794cb95397fdb198a46cb6635eb5b78d85a7", size = 602132, upload-time = "2026-02-20T21:02:43.261Z" },
-    { url = "https://files.pythonhosted.org/packages/ad/55/9f1ebb5a825215fadcc0f7d5073f6e79e3007e3282b14b22d6aba7ca6cb8/greenlet-3.3.2-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ad0c8917dd42a819fe77e6bdfcb84e3379c0de956469301d9fd36427a1ca501f", size = 591729, upload-time = "2026-02-20T20:20:58.395Z" },
-    { url = "https://files.pythonhosted.org/packages/24/b4/21f5455773d37f94b866eb3cf5caed88d6cea6dd2c6e1f9c34f463cba3ec/greenlet-3.3.2-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:97245cc10e5515dbc8c3104b2928f7f02b6813002770cfaffaf9a6e0fc2b94ef", size = 1551946, upload-time = "2026-02-20T20:49:31.102Z" },
-    { url = "https://files.pythonhosted.org/packages/00/68/91f061a926abead128fe1a87f0b453ccf07368666bd59ffa46016627a930/greenlet-3.3.2-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:8c1fdd7d1b309ff0da81d60a9688a8bd044ac4e18b250320a96fc68d31c209ca", size = 1618494, upload-time = "2026-02-20T20:21:06.541Z" },
-    { url = "https://files.pythonhosted.org/packages/ac/78/f93e840cbaef8becaf6adafbaf1319682a6c2d8c1c20224267a5c6c8c891/greenlet-3.3.2-cp310-cp310-win_amd64.whl", hash = "sha256:5d0e35379f93a6d0222de929a25ab47b5eb35b5ef4721c2b9cbcc4036129ff1f", size = 230092, upload-time = "2026-02-20T20:17:09.379Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/47/16400cb42d18d7a6bb46f0626852c1718612e35dcb0dffa16bbaffdf5dd2/greenlet-3.3.2-cp311-cp311-macosx_11_0_universal2.whl", hash = "sha256:c56692189a7d1c7606cb794be0a8381470d95c57ce5be03fb3d0ef57c7853b86", size = 278890, upload-time = "2026-02-20T20:19:39.263Z" },
-    { url = "https://files.pythonhosted.org/packages/a3/90/42762b77a5b6aa96cd8c0e80612663d39211e8ae8a6cd47c7f1249a66262/greenlet-3.3.2-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1ebd458fa8285960f382841da585e02201b53a5ec2bac6b156fc623b5ce4499f", size = 581120, upload-time = "2026-02-20T20:47:30.161Z" },
-    { url = "https://files.pythonhosted.org/packages/bf/6f/f3d64f4fa0a9c7b5c5b3c810ff1df614540d5aa7d519261b53fba55d4df9/greenlet-3.3.2-cp311-cp311-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a443358b33c4ec7b05b79a7c8b466f5d275025e750298be7340f8fc63dff2a55", size = 594363, upload-time = "2026-02-20T20:55:56.965Z" },
-    { url = "https://files.pythonhosted.org/packages/9c/8b/1430a04657735a3f23116c2e0d5eb10220928846e4537a938a41b350bed6/greenlet-3.3.2-cp311-cp311-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:4375a58e49522698d3e70cc0b801c19433021b5c37686f7ce9c65b0d5c8677d2", size = 605046, upload-time = "2026-02-20T21:02:45.234Z" },
-    { url = "https://files.pythonhosted.org/packages/72/83/3e06a52aca8128bdd4dcd67e932b809e76a96ab8c232a8b025b2850264c5/greenlet-3.3.2-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8e2cd90d413acbf5e77ae41e5d3c9b3ac1d011a756d7284d7f3f2b806bbd6358", size = 594156, upload-time = "2026-02-20T20:20:59.955Z" },
-    { url = "https://files.pythonhosted.org/packages/70/79/0de5e62b873e08fe3cef7dbe84e5c4bc0e8ed0c7ff131bccb8405cd107c8/greenlet-3.3.2-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:442b6057453c8cb29b4fb36a2ac689382fc71112273726e2423f7f17dc73bf99", size = 1554649, upload-time = "2026-02-20T20:49:32.293Z" },
-    { url = "https://files.pythonhosted.org/packages/5a/00/32d30dee8389dc36d42170a9c66217757289e2afb0de59a3565260f38373/greenlet-3.3.2-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:45abe8eb6339518180d5a7fa47fa01945414d7cca5ecb745346fc6a87d2750be", size = 1619472, upload-time = "2026-02-20T20:21:07.966Z" },
-    { url = "https://files.pythonhosted.org/packages/f1/3a/efb2cf697fbccdf75b24e2c18025e7dfa54c4f31fab75c51d0fe79942cef/greenlet-3.3.2-cp311-cp311-win_amd64.whl", hash = "sha256:1e692b2dae4cc7077cbb11b47d258533b48c8fde69a33d0d8a82e2fe8d8531d5", size = 230389, upload-time = "2026-02-20T20:17:18.772Z" },
-    { url = "https://files.pythonhosted.org/packages/e1/a1/65bbc059a43a7e2143ec4fc1f9e3f673e04f9c7b371a494a101422ac4fd5/greenlet-3.3.2-cp311-cp311-win_arm64.whl", hash = "sha256:02b0a8682aecd4d3c6c18edf52bc8e51eacdd75c8eac52a790a210b06aa295fd", size = 229645, upload-time = "2026-02-20T20:18:18.695Z" },
-    { url = "https://files.pythonhosted.org/packages/ea/ab/1608e5a7578e62113506740b88066bf09888322a311cff602105e619bd87/greenlet-3.3.2-cp312-cp312-macosx_11_0_universal2.whl", hash = "sha256:ac8d61d4343b799d1e526db579833d72f23759c71e07181c2d2944e429eb09cd", size = 280358, upload-time = "2026-02-20T20:17:43.971Z" },
-    { url = "https://files.pythonhosted.org/packages/a5/23/0eae412a4ade4e6623ff7626e38998cb9b11e9ff1ebacaa021e4e108ec15/greenlet-3.3.2-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3ceec72030dae6ac0c8ed7591b96b70410a8be370b6a477b1dbc072856ad02bd", size = 601217, upload-time = "2026-02-20T20:47:31.462Z" },
-    { url = "https://files.pythonhosted.org/packages/f8/16/5b1678a9c07098ecb9ab2dd159fafaf12e963293e61ee8d10ecb55273e5e/greenlet-3.3.2-cp312-cp312-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a2a5be83a45ce6188c045bcc44b0ee037d6a518978de9a5d97438548b953a1ac", size = 611792, upload-time = "2026-02-20T20:55:58.423Z" },
-    { url = "https://files.pythonhosted.org/packages/5c/c5/cc09412a29e43406eba18d61c70baa936e299bc27e074e2be3806ed29098/greenlet-3.3.2-cp312-cp312-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:ae9e21c84035c490506c17002f5c8ab25f980205c3e61ddb3a2a2a2e6c411fcb", size = 626250, upload-time = "2026-02-20T21:02:46.596Z" },
-    { url = "https://files.pythonhosted.org/packages/50/1f/5155f55bd71cabd03765a4aac9ac446be129895271f73872c36ebd4b04b6/greenlet-3.3.2-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:43e99d1749147ac21dde49b99c9abffcbc1e2d55c67501465ef0930d6e78e070", size = 613875, upload-time = "2026-02-20T20:21:01.102Z" },
-    { url = "https://files.pythonhosted.org/packages/fc/dd/845f249c3fcd69e32df80cdab059b4be8b766ef5830a3d0aa9d6cad55beb/greenlet-3.3.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:4c956a19350e2c37f2c48b336a3afb4bff120b36076d9d7fb68cb44e05d95b79", size = 1571467, upload-time = "2026-02-20T20:49:33.495Z" },
-    { url = "https://files.pythonhosted.org/packages/2a/50/2649fe21fcc2b56659a452868e695634722a6655ba245d9f77f5656010bf/greenlet-3.3.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:6c6f8ba97d17a1e7d664151284cb3315fc5f8353e75221ed4324f84eb162b395", size = 1640001, upload-time = "2026-02-20T20:21:09.154Z" },
-    { url = "https://files.pythonhosted.org/packages/9b/40/cc802e067d02af8b60b6771cea7d57e21ef5e6659912814babb42b864713/greenlet-3.3.2-cp312-cp312-win_amd64.whl", hash = "sha256:34308836d8370bddadb41f5a7ce96879b72e2fdfb4e87729330c6ab52376409f", size = 231081, upload-time = "2026-02-20T20:17:28.121Z" },
-    { url = "https://files.pythonhosted.org/packages/58/2e/fe7f36ff1982d6b10a60d5e0740c759259a7d6d2e1dc41da6d96de32fff6/greenlet-3.3.2-cp312-cp312-win_arm64.whl", hash = "sha256:d3a62fa76a32b462a97198e4c9e99afb9ab375115e74e9a83ce180e7a496f643", size = 230331, upload-time = "2026-02-20T20:17:23.34Z" },
-    { url = "https://files.pythonhosted.org/packages/ac/48/f8b875fa7dea7dd9b33245e37f065af59df6a25af2f9561efa8d822fde51/greenlet-3.3.2-cp313-cp313-macosx_11_0_universal2.whl", hash = "sha256:aa6ac98bdfd716a749b84d4034486863fd81c3abde9aa3cf8eff9127981a4ae4", size = 279120, upload-time = "2026-02-20T20:19:01.9Z" },
-    { url = "https://files.pythonhosted.org/packages/49/8d/9771d03e7a8b1ee456511961e1b97a6d77ae1dea4a34a5b98eee706689d3/greenlet-3.3.2-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ab0c7e7901a00bc0a7284907273dc165b32e0d109a6713babd04471327ff7986", size = 603238, upload-time = "2026-02-20T20:47:32.873Z" },
-    { url = "https://files.pythonhosted.org/packages/59/0e/4223c2bbb63cd5c97f28ffb2a8aee71bdfb30b323c35d409450f51b91e3e/greenlet-3.3.2-cp313-cp313-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:d248d8c23c67d2291ffd47af766e2a3aa9fa1c6703155c099feb11f526c63a92", size = 614219, upload-time = "2026-02-20T20:55:59.817Z" },
-    { url = "https://files.pythonhosted.org/packages/94/2b/4d012a69759ac9d77210b8bfb128bc621125f5b20fc398bce3940d036b1c/greenlet-3.3.2-cp313-cp313-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:ccd21bb86944ca9be6d967cf7691e658e43417782bce90b5d2faeda0ff78a7dd", size = 628268, upload-time = "2026-02-20T21:02:48.024Z" },
-    { url = "https://files.pythonhosted.org/packages/7a/34/259b28ea7a2a0c904b11cd36c79b8cef8019b26ee5dbe24e73b469dea347/greenlet-3.3.2-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b6997d360a4e6a4e936c0f9625b1c20416b8a0ea18a8e19cabbefc712e7397ab", size = 616774, upload-time = "2026-02-20T20:21:02.454Z" },
-    { url = "https://files.pythonhosted.org/packages/0a/03/996c2d1689d486a6e199cb0f1cf9e4aa940c500e01bdf201299d7d61fa69/greenlet-3.3.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:64970c33a50551c7c50491671265d8954046cb6e8e2999aacdd60e439b70418a", size = 1571277, upload-time = "2026-02-20T20:49:34.795Z" },
-    { url = "https://files.pythonhosted.org/packages/d9/c4/2570fc07f34a39f2caf0bf9f24b0a1a0a47bc2e8e465b2c2424821389dfc/greenlet-3.3.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:1a9172f5bf6bd88e6ba5a84e0a68afeac9dc7b6b412b245dd64f52d83c81e55b", size = 1640455, upload-time = "2026-02-20T20:21:10.261Z" },
-    { url = "https://files.pythonhosted.org/packages/91/39/5ef5aa23bc545aa0d31e1b9b55822b32c8da93ba657295840b6b34124009/greenlet-3.3.2-cp313-cp313-win_amd64.whl", hash = "sha256:a7945dd0eab63ded0a48e4dcade82939783c172290a7903ebde9e184333ca124", size = 230961, upload-time = "2026-02-20T20:16:58.461Z" },
-    { url = "https://files.pythonhosted.org/packages/62/6b/a89f8456dcb06becff288f563618e9f20deed8dd29beea14f9a168aef64b/greenlet-3.3.2-cp313-cp313-win_arm64.whl", hash = "sha256:394ead29063ee3515b4e775216cb756b2e3b4a7e55ae8fd884f17fa579e6b327", size = 230221, upload-time = "2026-02-20T20:17:37.152Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/bc/e30e1e3d5e8860b0e0ce4d2b16b2681b77fd13542fc0d72f7e3c22d16eff/greenlet-3.4.0-cp310-cp310-macosx_11_0_universal2.whl", hash = "sha256:d18eae9a7fb0f499efcd146b8c9750a2e1f6e0e93b5a382b3481875354a430e6", size = 284315, upload-time = "2026-04-08T17:02:52.322Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/cc/e023ae1967d2a26737387cac083e99e47f65f58868bd155c4c80c01ec4e0/greenlet-3.4.0-cp310-cp310-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:636d2f95c309e35f650e421c23297d5011716be15d966e6328b367c9fc513a82", size = 601916, upload-time = "2026-04-08T16:24:35.533Z" },
+    { url = "https://files.pythonhosted.org/packages/67/32/5be1677954b6d8810b33abe94e3eb88726311c58fa777dc97e390f7caf5a/greenlet-3.4.0-cp310-cp310-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:234582c20af9742583c3b2ddfbdbb58a756cfff803763ffaae1ac7990a9fac31", size = 616399, upload-time = "2026-04-08T16:30:54.536Z" },
+    { url = "https://files.pythonhosted.org/packages/82/0a/3a4af092b09ea02bcda30f33fd7db397619132fe52c6ece24b9363130d34/greenlet-3.4.0-cp310-cp310-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:ac6a5f618be581e1e0713aecec8e54093c235e5fa17d6d8eb7ffc487e2300508", size = 621077, upload-time = "2026-04-08T16:40:34.946Z" },
+    { url = "https://files.pythonhosted.org/packages/74/bf/2d58d5ea515704f83e34699128c9072a34bea27d2b6a556e102105fe62a5/greenlet-3.4.0-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:523677e69cd4711b5a014e37bc1fb3a29947c3e3a5bb6a527e1cc50312e5a398", size = 611978, upload-time = "2026-04-08T15:56:31.335Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/39/3786520a7d5e33ee87b3da2531f589a3882abf686a42a3773183a41ef010/greenlet-3.4.0-cp310-cp310-manylinux_2_39_riscv64.whl", hash = "sha256:d336d46878e486de7d9458653c722875547ac8d36a1cff9ffaf4a74a3c1f62eb", size = 416893, upload-time = "2026-04-08T16:43:02.392Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/69/6525049b6c179d8a923256304d8387b8bdd4acab1acf0407852463c6d514/greenlet-3.4.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:b45e45fe47a19051a396abb22e19e7836a59ee6c5a90f3be427343c37908d65b", size = 1571957, upload-time = "2026-04-08T16:26:17.041Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/6c/bbfb798b05fec736a0d24dc23e81b45bcee87f45a83cfb39db031853bddc/greenlet-3.4.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:5434271357be07f3ad0936c312645853b7e689e679e29310e2de09a9ea6c3adf", size = 1637223, upload-time = "2026-04-08T15:57:27.556Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/7d/981fe0e7c07bd9d5e7eb18decb8590a11e3955878291f7a7de2e9c668eb7/greenlet-3.4.0-cp310-cp310-win_amd64.whl", hash = "sha256:a19093fbad824ed7c0f355b5ff4214bffda5f1a7f35f29b31fcaa240cc0135ab", size = 237902, upload-time = "2026-04-08T17:03:14.16Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/c6/dba32cab7e3a625b011aa5647486e2d28423a48845a2998c126dd69c85e1/greenlet-3.4.0-cp311-cp311-macosx_11_0_universal2.whl", hash = "sha256:805bebb4945094acbab757d34d6e1098be6de8966009ab9ca54f06ff492def58", size = 285504, upload-time = "2026-04-08T15:52:14.071Z" },
+    { url = "https://files.pythonhosted.org/packages/54/f4/7cb5c2b1feb9a1f50e038be79980dfa969aa91979e5e3a18fdbcfad2c517/greenlet-3.4.0-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:439fc2f12b9b512d9dfa681c5afe5f6b3232c708d13e6f02c845e0d9f4c2d8c6", size = 605476, upload-time = "2026-04-08T16:24:37.064Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/af/b66ab0b2f9a4c5a867c136bf66d9599f34f21a1bcca26a2884a29c450bd9/greenlet-3.4.0-cp311-cp311-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a70ed1cb0295bee1df57b63bf7f46b4e56a5c93709eea769c1fec1bb23a95875", size = 618336, upload-time = "2026-04-08T16:30:56.59Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/31/56c43d2b5de476f77d36ceeec436328533bff960a4cba9a07616e93063ab/greenlet-3.4.0-cp311-cp311-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:8c5696c42e6bb5cfb7c6ff4453789081c66b9b91f061e5e9367fa15792644e76", size = 625045, upload-time = "2026-04-08T16:40:37.111Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/5c/8c5633ece6ba611d64bf2770219a98dd439921d6424e4e8cf16b0ac74ea5/greenlet-3.4.0-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c660bce1940a1acae5f51f0a064f1bc785d07ea16efcb4bc708090afc4d69e83", size = 613515, upload-time = "2026-04-08T15:56:32.478Z" },
+    { url = "https://files.pythonhosted.org/packages/80/ca/704d4e2c90acb8bdf7ae593f5cbc95f58e82de95cc540fb75631c1054533/greenlet-3.4.0-cp311-cp311-manylinux_2_39_riscv64.whl", hash = "sha256:89995ce5ddcd2896d89615116dd39b9703bfa0c07b583b85b89bf1b5d6eddf81", size = 419745, upload-time = "2026-04-08T16:43:04.022Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/df/950d15bca0d90a0e7395eb777903060504cdb509b7b705631e8fb69ff415/greenlet-3.4.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:ee407d4d1ca9dc632265aee1c8732c4a2d60adff848057cdebfe5fe94eb2c8a2", size = 1574623, upload-time = "2026-04-08T16:26:18.596Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/e7/0839afab829fcb7333c9ff6d80c040949510055d2d4d63251f0d1c7c804e/greenlet-3.4.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:956215d5e355fffa7c021d168728321fd4d31fd730ac609b1653b450f6a4bc71", size = 1639579, upload-time = "2026-04-08T15:57:29.231Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/2b/b4482401e9bcaf9f5c97f67ead38db89c19520ff6d0d6699979c6efcc200/greenlet-3.4.0-cp311-cp311-win_amd64.whl", hash = "sha256:5cb614ace7c27571270354e9c9f696554d073f8aa9319079dcba466bbdead711", size = 238233, upload-time = "2026-04-08T17:02:54.286Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/4d/d8123a4e0bcd583d5cfc8ddae0bbe29c67aab96711be331a7cc935a35966/greenlet-3.4.0-cp311-cp311-win_arm64.whl", hash = "sha256:04403ac74fe295a361f650818de93be11b5038a78f49ccfb64d3b1be8fbf1267", size = 235045, upload-time = "2026-04-08T17:04:05.072Z" },
+    { url = "https://files.pythonhosted.org/packages/65/8b/3669ad3b3f247a791b2b4aceb3aa5a31f5f6817bf547e4e1ff712338145a/greenlet-3.4.0-cp312-cp312-macosx_11_0_universal2.whl", hash = "sha256:1a54a921561dd9518d31d2d3db4d7f80e589083063ab4d3e2e950756ef809e1a", size = 286902, upload-time = "2026-04-08T15:52:12.138Z" },
+    { url = "https://files.pythonhosted.org/packages/38/3e/3c0e19b82900873e2d8469b590a6c4b3dfd2b316d0591f1c26b38a4879a5/greenlet-3.4.0-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:16dec271460a9a2b154e3b1c2fa1050ce6280878430320e85e08c166772e3f97", size = 606099, upload-time = "2026-04-08T16:24:38.408Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/33/99fef65e7754fc76a4ed14794074c38c9ed3394a5bd129d7f61b705f3168/greenlet-3.4.0-cp312-cp312-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:90036ce224ed6fe75508c1907a77e4540176dcf0744473627785dd519c6f9996", size = 618837, upload-time = "2026-04-08T16:30:58.298Z" },
+    { url = "https://files.pythonhosted.org/packages/44/57/eae2cac10421feae6c0987e3dc106c6d86262b1cb379e171b017aba893a6/greenlet-3.4.0-cp312-cp312-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:6f0def07ec9a71d72315cf26c061aceee53b306c36ed38c35caba952ea1b319d", size = 624901, upload-time = "2026-04-08T16:40:38.981Z" },
+    { url = "https://files.pythonhosted.org/packages/36/f7/229f3aed6948faa20e0616a0b8568da22e365ede6a54d7d369058b128afd/greenlet-3.4.0-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a1c4f6b453006efb8310affb2d132832e9bbb4fc01ce6df6b70d810d38f1f6dc", size = 615062, upload-time = "2026-04-08T15:56:33.766Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/8a/0e73c9b94f31d1cc257fe79a0eff621674141cdae7d6d00f40de378a1e42/greenlet-3.4.0-cp312-cp312-manylinux_2_39_riscv64.whl", hash = "sha256:0e1254cf0cbaa17b04320c3a78575f29f3c161ef38f59c977108f19ffddaf077", size = 423927, upload-time = "2026-04-08T16:43:05.293Z" },
+    { url = "https://files.pythonhosted.org/packages/08/97/d988180011aa40135c46cd0d0cf01dd97f7162bae14139b4a3ef54889ba5/greenlet-3.4.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:9b2d9a138ffa0e306d0e2b72976d2fb10b97e690d40ab36a472acaab0838e2de", size = 1573511, upload-time = "2026-04-08T16:26:20.058Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/0f/a5a26fe152fb3d12e6a474181f6e9848283504d0afd095f353d85726374b/greenlet-3.4.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:8424683caf46eb0eb6f626cb95e008e8cc30d0cb675bdfa48200925c79b38a08", size = 1640396, upload-time = "2026-04-08T15:57:30.88Z" },
+    { url = "https://files.pythonhosted.org/packages/42/cf/bb2c32d9a100e36ee9f6e38fad6b1e082b8184010cb06259b49e1266ca01/greenlet-3.4.0-cp312-cp312-win_amd64.whl", hash = "sha256:a0a53fb071531d003b075c444014ff8f8b1a9898d36bb88abd9ac7b3524648a2", size = 238892, upload-time = "2026-04-08T17:03:10.094Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/47/6c41314bac56e71436ce551c7fbe3cc830ed857e6aa9708dbb9c65142eb6/greenlet-3.4.0-cp312-cp312-win_arm64.whl", hash = "sha256:f38b81880ba28f232f1f675893a39cf7b6db25b31cc0a09bb50787ecf957e85e", size = 235599, upload-time = "2026-04-08T15:52:54.3Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/75/7e9cd1126a1e1f0cd67b0eda02e5221b28488d352684704a78ed505bd719/greenlet-3.4.0-cp313-cp313-macosx_11_0_universal2.whl", hash = "sha256:43748988b097f9c6f09364f260741aa73c80747f63389824435c7a50bfdfd5c1", size = 285856, upload-time = "2026-04-08T15:52:45.82Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/c4/3e2df392e5cb199527c4d9dbcaa75c14edcc394b45040f0189f649631e3c/greenlet-3.4.0-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5566e4e2cd7a880e8c27618e3eab20f3494452d12fd5129edef7b2f7aa9a36d1", size = 610208, upload-time = "2026-04-08T16:24:39.674Z" },
+    { url = "https://files.pythonhosted.org/packages/da/af/750cdfda1d1bd30a6c28080245be8d0346e669a98fdbae7f4102aa95fff3/greenlet-3.4.0-cp313-cp313-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:1054c5a3c78e2ab599d452f23f7adafef55062a783a8e241d24f3b633ba6ff82", size = 621269, upload-time = "2026-04-08T16:30:59.767Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/93/c8c508d68ba93232784bbc1b5474d92371f2897dfc6bc281b419f2e0d492/greenlet-3.4.0-cp313-cp313-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:98eedd1803353daf1cd9ef23eef23eda5a4d22f99b1f998d273a8b78b70dd47f", size = 628455, upload-time = "2026-04-08T16:40:40.698Z" },
+    { url = "https://files.pythonhosted.org/packages/54/78/0cbc693622cd54ebe25207efbb3a0eb07c2639cb8594f6e3aaaa0bb077a8/greenlet-3.4.0-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f82cb6cddc27dd81c96b1506f4aa7def15070c3b2a67d4e46fd19016aacce6cf", size = 617549, upload-time = "2026-04-08T15:56:34.893Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/46/cfaaa0ade435a60550fd83d07dfd5c41f873a01da17ede5c4cade0b9bab8/greenlet-3.4.0-cp313-cp313-manylinux_2_39_riscv64.whl", hash = "sha256:b7857e2202aae67bc5725e0c1f6403c20a8ff46094ece015e7d474f5f7020b55", size = 426238, upload-time = "2026-04-08T16:43:06.865Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/c0/8966767de01343c1ff47e8b855dc78e7d1a8ed2b7b9c83576a57e289f81d/greenlet-3.4.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:227a46251ecba4ff46ae742bc5ce95c91d5aceb4b02f885487aff269c127a729", size = 1575310, upload-time = "2026-04-08T16:26:21.671Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/38/bcdc71ba05e9a5fda87f63ffc2abcd1f15693b659346df994a48c968003d/greenlet-3.4.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:5b99e87be7eba788dd5b75ba1cde5639edffdec5f91fe0d734a249535ec3408c", size = 1640435, upload-time = "2026-04-08T15:57:32.572Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/c2/19b664b7173b9e4ef5f77e8cef9f14c20ec7fce7920dc1ccd7afd955d093/greenlet-3.4.0-cp313-cp313-win_amd64.whl", hash = "sha256:849f8bc17acd6295fcb5de8e46d55cc0e52381c56eaf50a2afd258e97bc65940", size = 238760, upload-time = "2026-04-08T17:04:03.878Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/96/795619651d39c7fbd809a522f881aa6f0ead504cc8201c3a5b789dfaef99/greenlet-3.4.0-cp313-cp313-win_arm64.whl", hash = "sha256:9390ad88b652b1903814eaabd629ca184db15e0eeb6fe8a390bbf8b9106ae15a", size = 235498, upload-time = "2026-04-08T17:05:00.584Z" },
 ]
 
 [[package]]
 name = "grpcio"
 version = "1.78.0"
 source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.13' and platform_machine == 's390x'",
+    "python_full_version == '3.12.*' and platform_machine != 's390x'",
+    "python_full_version == '3.12.*' and platform_machine == 's390x'",
+    "python_full_version == '3.11.*' and platform_machine != 's390x'",
+    "python_full_version == '3.11.*' and platform_machine == 's390x'",
+]
 dependencies = [
-    { name = "typing-extensions" },
+    { name = "typing-extensions", marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/06/8a/3d098f35c143a89520e568e6539cc098fcd294495910e359889ce8741c84/grpcio-1.78.0.tar.gz", hash = "sha256:7382b95189546f375c174f53a5fa873cef91c4b8005faa05cc5b3beea9c4f1c5", size = 12852416, upload-time = "2026-02-06T09:57:18.093Z" }
 wheels = [
@@ -2564,13 +2579,83 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/4d/27/d86b89e36de8a951501fb06a0f38df19853210f341d0b28f83f4aa0ffa08/grpcio-1.78.0-cp313-cp313-win_amd64.whl", hash = "sha256:f2d4e43ee362adfc05994ed479334d5a451ab7bc3f3fee1b796b8ca66895acb4", size = 4797393, upload-time = "2026-02-06T09:56:17.882Z" },
 ]
 
+[[package]]
+name = "grpcio"
+version = "1.80.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.13' and platform_machine != 's390x'",
+    "python_full_version < '3.11' and platform_machine != 's390x'",
+    "python_full_version < '3.11' and platform_machine == 's390x'",
+]
+dependencies = [
+    { name = "typing-extensions", marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b7/48/af6173dbca4454f4637a4678b67f52ca7e0c1ed7d5894d89d434fecede05/grpcio-1.80.0.tar.gz", hash = "sha256:29aca15edd0688c22ba01d7cc01cb000d72b2033f4a3c72a81a19b56fd143257", size = 12978905, upload-time = "2026-03-30T08:49:10.502Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9d/cd/bb7b7e54084a344c03d68144450da7ddd5564e51a298ae1662de65f48e2d/grpcio-1.80.0-cp310-cp310-linux_armv7l.whl", hash = "sha256:886457a7768e408cdce226ad1ca67d2958917d306523a0e21e1a2fdaa75c9c9c", size = 6050363, upload-time = "2026-03-30T08:46:20.894Z" },
+    { url = "https://files.pythonhosted.org/packages/16/02/1417f5c3460dea65f7a2e3c14e8b31e77f7ffb730e9bfadd89eda7a9f477/grpcio-1.80.0-cp310-cp310-macosx_11_0_universal2.whl", hash = "sha256:7b641fc3f1dc647bfd80bd713addc68f6d145956f64677e56d9ebafc0bd72388", size = 12026037, upload-time = "2026-03-30T08:46:25.144Z" },
+    { url = "https://files.pythonhosted.org/packages/43/98/c910254eedf2cae368d78336a2de0678e66a7317d27c02522392f949b5c6/grpcio-1.80.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:33eb763f18f006dc7fee1e69831d38d23f5eccd15b2e0f92a13ee1d9242e5e02", size = 6602306, upload-time = "2026-03-30T08:46:27.593Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/f8/88ca4e78c077b2b2113d95da1e1ab43efd43d723c9a0397d26529c2c1a56/grpcio-1.80.0-cp310-cp310-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:52d143637e3872633fc7dd7c3c6a1c84e396b359f3a72e215f8bf69fd82084fc", size = 7301535, upload-time = "2026-03-30T08:46:29.556Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/96/f28660fe2fe0f153288bf4a04e4910b7309d442395135c88ed4f5b3b8b40/grpcio-1.80.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:c51bf8ac4575af2e0678bccfb07e47321fc7acb5049b4482832c5c195e04e13a", size = 6808669, upload-time = "2026-03-30T08:46:31.984Z" },
+    { url = "https://files.pythonhosted.org/packages/47/eb/3f68a5e955779c00aeef23850e019c1c1d0e032d90633ba49c01ad5a96e0/grpcio-1.80.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:50a9871536d71c4fba24ee856abc03a87764570f0c457dd8db0b4018f379fed9", size = 7409489, upload-time = "2026-03-30T08:46:34.684Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/a7/d2f681a4bfb881be40659a309771f3bdfbfdb1190619442816c3f0ffc079/grpcio-1.80.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:a72d84ad0514db063e21887fbacd1fd7acb4d494a564cae22227cd45c7fbf199", size = 8423167, upload-time = "2026-03-30T08:46:36.833Z" },
+    { url = "https://files.pythonhosted.org/packages/97/8a/29b4589c204959aa35ce5708400a05bba72181807c45c47b3ec000c39333/grpcio-1.80.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:f7691a6788ad9196872f95716df5bc643ebba13c97140b7a5ee5c8e75d1dea81", size = 7846761, upload-time = "2026-03-30T08:46:40.091Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/d2/ed143e097230ee121ac5848f6ff14372dba91289b10b536d54fb1b7cbae7/grpcio-1.80.0-cp310-cp310-win32.whl", hash = "sha256:46c2390b59d67f84e882694d489f5b45707c657832d7934859ceb8c33f467069", size = 4156534, upload-time = "2026-03-30T08:46:42.026Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/c9/df8279bb49b29409995e95efa85b72973d62f8aeff89abee58c91f393710/grpcio-1.80.0-cp310-cp310-win_amd64.whl", hash = "sha256:dc053420fc75749c961e2a4c906398d7c15725d36ccc04ae6d16093167223b58", size = 4889869, upload-time = "2026-03-30T08:46:44.219Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/db/1d56e5f5823257b291962d6c0ce106146c6447f405b60b234c4f222a7cde/grpcio-1.80.0-cp311-cp311-linux_armv7l.whl", hash = "sha256:dfab85db094068ff42e2a3563f60ab3dddcc9d6488a35abf0132daec13209c8a", size = 6055009, upload-time = "2026-03-30T08:46:46.265Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/18/c83f3cad64c5ca63bca7e91e5e46b0d026afc5af9d0a9972472ceba294b3/grpcio-1.80.0-cp311-cp311-macosx_11_0_universal2.whl", hash = "sha256:5c07e82e822e1161354e32da2662f741a4944ea955f9f580ec8fb409dd6f6060", size = 12035295, upload-time = "2026-03-30T08:46:49.099Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/8e/e14966b435be2dda99fbe89db9525ea436edc79780431a1c2875a3582644/grpcio-1.80.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:ba0915d51fd4ced2db5ff719f84e270afe0e2d4c45a7bdb1e8d036e4502928c2", size = 6610297, upload-time = "2026-03-30T08:46:52.123Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/26/d5eb38f42ce0e3fdc8174ea4d52036ef8d58cc4426cb800f2610f625dd75/grpcio-1.80.0-cp311-cp311-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:3cb8130ba457d2aa09fa6b7c3ed6b6e4e6a2685fce63cb803d479576c4d80e21", size = 7300208, upload-time = "2026-03-30T08:46:54.859Z" },
+    { url = "https://files.pythonhosted.org/packages/25/51/bd267c989f85a17a5b3eea65a6feb4ff672af41ca614e5a0279cc0ea381c/grpcio-1.80.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:09e5e478b3d14afd23f12e49e8b44c8684ac3c5f08561c43a5b9691c54d136ab", size = 6813442, upload-time = "2026-03-30T08:46:57.056Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/d9/d80eef735b19e9169e30164bbf889b46f9df9127598a83d174eb13a48b26/grpcio-1.80.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:00168469238b022500e486c1c33916acf2f2a9b2c022202cf8a1885d2e3073c1", size = 7414743, upload-time = "2026-03-30T08:46:59.682Z" },
+    { url = "https://files.pythonhosted.org/packages/de/f2/567f5bd5054398ed6b0509b9a30900376dcf2786bd936812098808b49d8d/grpcio-1.80.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:8502122a3cc1714038e39a0b071acb1207ca7844208d5ea0d091317555ee7106", size = 8426046, upload-time = "2026-03-30T08:47:02.474Z" },
+    { url = "https://files.pythonhosted.org/packages/62/29/73ef0141b4732ff5eacd68430ff2512a65c004696997f70476a83e548e7e/grpcio-1.80.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:ce1794f4ea6cc3ca29463f42d665c32ba1b964b48958a66497917fe9069f26e6", size = 7851641, upload-time = "2026-03-30T08:47:05.462Z" },
+    { url = "https://files.pythonhosted.org/packages/46/69/abbfa360eb229a8623bab5f5a4f8105e445bd38ce81a89514ba55d281ad0/grpcio-1.80.0-cp311-cp311-win32.whl", hash = "sha256:51b4a7189b0bef2aa30adce3c78f09c83526cf3dddb24c6a96555e3b97340440", size = 4154368, upload-time = "2026-03-30T08:47:08.027Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/d4/ae92206d01183b08613e846076115f5ac5991bae358d2a749fa864da5699/grpcio-1.80.0-cp311-cp311-win_amd64.whl", hash = "sha256:02e64bb0bb2da14d947a49e6f120a75e947250aebe65f9629b62bb1f5c14e6e9", size = 4894235, upload-time = "2026-03-30T08:47:10.839Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/e8/a2b749265eb3415abc94f2e619bbd9e9707bebdda787e61c593004ec927a/grpcio-1.80.0-cp312-cp312-linux_armv7l.whl", hash = "sha256:c624cc9f1008361014378c9d776de7182b11fe8b2e5a81bc69f23a295f2a1ad0", size = 6015616, upload-time = "2026-03-30T08:47:13.428Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/97/b1282161a15d699d1e90c360df18d19165a045ce1c343c7f313f5e8a0b77/grpcio-1.80.0-cp312-cp312-macosx_11_0_universal2.whl", hash = "sha256:f49eddcac43c3bf350c0385366a58f36bed8cc2c0ec35ef7b74b49e56552c0c2", size = 12014204, upload-time = "2026-03-30T08:47:15.873Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/5e/d319c6e997b50c155ac5a8cb12f5173d5b42677510e886d250d50264949d/grpcio-1.80.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d334591df610ab94714048e0d5b4f3dd5ad1bee74dfec11eee344220077a79de", size = 6563866, upload-time = "2026-03-30T08:47:18.588Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/f6/fdd975a2cb4d78eb67769a7b3b3830970bfa2e919f1decf724ae4445f42c/grpcio-1.80.0-cp312-cp312-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:0cb517eb1d0d0aaf1d87af7cc5b801d686557c1d88b2619f5e31fab3c2315921", size = 7273060, upload-time = "2026-03-30T08:47:21.113Z" },
+    { url = "https://files.pythonhosted.org/packages/db/f0/a3deb5feba60d9538a962913e37bd2e69a195f1c3376a3dd44fe0427e996/grpcio-1.80.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:4e78c4ac0d97dc2e569b2f4bcbbb447491167cb358d1a389fc4af71ab6f70411", size = 6782121, upload-time = "2026-03-30T08:47:23.827Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/84/36c6dcfddc093e108141f757c407902a05085e0c328007cb090d56646cdf/grpcio-1.80.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:2ed770b4c06984f3b47eb0517b1c69ad0b84ef3f40128f51448433be904634cd", size = 7383811, upload-time = "2026-03-30T08:47:26.517Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/ef/f3a77e3dc5b471a0ec86c564c98d6adfa3510d38f8ee99010410858d591e/grpcio-1.80.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:256507e2f524092f1473071a05e65a5b10d84b82e3ff24c5b571513cfaa61e2f", size = 8393860, upload-time = "2026-03-30T08:47:29.439Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/8d/9d4d27ed7f33d109c50d6b5ce578a9914aa68edab75d65869a17e630a8d1/grpcio-1.80.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:9a6284a5d907c37db53350645567c522be314bac859a64a7a5ca63b77bb7958f", size = 7830132, upload-time = "2026-03-30T08:47:33.254Z" },
+    { url = "https://files.pythonhosted.org/packages/14/e4/9990b41c6d7a44e1e9dee8ac11d7a9802ba1378b40d77468a7761d1ad288/grpcio-1.80.0-cp312-cp312-win32.whl", hash = "sha256:c71309cfce2f22be26aa4a847357c502db6c621f1a49825ae98aa0907595b193", size = 4140904, upload-time = "2026-03-30T08:47:35.319Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/2c/296f6138caca1f4b92a31ace4ae1b87dab692fc16a7a3417af3bb3c805bf/grpcio-1.80.0-cp312-cp312-win_amd64.whl", hash = "sha256:9fe648599c0e37594c4809d81a9e77bd138cc82eb8baa71b6a86af65426723ff", size = 4880944, upload-time = "2026-03-30T08:47:37.831Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/3a/7c3c25789e3f069e581dc342e03613c5b1cb012c4e8c7d9d5cf960a75856/grpcio-1.80.0-cp313-cp313-linux_armv7l.whl", hash = "sha256:e9e408fc016dffd20661f0126c53d8a31c2821b5c13c5d67a0f5ed5de93319ad", size = 6017243, upload-time = "2026-03-30T08:47:40.075Z" },
+    { url = "https://files.pythonhosted.org/packages/04/19/21a9806eb8240e174fd1ab0cd5b9aa948bb0e05c2f2f55f9d5d7405e6d08/grpcio-1.80.0-cp313-cp313-macosx_11_0_universal2.whl", hash = "sha256:92d787312e613754d4d8b9ca6d3297e69994a7912a32fa38c4c4e01c272974b0", size = 12010840, upload-time = "2026-03-30T08:47:43.11Z" },
+    { url = "https://files.pythonhosted.org/packages/18/3a/23347d35f76f639e807fb7a36fad3068aed100996849a33809591f26eca6/grpcio-1.80.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:8ac393b58aa16991a2f1144ec578084d544038c12242da3a215966b512904d0f", size = 6567644, upload-time = "2026-03-30T08:47:46.806Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/40/96e07ecb604a6a67ae6ab151e3e35b132875d98bc68ec65f3e5ab3e781d7/grpcio-1.80.0-cp313-cp313-manylinux2014_i686.manylinux_2_17_i686.whl", hash = "sha256:68e5851ac4b9afe07e7f84483803ad167852570d65326b34d54ca560bfa53fb6", size = 7277830, upload-time = "2026-03-30T08:47:49.643Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/e2/da1506ecea1f34a5e365964644b35edef53803052b763ca214ba3870c856/grpcio-1.80.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:873ff5d17d68992ef6605330127425d2fc4e77e612fa3c3e0ed4e668685e3140", size = 6783216, upload-time = "2026-03-30T08:47:52.817Z" },
+    { url = "https://files.pythonhosted.org/packages/44/83/3b20ff58d0c3b7f6caaa3af9a4174d4023701df40a3f39f7f1c8e7c48f9d/grpcio-1.80.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:2bea16af2750fd0a899bf1abd9022244418b55d1f37da2202249ba4ba673838d", size = 7385866, upload-time = "2026-03-30T08:47:55.687Z" },
+    { url = "https://files.pythonhosted.org/packages/47/45/55c507599c5520416de5eefecc927d6a0d7af55e91cfffb2e410607e5744/grpcio-1.80.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:ba0db34f7e1d803a878284cd70e4c63cb6ae2510ba51937bf8f45ba997cefcf7", size = 8391602, upload-time = "2026-03-30T08:47:58.303Z" },
+    { url = "https://files.pythonhosted.org/packages/10/bb/dd06f4c24c01db9cf11341b547d0a016b2c90ed7dbbb086a5710df7dd1d7/grpcio-1.80.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:8eb613f02d34721f1acf3626dfdb3545bd3c8505b0e52bf8b5710a28d02e8aa7", size = 7826752, upload-time = "2026-03-30T08:48:01.311Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/1e/9d67992ba23371fd63d4527096eb8c6b76d74d52b500df992a3343fd7251/grpcio-1.80.0-cp313-cp313-win32.whl", hash = "sha256:93b6f823810720912fd131f561f91f5fed0fda372b6b7028a2681b8194d5d294", size = 4142310, upload-time = "2026-03-30T08:48:04.594Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/e6/283326a27da9e2c3038bc93eeea36fb118ce0b2d03922a9cda6688f53c5b/grpcio-1.80.0-cp313-cp313-win_amd64.whl", hash = "sha256:e172cf795a3ba5246d3529e4d34c53db70e888fa582a8ffebd2e6e48bc0cba50", size = 4882833, upload-time = "2026-03-30T08:48:07.363Z" },
+]
+
+[[package]]
+name = "grpcio-health-checking"
+version = "1.71.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "grpcio", version = "1.80.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
+    { name = "protobuf", marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/53/86/20994347ef36b7626fb74539f13128100dd8b7eaac67efc063264e6cdc80/grpcio_health_checking-1.71.2.tar.gz", hash = "sha256:1c21ece88c641932f432b573ef504b20603bdf030ad4e1ec35dd7fdb4ea02637", size = 16770, upload-time = "2025-06-28T04:24:08.768Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1a/74/7bc6ab96bf1083cab2684f9c3ae434caa638de3d5c5574e8435e2c146598/grpcio_health_checking-1.71.2-py3-none-any.whl", hash = "sha256:f91db41410d6bd18a7828c5b6ac2bebd77a63483263cbe42bf3c0c9b86cece33", size = 18918, upload-time = "2025-06-28T04:23:56.923Z" },
+]
+
 [[package]]
 name = "grpcio-status"
 version = "1.71.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "googleapis-common-protos" },
-    { name = "grpcio" },
+    { name = "grpcio", version = "1.78.0", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
+    { name = "grpcio", version = "1.80.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
     { name = "protobuf" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/fd/d1/b6e9877fedae3add1afdeae1f89d1927d296da9cf977eca0eb08fb8a460e/grpcio_status-1.71.2.tar.gz", hash = "sha256:c7a97e176df71cdc2c179cd1847d7fc86cca5832ad12e9798d7fed6b7a1aab50", size = 13677, upload-time = "2025-06-28T04:24:05.426Z" }
@@ -2738,7 +2823,7 @@ wheels = [
 
 [[package]]
 name = "huggingface-hub"
-version = "1.9.0"
+version = "1.9.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "filelock" },
@@ -2751,9 +2836,9 @@ dependencies = [
     { name = "typer" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/88/bb/62c7aa86f63a05e2f9b96642fdef9b94526a23979820b09f5455deff4983/huggingface_hub-1.9.0.tar.gz", hash = "sha256:0ea5be7a56135c91797cae6ad726e38eaeb6eb4b77cefff5c9d38ba0ecf874f7", size = 750326, upload-time = "2026-04-03T08:35:55.888Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/cf/65/fb800d327bf25bf31b798dd08935d326d064ecb9b359059fecd91b3a98e8/huggingface_hub-1.9.2.tar.gz", hash = "sha256:8d09d080a186bd950a361bfc04b862dfb04d6a2b41d48e9ba1b37507cfd3f1e1", size = 750284, upload-time = "2026-04-08T08:43:11.127Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/73/37/0d15d16150e1829f3e90962c99f28257f6de9e526a680b4c6f5acdb54fd2/huggingface_hub-1.9.0-py3-none-any.whl", hash = "sha256:2999328c058d39fd19ab748dd09bd4da2fbaa4f4c1ddea823eab103051e14a1f", size = 637355, upload-time = "2026-04-03T08:35:53.897Z" },
+    { url = "https://files.pythonhosted.org/packages/57/d4/e33bf0b362810a9b96c5923e38908950d58ecb512db42e3730320c7f4a3a/huggingface_hub-1.9.2-py3-none-any.whl", hash = "sha256:e1e62ce237d4fbeca9f970aeb15176fbd503e04c25577bfd22f44aa7aa2b5243", size = 637349, upload-time = "2026-04-08T08:43:09.114Z" },
 ]
 
 [[package]]
@@ -2770,7 +2855,7 @@ wheels = [
 
 [[package]]
 name = "hyperbrowser"
-version = "0.89.2"
+version = "0.90.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
@@ -2778,9 +2863,9 @@ dependencies = [
     { name = "pydantic" },
     { name = "websockets" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/e0/45/b31a6cd1a7db3ca41b986174013653893a1947af348835c23f22f997aac6/hyperbrowser-0.89.2.tar.gz", hash = "sha256:3f97f392b5394124fd8424fcf274c69a37317fc4c773923ef8fdf78f5b5406e0", size = 64130, upload-time = "2026-03-30T17:13:53.581Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/6e/60/b651865b7154feb571980c7f3341c75275a7330d3980c6a328bd875eb1dc/hyperbrowser-0.90.1.tar.gz", hash = "sha256:987259a99a8fe740274bc87b9cd64430476588fb5467313537d746881703fe4c", size = 65524, upload-time = "2026-04-07T23:56:44.951Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/5c/65/abbc6cc3446e174ba17aa145de85dc740fc241296e5e0fd443f7bf263922/hyperbrowser-0.89.2-py3-none-any.whl", hash = "sha256:7ae4a9eb155b2d984748224ded0e33bf5bd910779a326021f3060a2024e9e82c", size = 109655, upload-time = "2026-03-30T17:13:52.397Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/49/cca92edcbace09135bf6c13a15c1856357c1cf68185d09088937b0bfe1f2/hyperbrowser-0.90.1-py3-none-any.whl", hash = "sha256:831c4e9b3143d713b64dd69034936763c5d92dfbf18f2936bc33d72c066b6551", size = 110792, upload-time = "2026-04-07T23:56:43.626Z" },
 ]
 
 [[package]]
@@ -3037,11 +3122,11 @@ wheels = [
 
 [[package]]
 name = "invoke"
-version = "2.2.1"
+version = "3.0.3"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/de/bd/b461d3424a24c80490313fd77feeb666ca4f6a28c7e72713e3d9095719b4/invoke-2.2.1.tar.gz", hash = "sha256:515bf49b4a48932b79b024590348da22f39c4942dff991ad1fb8b8baea1be707", size = 304762, upload-time = "2025-10-11T00:36:35.172Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/33/f6/227c48c5fe47fa178ccf1fda8f047d16c97ba926567b661e9ce2045c600c/invoke-3.0.3.tar.gz", hash = "sha256:437b6a622223824380bfb4e64f612711a6b648c795f565efc8625af66fb57f0c", size = 343419, upload-time = "2026-04-07T15:17:48.307Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/32/4b/b99e37f88336009971405cbb7630610322ed6fbfa31e1d7ab3fbf3049a2d/invoke-2.2.1-py3-none-any.whl", hash = "sha256:2413bc441b376e5cd3f55bb5d364f973ad8bdd7bf87e53c79de3c11bf3feecc8", size = 160287, upload-time = "2025-10-11T00:36:33.703Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/de/bbc12563bbf979618d17625a4e753ff7a078523e28d870d3626daa97261a/invoke-3.0.3-py3-none-any.whl", hash = "sha256:f11327165e5cbb89b2ad1d88d3292b5113332c43b8553b494da435d6ec6f5053", size = 160958, upload-time = "2026-04-07T15:17:46.875Z" },
 ]
 
 [[package]]
@@ -3423,7 +3508,7 @@ wheels = [
 
 [[package]]
 name = "langchain-core"
-version = "1.2.25"
+version = "1.2.28"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "jsonpatch" },
@@ -3435,9 +3520,9 @@ dependencies = [
     { name = "typing-extensions" },
     { name = "uuid-utils" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/86/2a/d65de24fc9b7989137253da8973f850f3e39b4ce3e0377bc8200d6b3c189/langchain_core-1.2.25.tar.gz", hash = "sha256:77e032b96509d0eb1f6875042fdf97b7e2334a815314700c6894d9d078909b9c", size = 842347, upload-time = "2026-04-02T22:39:11.528Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/f8/a4/317a1a3ac1df33a64adb3670bf88bbe3b3d5baa274db6863a979db472897/langchain_core-1.2.28.tar.gz", hash = "sha256:271a3d8bd618f795fdeba112b0753980457fc90537c46a0c11998516a74dc2cb", size = 846119, upload-time = "2026-04-08T18:19:34.867Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/3d/0e/7b31b0249f9b9b0fc7829d5b0ee484b8f8d43c78e376e9951e2ef3eac70c/langchain_core-1.2.25-py3-none-any.whl", hash = "sha256:0c05bf395aec6d2dfa14488fd006f7bcd0540e7e89287e04f92203532a82c828", size = 506866, upload-time = "2026-04-02T22:39:10.137Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/92/32f785f077c7e898da97064f113c73fbd9ad55d1e2169cf3a391b183dedb/langchain_core-1.2.28-py3-none-any.whl", hash = "sha256:80764232581eaf8057bcefa71dbf8adc1f6a28d257ebd8b95ba9b8b452e8c6ac", size = 508727, upload-time = "2026-04-08T18:19:32.823Z" },
 ]
 
 [[package]]
@@ -3463,7 +3548,7 @@ sdist = { url = "https://files.pythonhosted.org/packages/0e/72/a3add0e4eec4eb9e2
 
 [[package]]
 name = "langsmith"
-version = "0.7.25"
+version = "0.7.29"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
@@ -3476,9 +3561,9 @@ dependencies = [
     { name = "xxhash" },
     { name = "zstandard" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/7e/d7/21ffae5ccdc3c9b8de283e8f8bf48a92039681df0d39f15133d8ff8965bd/langsmith-0.7.25.tar.gz", hash = "sha256:d17da71f156ca69eafd28ac9627c8e0e93170260ec37cd27cedc83205a067598", size = 1145410, upload-time = "2026-04-03T13:11:42.36Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/eb/b3/b9b2218483400c9c0f84ea781ec4fc92a9afb51c3f16d2b6369356990d47/langsmith-0.7.29.tar.gz", hash = "sha256:bcec464be00b35cdf0ed0087ef9b1f40889fe1017066f11136a02aa0276cedf5", size = 1094512, upload-time = "2026-04-09T03:17:12.961Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/29/13/67889d41baf7dbaf13ffd0b334a0f284e107fad1cc8782a1abb1e56e5eeb/langsmith-0.7.25-py3-none-any.whl", hash = "sha256:55ecc24c547f6c79b5a684ff8685c669eec34e52fcac5d2c0af7d613aef5a632", size = 359417, upload-time = "2026-04-03T13:11:40.729Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/11/8189be47b5d5a64ecd7e19c81ad3fd9cd9f0bf6778abc5ff177db90ebb3d/langsmith-0.7.29-py3-none-any.whl", hash = "sha256:ec61cdca1f2e2add48742f97a4ee1d6894c968ef3d5a50122289dac56170978c", size = 367655, upload-time = "2026-04-09T03:17:10.944Z" },
 ]
 
 [[package]]
@@ -4867,7 +4952,7 @@ wheels = [
 
 [[package]]
 name = "openai"
-version = "2.30.0"
+version = "2.31.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "anyio" },
@@ -4879,9 +4964,9 @@ dependencies = [
     { name = "tqdm" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/88/15/52580c8fbc16d0675d516e8749806eda679b16de1e4434ea06fb6feaa610/openai-2.30.0.tar.gz", hash = "sha256:92f7661c990bda4b22a941806c83eabe4896c3094465030dd882a71abe80c885", size = 676084, upload-time = "2026-03-25T22:08:59.96Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/94/fe/64b3d035780b3188f86c4f6f1bc202e7bb74757ef028802112273b9dcacf/openai-2.31.0.tar.gz", hash = "sha256:43ca59a88fc973ad1848d86b98d7fac207e265ebbd1828b5e4bdfc85f79427a5", size = 684772, upload-time = "2026-04-08T21:01:41.797Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/2a/9e/5bfa2270f902d5b92ab7d41ce0475b8630572e71e349b2a4996d14bdda93/openai-2.30.0-py3-none-any.whl", hash = "sha256:9a5ae616888eb2748ec5e0c5b955a51592e0b201a11f4262db920f2a78c5231d", size = 1146656, upload-time = "2026-03-25T22:08:58.2Z" },
+    { url = "https://files.pythonhosted.org/packages/66/bc/a8f7c3aa03452fedbb9af8be83e959adba96a6b4a35e416faffcc959c568/openai-2.31.0-py3-none-any.whl", hash = "sha256:44e1344d87e56a493d649b17e2fac519d1368cbb0745f59f1957c4c26de50a0a", size = 1153479, upload-time = "2026-04-08T21:01:39.217Z" },
 ]
 
 [[package]]
@@ -4959,7 +5044,8 @@ version = "1.34.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "googleapis-common-protos" },
-    { name = "grpcio" },
+    { name = "grpcio", version = "1.78.0", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
+    { name = "grpcio", version = "1.80.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
     { name = "opentelemetry-api" },
     { name = "opentelemetry-exporter-otlp-proto-common" },
     { name = "opentelemetry-proto" },
@@ -5460,11 +5546,11 @@ wheels = [
 
 [[package]]
 name = "platformdirs"
-version = "4.9.4"
+version = "4.9.6"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/19/56/8d4c30c8a1d07013911a8fdbd8f89440ef9f08d07a1b50ab8ca8be5a20f9/platformdirs-4.9.4.tar.gz", hash = "sha256:1ec356301b7dc906d83f371c8f487070e99d3ccf9e501686456394622a01a934", size = 28737, upload-time = "2026-03-05T18:34:13.271Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/9f/4a/0883b8e3802965322523f0b200ecf33d31f10991d0401162f4b23c698b42/platformdirs-4.9.6.tar.gz", hash = "sha256:3bfa75b0ad0db84096ae777218481852c0ebc6c727b3168c1b9e0118e458cf0a", size = 29400, upload-time = "2026-04-09T00:04:10.812Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/63/d7/97f7e3a6abb67d8080dd406fd4df842c2be0efaf712d1c899c32a075027c/platformdirs-4.9.4-py3-none-any.whl", hash = "sha256:68a9a4619a666ea6439f2ff250c12a853cd1cbd5158d258bd824a7df6be2f868", size = 21216, upload-time = "2026-03-05T18:34:12.172Z" },
+    { url = "https://files.pythonhosted.org/packages/75/a6/a0a304dc33b49145b21f4808d763822111e67d1c3a32b524a1baf947b6e1/platformdirs-4.9.6-py3-none-any.whl", hash = "sha256:e61adb1d5e5cb3441b4b7710bea7e4c12250ca49439228cc1021c00dcfac0917", size = 21348, upload-time = "2026-04-09T00:04:09.463Z" },
 ]
 
 [[package]]
@@ -6476,31 +6562,31 @@ wheels = [
 
 [[package]]
 name = "pypdfium2"
-version = "5.6.0"
+version = "5.7.0"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/3b/01/be763b9081c7eb823196e7d13d9c145bf75ac43f3c1466de81c21c24b381/pypdfium2-5.6.0.tar.gz", hash = "sha256:bcb9368acfe3547054698abbdae68ba0cbd2d3bda8e8ee437e061deef061976d", size = 270714, upload-time = "2026-03-08T01:05:06.5Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/0f/76/19aacfff78d328a700ca34b5b1dff891e587aac2fd6b928b035ed366cc37/pypdfium2-5.7.0.tar.gz", hash = "sha256:9febb09f532555485f064c1f6442f46d31e27be5981359cb06b5826695906a06", size = 265935, upload-time = "2026-04-08T19:58:16.831Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/9d/b1/129ed0177521a93a892f8a6a215dd3260093e30e77ef7035004bb8af7b6c/pypdfium2-5.6.0-py3-none-android_23_arm64_v8a.whl", hash = "sha256:fb7858c9707708555b4a719b5548a6e7f5d26bc82aef55ae4eb085d7a2190b11", size = 3346059, upload-time = "2026-03-08T01:04:21.37Z" },
-    { url = "https://files.pythonhosted.org/packages/86/34/cbdece6886012180a7f2c7b2c360c415cf5e1f83f1973d2c9201dae3506a/pypdfium2-5.6.0-py3-none-android_23_armeabi_v7a.whl", hash = "sha256:6a7e1f4597317786f994bfb947eef480e53933f804a990193ab89eef8243f805", size = 2804418, upload-time = "2026-03-08T01:04:23.384Z" },
-    { url = "https://files.pythonhosted.org/packages/6e/f6/9f9e190fe0e5a6b86b82f83bd8b5d3490348766062381140ca5cad8e00b1/pypdfium2-5.6.0-py3-none-macosx_11_0_arm64.whl", hash = "sha256:e468c38997573f0e86f03273c2c1fbdea999de52ba43fee96acaa2f6b2ad35f7", size = 3412541, upload-time = "2026-03-08T01:04:25.45Z" },
-    { url = "https://files.pythonhosted.org/packages/ee/8d/e57492cb2228ba56ed57de1ff044c8ac114b46905f8b1445c33299ba0488/pypdfium2-5.6.0-py3-none-macosx_11_0_x86_64.whl", hash = "sha256:ad3abddc5805424f962e383253ccad6a0d1d2ebd86afa9a9e1b9ca659773cd0d", size = 3592320, upload-time = "2026-03-08T01:04:27.509Z" },
-    { url = "https://files.pythonhosted.org/packages/f9/8a/8ab82e33e9c551494cbe1526ea250ca8cc4e9e98d6a4fc6b6f8d959aa1d1/pypdfium2-5.6.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f6b5eb9eae5c45076395454522ca26add72ba8bd1fe473e1e4721aa58521470c", size = 3596450, upload-time = "2026-03-08T01:04:29.183Z" },
-    { url = "https://files.pythonhosted.org/packages/f5/b5/602a792282312ccb158cc63849528079d94b0a11efdc61f2a359edfb41e9/pypdfium2-5.6.0-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:258624da8ef45cdc426e11b33e9d83f9fb723c1c201c6e0f4ab5a85966c6b876", size = 3325442, upload-time = "2026-03-08T01:04:30.886Z" },
-    { url = "https://files.pythonhosted.org/packages/81/1f/9e48ec05ed8d19d736c2d1f23c1bd0f20673f02ef846a2576c69e237f15d/pypdfium2-5.6.0-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:e9367451c8a00931d6612db0822525a18c06f649d562cd323a719e46ac19c9bb", size = 3727434, upload-time = "2026-03-08T01:04:33.619Z" },
-    { url = "https://files.pythonhosted.org/packages/33/90/0efd020928b4edbd65f4f3c2af0c84e20b43a3ada8fa6d04f999a97afe7a/pypdfium2-5.6.0-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a757869f891eac1cc1372e38a4aa01adac8abc8fe2a8a4e2ebf50595e3bf5937", size = 4139029, upload-time = "2026-03-08T01:04:36.08Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/49/a640b288a48dab1752281dd9b72c0679fccea107874e80a65a606b00efa9/pypdfium2-5.6.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:515be355222cc57ae9e62cd5c7c350b8e0c863efc539f80c7d75e2811ba45cb6", size = 3646387, upload-time = "2026-03-08T01:04:38.151Z" },
-    { url = "https://files.pythonhosted.org/packages/b0/3b/a344c19c01021eeb5d830c102e4fc9b1602f19c04aa7d11abbe2d188fd8e/pypdfium2-5.6.0-py3-none-manylinux_2_27_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d1c4753c7caf7d004211d7f57a21f10d127f5e0e5510a14d24bc073e7220a3ea", size = 3097212, upload-time = "2026-03-08T01:04:40.776Z" },
-    { url = "https://files.pythonhosted.org/packages/50/96/e48e13789ace22aeb9b7510904a1b1493ec588196e11bbacc122da330b3d/pypdfium2-5.6.0-py3-none-manylinux_2_38_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c49729090281fdd85775fb8912c10bd19e99178efaa98f145ab06e7ce68554d2", size = 2965026, upload-time = "2026-03-08T01:04:42.857Z" },
-    { url = "https://files.pythonhosted.org/packages/cb/06/3100e44d4935f73af8f5d633d3bd40f0d36d606027085a0ef1f0566a6320/pypdfium2-5.6.0-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:a4a1749a8d4afd62924a8d95cfa4f2e26fc32957ce34ac3b674be6f127ed252e", size = 4131431, upload-time = "2026-03-08T01:04:44.982Z" },
-    { url = "https://files.pythonhosted.org/packages/64/ef/d8df63569ce9a66c8496057782eb8af78e0d28667922d62ec958434e3d4b/pypdfium2-5.6.0-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:36469ebd0fdffb7130ce45ed9c44f8232d91571c89eb851bd1633c64b6f6114f", size = 3747469, upload-time = "2026-03-08T01:04:46.702Z" },
-    { url = "https://files.pythonhosted.org/packages/a6/47/fd2c6a67a49fade1acd719fbd11f7c375e7219912923ef2de0ea0ac1544e/pypdfium2-5.6.0-py3-none-musllinux_1_2_i686.whl", hash = "sha256:9da900df09be3cf546b637a127a7b6428fb22d705951d731269e25fd3adef457", size = 4337578, upload-time = "2026-03-08T01:04:49.007Z" },
-    { url = "https://files.pythonhosted.org/packages/6b/f5/836c83e54b01e09478c4d6bf4912651d6053c932250fcee953f5c72d8e4a/pypdfium2-5.6.0-py3-none-musllinux_1_2_ppc64le.whl", hash = "sha256:45fccd5622233c5ec91a885770ae7dd4004d4320ac05a4ad8fa03a66dea40244", size = 4376104, upload-time = "2026-03-08T01:04:51.04Z" },
-    { url = "https://files.pythonhosted.org/packages/6e/7f/b940b6a1664daf8f9bad87c6c99b84effa3611615b8708d10392dc33036c/pypdfium2-5.6.0-py3-none-musllinux_1_2_riscv64.whl", hash = "sha256:282dc030e767cd61bd0299f9d581052b91188e2b87561489057a8e7963e7e0cb", size = 3929824, upload-time = "2026-03-08T01:04:53.544Z" },
-    { url = "https://files.pythonhosted.org/packages/88/79/00267d92a6a58c229e364d474f5698efe446e0c7f4f152f58d0138715e99/pypdfium2-5.6.0-py3-none-musllinux_1_2_s390x.whl", hash = "sha256:a1c1dfe950382c76a7bba1ba160ec5e40df8dd26b04a1124ae268fda55bc4cbe", size = 4270201, upload-time = "2026-03-08T01:04:55.81Z" },
-    { url = "https://files.pythonhosted.org/packages/e1/ab/b127f38aba41746bdf9ace15ba08411d7ef6ecba1326d529ba414eb1ed50/pypdfium2-5.6.0-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:43b0341ca6feb6c92e4b7a9eb4813e5466f5f5e8b6baeb14df0a94d5f312c00b", size = 4180793, upload-time = "2026-03-08T01:04:57.961Z" },
-    { url = "https://files.pythonhosted.org/packages/0e/8c/a01c8e4302448b614d25a85c08298b0d3e9dfbdac5bd1b2f32c9b02e83d9/pypdfium2-5.6.0-py3-none-win32.whl", hash = "sha256:9dfcd4ff49a2b9260d00e38539ab28190d59e785e83030b30ffaf7a29c42155d", size = 3596753, upload-time = "2026-03-08T01:05:00.566Z" },
-    { url = "https://files.pythonhosted.org/packages/9b/5f/2d871adf46761bb002a62686545da6348afe838d19af03df65d1ece786a2/pypdfium2-5.6.0-py3-none-win_amd64.whl", hash = "sha256:c6bc8dd63d0568f4b592f3e03de756afafc0e44aa1fe8878cc4aba1b11ae7374", size = 3716526, upload-time = "2026-03-08T01:05:02.433Z" },
-    { url = "https://files.pythonhosted.org/packages/3a/80/0d9b162098597fbe3ac2b269b1682c0c3e8db9ba87679603fdd9b19afaa6/pypdfium2-5.6.0-py3-none-win_arm64.whl", hash = "sha256:5538417b199bdcb3207370c88df61f2ba3dac7a3253f82e1aa2708e6376b6f90", size = 3515049, upload-time = "2026-03-08T01:05:04.587Z" },
+    { url = "https://files.pythonhosted.org/packages/81/a5/7e6d9532e7753a1dc439412b38dda5943c692d3ab3f1e01826f9b5527c67/pypdfium2-5.7.0-py3-none-android_23_arm64_v8a.whl", hash = "sha256:9e815e75498a03a3049baf68ff00b90459bead0d9eee65b1860142529faba81d", size = 3343748, upload-time = "2026-04-08T19:57:40.293Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/ea/9d4a0b41f86d342dfb6529c31789e70d1123cc6521b29979e02ec2b267b6/pypdfium2-5.7.0-py3-none-android_23_armeabi_v7a.whl", hash = "sha256:405bb3c6d0e7a5a32e98eb45a3343da1ad847d6d6eef77bf6f285652a250e0b7", size = 2805480, upload-time = "2026-04-08T19:57:42.109Z" },
+    { url = "https://files.pythonhosted.org/packages/34/dc/ce1c8e94082a84d1669606f90c4f694acbdcabd359d92db7302d16b5938b/pypdfium2-5.7.0-py3-none-macosx_11_0_arm64.whl", hash = "sha256:609b34d91871c185f399b1a503513c03a9de83597f55404de00c3d31a8037544", size = 3420156, upload-time = "2026-04-08T19:57:43.672Z" },
+    { url = "https://files.pythonhosted.org/packages/51/84/6d859ce82a3723ba7cd70d88ad87eca3cb40553c68db182976fd2b0febe1/pypdfium2-5.7.0-py3-none-macosx_11_0_x86_64.whl", hash = "sha256:6ae6c6bba0cde30c9293c3f525778c229466de7782e8f7d99e7c2a1b8f9c7a6f", size = 3601560, upload-time = "2026-04-08T19:57:45.148Z" },
+    { url = "https://files.pythonhosted.org/packages/66/0c/8bc2258d1e7ba971d05241a049cd3100c75df6bcf930423de7d0c6265a30/pypdfium2-5.7.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5b518d78211cb2912139d10d7f4e39669231eb155e8258159e3413e9e5e4baef", size = 3588134, upload-time = "2026-04-08T19:57:47.379Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/f7/3248cc569a92ff25f1fe0a4a1790807e6e05df60563e39e74c9b723d5620/pypdfium2-5.7.0-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:8aaa8e7681ebcaa042ac8adc152521fd5f16a4ceee1e9b9b582e148519528aa9", size = 3323100, upload-time = "2026-04-08T19:57:49.243Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/ee/6f004509df77ce963ed5a0f2e090ea0c43036e49cc72c321ce90f3d328bf/pypdfium2-5.7.0-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:c8d2284f799adbae755b66ce1a579834e487337d89bbb34ee749ecfa68322425", size = 3719217, upload-time = "2026-04-08T19:57:50.708Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/f0/bb61601aa1c2990d4a5d194440281941781250f6a438813a13fe20eb95cf/pypdfium2-5.7.0-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:08e9e9576eefbc085ba9a63feede4bcaf93d9fa0d9b17cb549aba6f065a8750e", size = 4147676, upload-time = "2026-04-08T19:57:52.292Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/27/a119e0519049afcfca51e9834b67949ffaba5b9afe7e74ed04d6c39b0285/pypdfium2-5.7.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3ace647320bae562903097977b83449f91d30e045dd19ce62939d3100869f180", size = 3635469, upload-time = "2026-04-08T19:57:53.948Z" },
+    { url = "https://files.pythonhosted.org/packages/70/0b/4bcb67b039f057aca01ddbe692ae7666b630ad42b91a3aca3cb4d4f01222/pypdfium2-5.7.0-py3-none-manylinux_2_27_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f7bb7555fe613cd76fff871a12299f902b80443f90b49e2001338718c758f6f4", size = 3091818, upload-time = "2026-04-08T19:57:55.471Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/c9/31490ab7cecaf433195683ff5c750f4111c7347f1fef9131d3d8704618eb/pypdfium2-5.7.0-py3-none-manylinux_2_38_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e7c0ef5ae35d40daa1883f3993b3b7ecf3fb06993bcc46651e28cf058d9da992", size = 2959579, upload-time = "2026-04-08T19:57:57.238Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/1e/bf5fe52f007130c0b1b38786ef82c98b4ac06f77e7ca001a17cda6ce76b6/pypdfium2-5.7.0-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:423c749e8cab22ddaf833041498ec5ad477c1c2abbff0a8ec00b99663c284592", size = 4126033, upload-time = "2026-04-08T19:57:59.111Z" },
+    { url = "https://files.pythonhosted.org/packages/18/7d/46dcebf4eb9ccf9b5fafe79702c31863b4c127e9c3140c0f335c375d3818/pypdfium2-5.7.0-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:f48f453f848a90ec7786bcc84a4c0ee42eb84c2d8af3ca9004f7c18648939838", size = 3742063, upload-time = "2026-04-08T19:58:00.643Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/29/cfec37942f13a1dfe3ab059cf8d130609143d33ca1dd554b017a30bffe97/pypdfium2-5.7.0-py3-none-musllinux_1_2_i686.whl", hash = "sha256:e84bfa61f0243ed4b33bfe2492946ba761007b7feb5e7e0a086c635436d47906", size = 4332177, upload-time = "2026-04-08T19:58:02.425Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/da/07812153eff746bbc548d50129ada699765036674ff94065d538015c9556/pypdfium2-5.7.0-py3-none-musllinux_1_2_ppc64le.whl", hash = "sha256:e3f4d7f4473b5ef762560cd5971cad3b51a77da3a25af479ef5aae4611709bb8", size = 4370704, upload-time = "2026-04-08T19:58:04.379Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/df/07a6a038ccb6fae6a1a06708c98d00aa03f2ca720b02cd3b75248dc5da70/pypdfium2-5.7.0-py3-none-musllinux_1_2_riscv64.whl", hash = "sha256:9e0b6c9be8c92b63ce0a00a94f6635eec22831e253811d6692824a1244e21780", size = 3924428, upload-time = "2026-04-08T19:58:06.406Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/a8/70ce4f997fef4186098c032fb3dd2c39193027a92a23b5a94d7a4c85e068/pypdfium2-5.7.0-py3-none-musllinux_1_2_s390x.whl", hash = "sha256:3e4974a8545f726fc97a7443507713007e177f22058cd1ca0b28cb0e8e2d7dc2", size = 4264817, upload-time = "2026-04-08T19:58:08.003Z" },
+    { url = "https://files.pythonhosted.org/packages/02/42/03779e61ca40120f87839b4693899c72031b7a9e23676dcd8914d92e460c/pypdfium2-5.7.0-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:2fe12d57a0b413d42bdba435a608b2435a921a5f6a9d78fd8091b6266b63901a", size = 4175393, upload-time = "2026-04-08T19:58:09.858Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/f1/19bea36b354f2407c6ffdc60ad8564d95eb515badec457043ff57ad636f0/pypdfium2-5.7.0-py3-none-win32.whl", hash = "sha256:23958aec5c28c52e71f183a647fcc9fcec96ef703cc60a3ade44e55f4701678f", size = 3606308, upload-time = "2026-04-08T19:58:11.672Z" },
+    { url = "https://files.pythonhosted.org/packages/70/aa/fb333c1912a019de26e2395afd3dbef09e8118a59d70f1e5886fc90aa565/pypdfium2-5.7.0-py3-none-win_amd64.whl", hash = "sha256:a33d2c190042ae09c5512f599a540f88b07be956f18c4bb49c027e8c5118ce44", size = 3726429, upload-time = "2026-04-08T19:58:13.374Z" },
+    { url = "https://files.pythonhosted.org/packages/86/cf/6d4bc1ae4466a1f223abfe27210dce218da307e921961cd687f6e5a795a0/pypdfium2-5.7.0-py3-none-win_arm64.whl", hash = "sha256:8233fd06b0b8c22a5ea0bccbd7c4f73d6e9d0388040ea51909a5b2b1f63157e8", size = 3519317, upload-time = "2026-04-08T19:58:15.261Z" },
 ]
 
 [[package]]
@@ -6672,15 +6758,15 @@ wheels = [
 
 [[package]]
 name = "python-discovery"
-version = "1.2.1"
+version = "1.2.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "filelock" },
     { name = "platformdirs" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/b9/88/815e53084c5079a59df912825a279f41dd2e0df82281770eadc732f5352c/python_discovery-1.2.1.tar.gz", hash = "sha256:180c4d114bff1c32462537eac5d6a332b768242b76b69c0259c7d14b1b680c9e", size = 58457, upload-time = "2026-03-26T22:30:44.496Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/de/ef/3bae0e537cfe91e8431efcba4434463d2c5a65f5a89edd47c6cf2f03c55f/python_discovery-1.2.2.tar.gz", hash = "sha256:876e9c57139eb757cb5878cbdd9ae5379e5d96266c99ef731119e04fffe533bb", size = 58872, upload-time = "2026-04-07T17:28:49.249Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/67/0f/019d3949a40280f6193b62bc010177d4ce702d0fce424322286488569cd3/python_discovery-1.2.1-py3-none-any.whl", hash = "sha256:b6a957b24c1cd79252484d3566d1b49527581d46e789aaf43181005e56201502", size = 31674, upload-time = "2026-03-26T22:30:43.396Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/db/795879cc3ddfe338599bddea6388cc5100b088db0a4caf6e6c1af1c27e04/python_discovery-1.2.2-py3-none-any.whl", hash = "sha256:e1ae95d9af875e78f15e19aed0c6137ab1bb49c200f21f5061786490c9585c7a", size = 31894, upload-time = "2026-04-07T17:28:48.09Z" },
 ]
 
 [[package]]
@@ -6725,11 +6811,11 @@ wheels = [
 
 [[package]]
 name = "python-multipart"
-version = "0.0.22"
+version = "0.0.24"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/94/01/979e98d542a70714b0cb2b6728ed0b7c46792b695e3eaec3e20711271ca3/python_multipart-0.0.22.tar.gz", hash = "sha256:7340bef99a7e0032613f56dc36027b959fd3b30a787ed62d310e951f7c3a3a58", size = 37612, upload-time = "2026-01-25T10:15:56.219Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/8a/45/e23b5dc14ddb9918ae4a625379506b17b6f8fc56ca1d82db62462f59aea6/python_multipart-0.0.24.tar.gz", hash = "sha256:9574c97e1c026e00bc30340ef7c7d76739512ab4dfd428fec8c330fa6a5cc3c8", size = 37695, upload-time = "2026-04-05T20:49:13.829Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/1b/d0/397f9626e711ff749a95d96b7af99b9c566a9bb5129b8e4c10fc4d100304/python_multipart-0.0.22-py3-none-any.whl", hash = "sha256:2b2cd894c83d21bf49d702499531c7bafd057d730c201782048f7945d82de155", size = 24579, upload-time = "2026-01-25T10:15:54.811Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/73/89930efabd4da63cea44a3f438aeb753d600123570e6d6264e763617a9ce/python_multipart-0.0.24-py3-none-any.whl", hash = "sha256:9b110a98db707df01a53c194f0af075e736a770dc5058089650d70b4a182f950", size = 24420, upload-time = "2026-04-05T20:49:12.555Z" },
 ]
 
 [[package]]
@@ -6849,7 +6935,8 @@ name = "qdrant-client"
 version = "1.14.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "grpcio" },
+    { name = "grpcio", version = "1.78.0", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
+    { name = "grpcio", version = "1.80.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
     { name = "httpx", extra = ["http2"] },
     { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
     { name = "numpy", version = "2.4.4", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
@@ -6903,75 +6990,75 @@ wheels = [
 
 [[package]]
 name = "rapidfuzz"
-version = "3.14.3"
+version = "3.14.5"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/d3/28/9d808fe62375b9aab5ba92fa9b29371297b067c2790b2d7cda648b1e2f8d/rapidfuzz-3.14.3.tar.gz", hash = "sha256:2491937177868bc4b1e469087601d53f925e8d270ccc21e07404b4b5814b7b5f", size = 57863900, upload-time = "2025-11-01T11:54:52.321Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/2c/21/ef6157213316e85790041254259907eb722e00b03480256c0545d98acd33/rapidfuzz-3.14.5.tar.gz", hash = "sha256:ba10ac57884ce82112f7ed910b67e7fb6072d8ef2c06e30dc63c0f604a112e0e", size = 57901753, upload-time = "2026-04-07T11:16:31.931Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/69/d1/0efa42a602ed466d3ca1c462eed5d62015c3fd2a402199e2c4b87aa5aa25/rapidfuzz-3.14.3-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:b9fcd4d751a4fffa17aed1dde41647923c72c74af02459ad1222e3b0022da3a1", size = 1952376, upload-time = "2025-11-01T11:52:29.175Z" },
-    { url = "https://files.pythonhosted.org/packages/be/00/37a169bb28b23850a164e6624b1eb299e1ad73c9e7c218ee15744e68d628/rapidfuzz-3.14.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:4ad73afb688b36864a8d9b7344a9cf6da186c471e5790cbf541a635ee0f457f2", size = 1390903, upload-time = "2025-11-01T11:52:31.239Z" },
-    { url = "https://files.pythonhosted.org/packages/3c/91/b37207cbbdb6eaafac3da3f55ea85287b27745cb416e75e15769b7d8abe8/rapidfuzz-3.14.3-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c5fb2d978a601820d2cfd111e2c221a9a7bfdf84b41a3ccbb96ceef29f2f1ac7", size = 1385655, upload-time = "2025-11-01T11:52:32.852Z" },
-    { url = "https://files.pythonhosted.org/packages/f2/bb/ca53e518acf43430be61f23b9c5987bd1e01e74fcb7a9ee63e00f597aefb/rapidfuzz-3.14.3-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1d83b8b712fa37e06d59f29a4b49e2e9e8635e908fbc21552fe4d1163db9d2a1", size = 3164708, upload-time = "2025-11-01T11:52:34.618Z" },
-    { url = "https://files.pythonhosted.org/packages/df/e1/7667bf2db3e52adb13cb933dd4a6a2efc66045d26fa150fc0feb64c26d61/rapidfuzz-3.14.3-cp310-cp310-manylinux_2_31_armv7l.whl", hash = "sha256:dc8c07801df5206b81ed6bd6c35cb520cf9b6c64b9b0d19d699f8633dc942897", size = 1221106, upload-time = "2025-11-01T11:52:36.069Z" },
-    { url = "https://files.pythonhosted.org/packages/05/8a/84d9f2d46a2c8eb2ccae81747c4901fa10fe4010aade2d57ce7b4b8e02ec/rapidfuzz-3.14.3-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:c71ce6d4231e5ef2e33caa952bfe671cb9fd42e2afb11952df9fad41d5c821f9", size = 2406048, upload-time = "2025-11-01T11:52:37.936Z" },
-    { url = "https://files.pythonhosted.org/packages/3c/a9/a0b7b7a1b81a020c034eb67c8e23b7e49f920004e295378de3046b0d99e1/rapidfuzz-3.14.3-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:0e38828d1381a0cceb8a4831212b2f673d46f5129a1897b0451c883eaf4a1747", size = 2527020, upload-time = "2025-11-01T11:52:39.657Z" },
-    { url = "https://files.pythonhosted.org/packages/b4/bc/416df7d108b99b4942ba04dd4cf73c45c3aadb3ef003d95cad78b1d12eb9/rapidfuzz-3.14.3-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:da2a007434323904719158e50f3076a4dadb176ce43df28ed14610c773cc9825", size = 4273958, upload-time = "2025-11-01T11:52:41.017Z" },
-    { url = "https://files.pythonhosted.org/packages/81/d0/b81e041c17cd475002114e0ab8800e4305e60837882cb376a621e520d70f/rapidfuzz-3.14.3-cp310-cp310-win32.whl", hash = "sha256:fce3152f94afcfd12f3dd8cf51e48fa606e3cb56719bccebe3b401f43d0714f9", size = 1725043, upload-time = "2025-11-01T11:52:42.465Z" },
-    { url = "https://files.pythonhosted.org/packages/09/6b/64ad573337d81d64bc78a6a1df53a72a71d54d43d276ce0662c2e95a1f35/rapidfuzz-3.14.3-cp310-cp310-win_amd64.whl", hash = "sha256:37d3c653af15cd88592633e942f5407cb4c64184efab163c40fcebad05f25141", size = 1542273, upload-time = "2025-11-01T11:52:44.005Z" },
-    { url = "https://files.pythonhosted.org/packages/f4/5e/faf76e259bc15808bc0b86028f510215c3d755b6c3a3911113079485e561/rapidfuzz-3.14.3-cp310-cp310-win_arm64.whl", hash = "sha256:cc594bbcd3c62f647dfac66800f307beaee56b22aaba1c005e9c4c40ed733923", size = 814875, upload-time = "2025-11-01T11:52:45.405Z" },
-    { url = "https://files.pythonhosted.org/packages/76/25/5b0a33ad3332ee1213068c66f7c14e9e221be90bab434f0cb4defa9d6660/rapidfuzz-3.14.3-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:dea2d113e260a5da0c4003e0a5e9fdf24a9dc2bb9eaa43abd030a1e46ce7837d", size = 1953885, upload-time = "2025-11-01T11:52:47.75Z" },
-    { url = "https://files.pythonhosted.org/packages/2d/ab/f1181f500c32c8fcf7c966f5920c7e56b9b1d03193386d19c956505c312d/rapidfuzz-3.14.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:e6c31a4aa68cfa75d7eede8b0ed24b9e458447db604c2db53f358be9843d81d3", size = 1390200, upload-time = "2025-11-01T11:52:49.491Z" },
-    { url = "https://files.pythonhosted.org/packages/14/2a/0f2de974ececad873865c6bb3ea3ad07c976ac293d5025b2d73325aac1d4/rapidfuzz-3.14.3-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:02821366d928e68ddcb567fed8723dad7ea3a979fada6283e6914d5858674850", size = 1389319, upload-time = "2025-11-01T11:52:51.224Z" },
-    { url = "https://files.pythonhosted.org/packages/ed/69/309d8f3a0bb3031fd9b667174cc4af56000645298af7c2931be5c3d14bb4/rapidfuzz-3.14.3-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:cfe8df315ab4e6db4e1be72c5170f8e66021acde22cd2f9d04d2058a9fd8162e", size = 3178495, upload-time = "2025-11-01T11:52:53.005Z" },
-    { url = "https://files.pythonhosted.org/packages/10/b7/f9c44a99269ea5bf6fd6a40b84e858414b6e241288b9f2b74af470d222b1/rapidfuzz-3.14.3-cp311-cp311-manylinux_2_31_armv7l.whl", hash = "sha256:769f31c60cd79420188fcdb3c823227fc4a6deb35cafec9d14045c7f6743acae", size = 1228443, upload-time = "2025-11-01T11:52:54.991Z" },
-    { url = "https://files.pythonhosted.org/packages/f2/0a/3b3137abac7f19c9220e14cd7ce993e35071a7655e7ef697785a3edfea1a/rapidfuzz-3.14.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:54fa03062124e73086dae66a3451c553c1e20a39c077fd704dc7154092c34c63", size = 2411998, upload-time = "2025-11-01T11:52:56.629Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/b6/983805a844d44670eaae63831024cdc97ada4e9c62abc6b20703e81e7f9b/rapidfuzz-3.14.3-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:834d1e818005ed0d4ae38f6b87b86fad9b0a74085467ece0727d20e15077c094", size = 2530120, upload-time = "2025-11-01T11:52:58.298Z" },
-    { url = "https://files.pythonhosted.org/packages/b4/cc/2c97beb2b1be2d7595d805682472f1b1b844111027d5ad89b65e16bdbaaa/rapidfuzz-3.14.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:948b00e8476a91f510dd1ec07272efc7d78c275d83b630455559671d4e33b678", size = 4283129, upload-time = "2025-11-01T11:53:00.188Z" },
-    { url = "https://files.pythonhosted.org/packages/4d/03/2f0e5e94941045aefe7eafab72320e61285c07b752df9884ce88d6b8b835/rapidfuzz-3.14.3-cp311-cp311-win32.whl", hash = "sha256:43d0305c36f504232f18ea04e55f2059bb89f169d3119c4ea96a0e15b59e2a91", size = 1724224, upload-time = "2025-11-01T11:53:02.149Z" },
-    { url = "https://files.pythonhosted.org/packages/cf/99/5fa23e204435803875daefda73fd61baeabc3c36b8fc0e34c1705aab8c7b/rapidfuzz-3.14.3-cp311-cp311-win_amd64.whl", hash = "sha256:ef6bf930b947bd0735c550683939a032090f1d688dfd8861d6b45307b96fd5c5", size = 1544259, upload-time = "2025-11-01T11:53:03.66Z" },
-    { url = "https://files.pythonhosted.org/packages/48/35/d657b85fcc615a42661b98ac90ce8e95bd32af474603a105643963749886/rapidfuzz-3.14.3-cp311-cp311-win_arm64.whl", hash = "sha256:f3eb0ff3b75d6fdccd40b55e7414bb859a1cda77c52762c9c82b85569f5088e7", size = 814734, upload-time = "2025-11-01T11:53:05.008Z" },
-    { url = "https://files.pythonhosted.org/packages/fa/8e/3c215e860b458cfbedb3ed73bc72e98eb7e0ed72f6b48099604a7a3260c2/rapidfuzz-3.14.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:685c93ea961d135893b5984a5a9851637d23767feabe414ec974f43babbd8226", size = 1945306, upload-time = "2025-11-01T11:53:06.452Z" },
-    { url = "https://files.pythonhosted.org/packages/36/d9/31b33512015c899f4a6e6af64df8dfe8acddf4c8b40a4b3e0e6e1bcd00e5/rapidfuzz-3.14.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:fa7c8f26f009f8c673fbfb443792f0cf8cf50c4e18121ff1e285b5e08a94fbdb", size = 1390788, upload-time = "2025-11-01T11:53:08.721Z" },
-    { url = "https://files.pythonhosted.org/packages/a9/67/2ee6f8de6e2081ccd560a571d9c9063184fe467f484a17fa90311a7f4a2e/rapidfuzz-3.14.3-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:57f878330c8d361b2ce76cebb8e3e1dc827293b6abf404e67d53260d27b5d941", size = 1374580, upload-time = "2025-11-01T11:53:10.164Z" },
-    { url = "https://files.pythonhosted.org/packages/30/83/80d22997acd928eda7deadc19ccd15883904622396d6571e935993e0453a/rapidfuzz-3.14.3-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6c5f545f454871e6af05753a0172849c82feaf0f521c5ca62ba09e1b382d6382", size = 3154947, upload-time = "2025-11-01T11:53:12.093Z" },
-    { url = "https://files.pythonhosted.org/packages/5b/cf/9f49831085a16384695f9fb096b99662f589e30b89b4a589a1ebc1a19d34/rapidfuzz-3.14.3-cp312-cp312-manylinux_2_31_armv7l.whl", hash = "sha256:07aa0b5d8863e3151e05026a28e0d924accf0a7a3b605da978f0359bb804df43", size = 1223872, upload-time = "2025-11-01T11:53:13.664Z" },
-    { url = "https://files.pythonhosted.org/packages/c8/0f/41ee8034e744b871c2e071ef0d360686f5ccfe5659f4fd96c3ec406b3c8b/rapidfuzz-3.14.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:73b07566bc7e010e7b5bd490fb04bb312e820970180df6b5655e9e6224c137db", size = 2392512, upload-time = "2025-11-01T11:53:15.109Z" },
-    { url = "https://files.pythonhosted.org/packages/da/86/280038b6b0c2ccec54fb957c732ad6b41cc1fd03b288d76545b9cf98343f/rapidfuzz-3.14.3-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:6de00eb84c71476af7d3110cf25d8fe7c792d7f5fa86764ef0b4ca97e78ca3ed", size = 2521398, upload-time = "2025-11-01T11:53:17.146Z" },
-    { url = "https://files.pythonhosted.org/packages/fa/7b/05c26f939607dca0006505e3216248ae2de631e39ef94dd63dbbf0860021/rapidfuzz-3.14.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:d7843a1abf0091773a530636fdd2a49a41bcae22f9910b86b4f903e76ddc82dc", size = 4259416, upload-time = "2025-11-01T11:53:19.34Z" },
-    { url = "https://files.pythonhosted.org/packages/40/eb/9e3af4103d91788f81111af1b54a28de347cdbed8eaa6c91d5e98a889aab/rapidfuzz-3.14.3-cp312-cp312-win32.whl", hash = "sha256:dea97ac3ca18cd3ba8f3d04b5c1fe4aa60e58e8d9b7793d3bd595fdb04128d7a", size = 1709527, upload-time = "2025-11-01T11:53:20.949Z" },
-    { url = "https://files.pythonhosted.org/packages/b8/63/d06ecce90e2cf1747e29aeab9f823d21e5877a4c51b79720b2d3be7848f8/rapidfuzz-3.14.3-cp312-cp312-win_amd64.whl", hash = "sha256:b5100fd6bcee4d27f28f4e0a1c6b5127bc8ba7c2a9959cad9eab0bf4a7ab3329", size = 1538989, upload-time = "2025-11-01T11:53:22.428Z" },
-    { url = "https://files.pythonhosted.org/packages/fc/6d/beee32dcda64af8128aab3ace2ccb33d797ed58c434c6419eea015fec779/rapidfuzz-3.14.3-cp312-cp312-win_arm64.whl", hash = "sha256:4e49c9e992bc5fc873bd0fff7ef16a4405130ec42f2ce3d2b735ba5d3d4eb70f", size = 811161, upload-time = "2025-11-01T11:53:23.811Z" },
-    { url = "https://files.pythonhosted.org/packages/e4/4f/0d94d09646853bd26978cb3a7541b6233c5760687777fa97da8de0d9a6ac/rapidfuzz-3.14.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:dbcb726064b12f356bf10fffdb6db4b6dce5390b23627c08652b3f6e49aa56ae", size = 1939646, upload-time = "2025-11-01T11:53:25.292Z" },
-    { url = "https://files.pythonhosted.org/packages/b6/eb/f96aefc00f3bbdbab9c0657363ea8437a207d7545ac1c3789673e05d80bd/rapidfuzz-3.14.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:1704fc70d214294e554a2421b473779bcdeef715881c5e927dc0f11e1692a0ff", size = 1385512, upload-time = "2025-11-01T11:53:27.594Z" },
-    { url = "https://files.pythonhosted.org/packages/26/34/71c4f7749c12ee223dba90017a5947e8f03731a7cc9f489b662a8e9e643d/rapidfuzz-3.14.3-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:cc65e72790ddfd310c2c8912b45106e3800fefe160b0c2ef4d6b6fec4e826457", size = 1373571, upload-time = "2025-11-01T11:53:29.096Z" },
-    { url = "https://files.pythonhosted.org/packages/32/00/ec8597a64f2be301ce1ee3290d067f49f6a7afb226b67d5f15b56d772ba5/rapidfuzz-3.14.3-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:43e38c1305cffae8472572a0584d4ffc2f130865586a81038ca3965301f7c97c", size = 3156759, upload-time = "2025-11-01T11:53:30.777Z" },
-    { url = "https://files.pythonhosted.org/packages/61/d5/b41eeb4930501cc899d5a9a7b5c9a33d85a670200d7e81658626dcc0ecc0/rapidfuzz-3.14.3-cp313-cp313-manylinux_2_31_armv7l.whl", hash = "sha256:e195a77d06c03c98b3fc06b8a28576ba824392ce40de8c708f96ce04849a052e", size = 1222067, upload-time = "2025-11-01T11:53:32.334Z" },
-    { url = "https://files.pythonhosted.org/packages/2a/7d/6d9abb4ffd1027c6ed837b425834f3bed8344472eb3a503ab55b3407c721/rapidfuzz-3.14.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:1b7ef2f4b8583a744338a18f12c69693c194fb6777c0e9ada98cd4d9e8f09d10", size = 2394775, upload-time = "2025-11-01T11:53:34.24Z" },
-    { url = "https://files.pythonhosted.org/packages/15/ce/4f3ab4c401c5a55364da1ffff8cc879fc97b4e5f4fa96033827da491a973/rapidfuzz-3.14.3-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:a2135b138bcdcb4c3742d417f215ac2d8c2b87bde15b0feede231ae95f09ec41", size = 2526123, upload-time = "2025-11-01T11:53:35.779Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/4b/54f804975376a328f57293bd817c12c9036171d15cf7292032e3f5820b2d/rapidfuzz-3.14.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:33a325ed0e8e1aa20c3e75f8ab057a7b248fdea7843c2a19ade0008906c14af0", size = 4262874, upload-time = "2025-11-01T11:53:37.866Z" },
-    { url = "https://files.pythonhosted.org/packages/e9/b6/958db27d8a29a50ee6edd45d33debd3ce732e7209183a72f57544cd5fe22/rapidfuzz-3.14.3-cp313-cp313-win32.whl", hash = "sha256:8383b6d0d92f6cd008f3c9216535be215a064b2cc890398a678b56e6d280cb63", size = 1707972, upload-time = "2025-11-01T11:53:39.442Z" },
-    { url = "https://files.pythonhosted.org/packages/07/75/fde1f334b0cec15b5946d9f84d73250fbfcc73c236b4bc1b25129d90876b/rapidfuzz-3.14.3-cp313-cp313-win_amd64.whl", hash = "sha256:e6b5e3036976f0fde888687d91be86d81f9ac5f7b02e218913c38285b756be6c", size = 1537011, upload-time = "2025-11-01T11:53:40.92Z" },
-    { url = "https://files.pythonhosted.org/packages/2e/d7/d83fe001ce599dc7ead57ba1debf923dc961b6bdce522b741e6b8c82f55c/rapidfuzz-3.14.3-cp313-cp313-win_arm64.whl", hash = "sha256:7ba009977601d8b0828bfac9a110b195b3e4e79b350dcfa48c11269a9f1918a0", size = 810744, upload-time = "2025-11-01T11:53:42.723Z" },
-    { url = "https://files.pythonhosted.org/packages/92/13/a486369e63ff3c1a58444d16b15c5feb943edd0e6c28a1d7d67cb8946b8f/rapidfuzz-3.14.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:a0a28add871425c2fe94358c6300bbeb0bc2ed828ca003420ac6825408f5a424", size = 1967702, upload-time = "2025-11-01T11:53:44.554Z" },
-    { url = "https://files.pythonhosted.org/packages/f1/82/efad25e260b7810f01d6b69122685e355bed78c94a12784bac4e0beb2afb/rapidfuzz-3.14.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:010e12e2411a4854b0434f920e72b717c43f8ec48d57e7affe5c42ecfa05dd0e", size = 1410702, upload-time = "2025-11-01T11:53:46.066Z" },
-    { url = "https://files.pythonhosted.org/packages/ba/1a/34c977b860cde91082eae4a97ae503f43e0d84d4af301d857679b66f9869/rapidfuzz-3.14.3-cp313-cp313t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5cfc3d57abd83c734d1714ec39c88a34dd69c85474918ebc21296f1e61eb5ca8", size = 1382337, upload-time = "2025-11-01T11:53:47.62Z" },
-    { url = "https://files.pythonhosted.org/packages/88/74/f50ea0e24a5880a9159e8fd256b84d8f4634c2f6b4f98028bdd31891d907/rapidfuzz-3.14.3-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:89acb8cbb52904f763e5ac238083b9fc193bed8d1f03c80568b20e4cef43a519", size = 3165563, upload-time = "2025-11-01T11:53:49.216Z" },
-    { url = "https://files.pythonhosted.org/packages/e8/7a/e744359404d7737049c26099423fc54bcbf303de5d870d07d2fb1410f567/rapidfuzz-3.14.3-cp313-cp313t-manylinux_2_31_armv7l.whl", hash = "sha256:7d9af908c2f371bfb9c985bd134e295038e3031e666e4b2ade1e7cb7f5af2f1a", size = 1214727, upload-time = "2025-11-01T11:53:50.883Z" },
-    { url = "https://files.pythonhosted.org/packages/d3/2e/87adfe14ce75768ec6c2b8acd0e05e85e84be4be5e3d283cdae360afc4fe/rapidfuzz-3.14.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:1f1925619627f8798f8c3a391d81071336942e5fe8467bc3c567f982e7ce2897", size = 2403349, upload-time = "2025-11-01T11:53:52.322Z" },
-    { url = "https://files.pythonhosted.org/packages/70/17/6c0b2b2bff9c8b12e12624c07aa22e922b0c72a490f180fa9183d1ef2c75/rapidfuzz-3.14.3-cp313-cp313t-musllinux_1_2_armv7l.whl", hash = "sha256:152555187360978119e98ce3e8263d70dd0c40c7541193fc302e9b7125cf8f58", size = 2507596, upload-time = "2025-11-01T11:53:53.835Z" },
-    { url = "https://files.pythonhosted.org/packages/c3/d1/87852a7cbe4da7b962174c749a47433881a63a817d04f3e385ea9babcd9e/rapidfuzz-3.14.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:52619d25a09546b8db078981ca88939d72caa6b8701edd8b22e16482a38e799f", size = 4273595, upload-time = "2025-11-01T11:53:55.961Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/ab/1d0354b7d1771a28fa7fe089bc23acec2bdd3756efa2419f463e3ed80e16/rapidfuzz-3.14.3-cp313-cp313t-win32.whl", hash = "sha256:489ce98a895c98cad284f0a47960c3e264c724cb4cfd47a1430fa091c0c25204", size = 1757773, upload-time = "2025-11-01T11:53:57.628Z" },
-    { url = "https://files.pythonhosted.org/packages/0b/0c/71ef356adc29e2bdf74cd284317b34a16b80258fa0e7e242dd92cc1e6d10/rapidfuzz-3.14.3-cp313-cp313t-win_amd64.whl", hash = "sha256:656e52b054d5b5c2524169240e50cfa080b04b1c613c5f90a2465e84888d6f15", size = 1576797, upload-time = "2025-11-01T11:53:59.455Z" },
-    { url = "https://files.pythonhosted.org/packages/fe/d2/0e64fc27bb08d4304aa3d11154eb5480bcf5d62d60140a7ee984dc07468a/rapidfuzz-3.14.3-cp313-cp313t-win_arm64.whl", hash = "sha256:c7e40c0a0af02ad6e57e89f62bef8604f55a04ecae90b0ceeda591bbf5923317", size = 829940, upload-time = "2025-11-01T11:54:01.1Z" },
-    { url = "https://files.pythonhosted.org/packages/c9/33/b5bd6475c7c27164b5becc9b0e3eb978f1e3640fea590dd3dced6006ee83/rapidfuzz-3.14.3-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:7cf174b52cb3ef5d49e45d0a1133b7e7d0ecf770ed01f97ae9962c5c91d97d23", size = 1888499, upload-time = "2025-11-01T11:54:42.094Z" },
-    { url = "https://files.pythonhosted.org/packages/30/d2/89d65d4db4bb931beade9121bc71ad916b5fa9396e807d11b33731494e8e/rapidfuzz-3.14.3-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:442cba39957a008dfc5bdef21a9c3f4379e30ffb4e41b8555dbaf4887eca9300", size = 1336747, upload-time = "2025-11-01T11:54:43.957Z" },
-    { url = "https://files.pythonhosted.org/packages/85/33/cd87d92b23f0b06e8914a61cea6850c6d495ca027f669fab7a379041827a/rapidfuzz-3.14.3-pp311-pypy311_pp73-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1faa0f8f76ba75fd7b142c984947c280ef6558b5067af2ae9b8729b0a0f99ede", size = 1352187, upload-time = "2025-11-01T11:54:45.518Z" },
-    { url = "https://files.pythonhosted.org/packages/22/20/9d30b4a1ab26aac22fff17d21dec7e9089ccddfe25151d0a8bb57001dc3d/rapidfuzz-3.14.3-pp311-pypy311_pp73-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1e6eefec45625c634926a9fd46c9e4f31118ac8f3156fff9494422cee45207e6", size = 3101472, upload-time = "2025-11-01T11:54:47.255Z" },
-    { url = "https://files.pythonhosted.org/packages/b1/ad/fa2d3e5c29a04ead7eaa731c7cd1f30f9ec3c77b3a578fdf90280797cbcb/rapidfuzz-3.14.3-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:56fefb4382bb12250f164250240b9dd7772e41c5c8ae976fd598a32292449cc5", size = 1511361, upload-time = "2025-11-01T11:54:49.057Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/b1/d6d6e7737fe3d0eb2ac2ac337686420d538f83f28495acc3cc32201c0dbf/rapidfuzz-3.14.5-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:071d96b957a33b9296b9284b6350a0fb6d030b154a04efd7c15e56b98b79a517", size = 1953508, upload-time = "2026-04-07T11:13:37.733Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/7b/94c1c953ac818bdd88b43213a9d38e4a41e953b786af3c3b2444d4a8f96d/rapidfuzz-3.14.5-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:667f40fe9c81ad129b198d236881b00dd9e8314d9cc72d03c3e16bdfe5879051", size = 1160895, upload-time = "2026-04-07T11:13:39.278Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/60/a67a7ca7c2532c6c1a4b5cd797917780eed43798b82c98b6df734a086c95/rapidfuzz-3.14.5-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f9fff308486bbd2c8c24f25e8e152c7594d3fe8db265a2d6a1ce24d58671127f", size = 1382245, upload-time = "2026-04-07T11:13:41.054Z" },
+    { url = "https://files.pythonhosted.org/packages/95/ff/a42c9ce9f9e90ceb5b51136e0b8e8e6e5113ba0b45d986effbd671e7dddf/rapidfuzz-3.14.5-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:dfa552338f51aec280f17b02d28bace1e162d1a84ccd80e3339a57f98aedb56b", size = 3163974, upload-time = "2026-04-07T11:13:42.662Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/3c/11e2d41075e6e48b7dad373631b379b7e40491f71d5412c5a98d3c58f60f/rapidfuzz-3.14.5-cp310-cp310-manylinux_2_39_riscv64.whl", hash = "sha256:068b3e965ca9d9ee4debe40001ae7c3938ba646308afd33cf0c66618147db65c", size = 1475540, upload-time = "2026-04-07T11:13:44.687Z" },
+    { url = "https://files.pythonhosted.org/packages/29/fa/09be143dcc22c79f09cf90168a574725dbda49f02cbbd55d0447da8bec86/rapidfuzz-3.14.5-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:88b7d31ff1cc5e9bc0e4406e6b1fa00b6d37163d50bb58091e9b976ff1129faa", size = 2404128, upload-time = "2026-04-07T11:13:46.641Z" },
+    { url = "https://files.pythonhosted.org/packages/32/f9/1aeb504cdcfde42881825e9c86f48238d4e01ba8a1530491e82eb17e5689/rapidfuzz-3.14.5-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:eacb434410b8d9ca99a8d42352ef085cf423e3c76c1f0b86be2fcba3bff2952c", size = 2508455, upload-time = "2026-04-07T11:13:48.726Z" },
+    { url = "https://files.pythonhosted.org/packages/10/8e/b1b5eed8d887a29b0e18fd3222c46ca60fddfb528e7e1c41267ce42d5522/rapidfuzz-3.14.5-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:649712823f3abcdc48427147a5384fac15623ba435d0013959b52e6462521397", size = 4274060, upload-time = "2026-04-07T11:13:50.805Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/c4/7e5b0353693d4f47b8b0f96e941efc377cfb2034b67ef92d082ac4441a0f/rapidfuzz-3.14.5-cp310-cp310-win32.whl", hash = "sha256:13cb79c23ef5516e4c4e3830877be8b19aa75203636be1163d690d37803f6504", size = 1727457, upload-time = "2026-04-07T11:13:52.45Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/6e/f530a39b946fa71c009bc9c81fdb6b48a77bbc57ee8572ac0302b3bf6308/rapidfuzz-3.14.5-cp310-cp310-win_amd64.whl", hash = "sha256:f2073495a7f9b75e57e600747ac09510d67683fd64d3228e009740b7ef88f9fe", size = 1544657, upload-time = "2026-04-07T11:13:54.952Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/01/02fa075f9f59ff766d374fecbd042b3ac9782dcd5abc52d909a54f587eeb/rapidfuzz-3.14.5-cp310-cp310-win_arm64.whl", hash = "sha256:8166efddea49fdbc61185559f47593239e4794fd7c9044dd5a789d1a90af852d", size = 816587, upload-time = "2026-04-07T11:13:56.418Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/f9/3c41a7be8855803f4f6c713b472226a98d31d41869d98f64f4ca790510d6/rapidfuzz-3.14.5-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:e251126d48615e1f02b4a178f2cd0cd4f0332b8a019c01a2e10480f7552554b4", size = 1952372, upload-time = "2026-04-07T11:13:58.32Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/89/c2557e37531d03465193bff0ab9de70b468420a807d71a26a65100635459/rapidfuzz-3.14.5-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:5ab449c9abd0d4e1f8145dce0798a4c822a1a1933d613c764a641bea88b8bdab", size = 1159782, upload-time = "2026-04-07T11:14:00.127Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/b2/ffeeb7eca1a897d51b998f4c0ef0281696c3b06abcca4f88f9def708ffe1/rapidfuzz-3.14.5-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:cb2829fedd672dd7107267189dabe2bbe07972801d636014417c6861eb89e358", size = 1383677, upload-time = "2026-04-07T11:14:01.696Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/d0/4539e42a2d596e068f7738f279638a4a74edd1fbb6f8594e2458058979c6/rapidfuzz-3.14.5-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3d50e5861872935fece391351cbb5ba21d1bced277cf5e1143d207a0a35f1925", size = 3168906, upload-time = "2026-04-07T11:14:03.29Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/1c/3ec897eb9d8b05308aa8ef6ae4ed64b088ad521a3f9d8ff469e7e97bc2b0/rapidfuzz-3.14.5-cp311-cp311-manylinux_2_39_riscv64.whl", hash = "sha256:7092a216728f80c960bd6b3807275d1ee318b168986bd5dc523349581d4890b8", size = 1478176, upload-time = "2026-04-07T11:14:04.94Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/ba/970c03a12ce20a5399e22afe9f8932fd4cd1265b8a8461d0e63b00eb4eae/rapidfuzz-3.14.5-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:9669753caef7fdc6529f6adcc5883ed98d65976445d9322e7dbdb6b697feee13", size = 2402441, upload-time = "2026-04-07T11:14:07.228Z" },
+    { url = "https://files.pythonhosted.org/packages/81/93/61d351cae60c1d0e21ba5ff1a1015ad045539ed215da9d6e302204ed887a/rapidfuzz-3.14.5-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:823b1b9d9230809d8edcc18872770764bfe8ef4357995e16744047c8ccf0e489", size = 2511628, upload-time = "2026-04-07T11:14:09.234Z" },
+    { url = "https://files.pythonhosted.org/packages/87/52/374d2d4f60fd98155142a869323aa221e30868cfa1f15171a0f64070c247/rapidfuzz-3.14.5-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:f0b2af76b7e7060c09e1a0dfa9410eb19369cbe6164509bff2ef94094b54d2b6", size = 4275480, upload-time = "2026-04-07T11:14:11.332Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/04/82e7989bc9ec20a15b720a335c5cb6b0724bf6582013898f90a3280cfccd/rapidfuzz-3.14.5-cp311-cp311-win32.whl", hash = "sha256:c5801a89604c65ab4cc9e91b23bc4076d0ca80efd8c976fb63843d7879a85d7f", size = 1725627, upload-time = "2026-04-07T11:14:13.217Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/b5/eca8ac5609bc9bcb02bb6ff87fa5983cc92b8772d66a431556ab8a8c178f/rapidfuzz-3.14.5-cp311-cp311-win_amd64.whl", hash = "sha256:d7ca16637c0ede8243f84074044bd0b2335a0341421f8227c85756de2d18c819", size = 1545977, upload-time = "2026-04-07T11:14:14.766Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/e1/dbf318de28f65fa2cdd0a9dfbdee380f8199eb83b19259bc4f8592551b4e/rapidfuzz-3.14.5-cp311-cp311-win_arm64.whl", hash = "sha256:8c90cdf8516d9057e502aa6003cea71cf5ec27cc44699ca52412b502a04761bb", size = 816827, upload-time = "2026-04-07T11:14:16.788Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/e3/574435c6aafb80254c191ef40d7aca2cb2bb97a095ec9395e9fa59ac307a/rapidfuzz-3.14.5-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:0d3378f471ef440473a396ce2f8e97ee12f89a78b495540e0a5617bbfe895638", size = 1944601, upload-time = "2026-04-07T11:14:18.771Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/1f/fbad3102a255ecc112ce9a7e779bacab7fd14398217be8868dc9082ba363/rapidfuzz-3.14.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:1e910eebca9fd0eba245c0555e764597e8a0cccb673a92da2dc2397050725f48", size = 1164293, upload-time = "2026-04-07T11:14:20.534Z" },
+    { url = "https://files.pythonhosted.org/packages/88/37/a3eb7ff6121ed3a5f199a8c38cc86c8e481816f879cb0e0b738b078c9a7e/rapidfuzz-3.14.5-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:01550fe5f60fd176aa66b7611289d46dc4aa4b1b904874c7b6d1d54e581c5ec1", size = 1371999, upload-time = "2026-04-07T11:14:22.63Z" },
+    { url = "https://files.pythonhosted.org/packages/79/72/97a9728c711c7c1b06e107d3f0623880fb4ef90e147ed13c551a1730e7cc/rapidfuzz-3.14.5-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:48bee0b91bebfaec41e1081e351000659ab7570cc4598d617aa04d5bf827f9e6", size = 3145715, upload-time = "2026-04-07T11:14:24.508Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/54/d5caabbea233ac90c286c87c260e49d7641467e87438a18d858e41c82e91/rapidfuzz-3.14.5-cp312-cp312-manylinux_2_39_riscv64.whl", hash = "sha256:7e580cb04ad849ae9b786fa21383c6b994b6e6c1444ad1cb9f22392759d72741", size = 1456304, upload-time = "2026-04-07T11:14:26.515Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/a7/2d1a81250ac8c01a0100c026018e76f0e7a097ff63e4c553e02a6938c6fb/rapidfuzz-3.14.5-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:09d6c9ba091854f07817055d795d604179c12a8f308ba4c7d56f3719dfea1646", size = 2389089, upload-time = "2026-04-07T11:14:28.635Z" },
+    { url = "https://files.pythonhosted.org/packages/65/0d/c47c3872203ae88e6506997c0b576ad731f5261daa25d559be09c9756658/rapidfuzz-3.14.5-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:1e989f86113be66574113b9c7bdf4793f3f863d248e47d911b355e05ca6b6b10", size = 2493404, upload-time = "2026-04-07T11:14:30.577Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/2f/71e0a5a3130792146c8a200a2dd1e52aa16f7c1074012e17f2601eea9a90/rapidfuzz-3.14.5-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:0ebd1a18e2e47bc0b292a07e6ed9c3642f8aaa672d12253885f599b50807a4f9", size = 4251709, upload-time = "2026-04-07T11:14:32.451Z" },
+    { url = "https://files.pythonhosted.org/packages/86/45/d39874901abacef325adb5b34ae416817c8486dfb4fb87c7a9b74ec5b072/rapidfuzz-3.14.5-cp312-cp312-win32.whl", hash = "sha256:9981d38a703b86f0e315a3cd229fd1906fe1d91c989ed121fb975b3c849f89f5", size = 1710069, upload-time = "2026-04-07T11:14:34.37Z" },
+    { url = "https://files.pythonhosted.org/packages/85/0b/f65572c53de8a1c704bda707f63a447b67bdbe95d7cdc70d18885e191df5/rapidfuzz-3.14.5-cp312-cp312-win_amd64.whl", hash = "sha256:d8375e3da319593389727c3187ccaf3e0e84199accc530866b8e0f2b79af05e9", size = 1540630, upload-time = "2026-04-07T11:14:36.287Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/c3/143be3a578f989758cae516f3270d5cbb49783a7bfdf57cc27a670e00456/rapidfuzz-3.14.5-cp312-cp312-win_arm64.whl", hash = "sha256:478b59bb018a6780d73f33e38d0b3ec5e968a6c1ed42876b993dd456b7aa20e8", size = 813137, upload-time = "2026-04-07T11:14:38.289Z" },
+    { url = "https://files.pythonhosted.org/packages/11/66/252803f2010ba699618cdc048b6e1f7cc1f433c08b4a9a17579b92ab0142/rapidfuzz-3.14.5-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:ebd8fd343bf8492a1e60bcb6dc99f90f74f65d98d8241a6b3e1fed225b76ecd6", size = 1940205, upload-time = "2026-04-07T11:14:40.319Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/59/b2afd98e41af9cd54554a4c1c423d84cdd60e6b1c0a09496f033b55f60ec/rapidfuzz-3.14.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:6737b35d5af7479c5bf9710f7b17edd9d2c43128d974d25fb4ea653e42c64609", size = 1159639, upload-time = "2026-04-07T11:14:42.52Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/31/7aa7e62c4c516a7af322ed0c4f0774208b72d457d0cfec808bad0df12f4a/rapidfuzz-3.14.5-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b002c7994cc9f2bc9d9856f0fbaee6e8072c983873846c92f25cefba5b2a925f", size = 1367194, upload-time = "2026-04-07T11:14:44.25Z" },
+    { url = "https://files.pythonhosted.org/packages/90/79/2fc252a63bc91d3c3b234d0a3a6ad4ebc460037a23cdcdaf9285f986e6c9/rapidfuzz-3.14.5-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:17a34330cd2a538c1ce5d400b61ba358c5b72c654b928ff87b362e88f8b864c7", size = 3151805, upload-time = "2026-04-07T11:14:46.21Z" },
+    { url = "https://files.pythonhosted.org/packages/17/54/0c83508f2683ea70e2d05f8527eb07328acf7bb1e9d97a3bece5702378e7/rapidfuzz-3.14.5-cp313-cp313-manylinux_2_39_riscv64.whl", hash = "sha256:95d937e74c1a7a1287dfb03b62a827be08ede10a155cf1af73bbf47f2b73ee6e", size = 1455667, upload-time = "2026-04-07T11:14:47.991Z" },
+    { url = "https://files.pythonhosted.org/packages/71/1b/070175e873177814d58850a01ebe80e20ae11e93eb4da894d563988660fa/rapidfuzz-3.14.5-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:46b92a9970dcc34f0096901c792644094cab49554ac3547f35e3aebbdf0a3610", size = 2388246, upload-time = "2026-04-07T11:14:50.098Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/dd/77caf7aaf9c2be050ad1f128d7c24ff0f59079aa62c5f62f9df41c0af45e/rapidfuzz-3.14.5-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:e012177c8e8a8a0754ae0d6027d63042aa5ff036d9f40f07cb3466a6082e21b8", size = 2494333, upload-time = "2026-04-07T11:14:52.303Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/e2/dd7e1f2aa31a8fbbfc16b0610af1d770ffaf1287490f3c8c5b1c52da264f/rapidfuzz-3.14.5-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:a2ae6f53f99c9a0eca7a0afc5b4e45fc73bc1dd4ac74c00509031d76df80ed98", size = 4258579, upload-time = "2026-04-07T11:14:54.538Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/0a/ac99e1ba347ba0e85e0bb60b74231d55fb93c0eff43f2920ccb413d0be08/rapidfuzz-3.14.5-cp313-cp313-win32.whl", hash = "sha256:4a60f0057231188e3bd30216f7b4e0f279b11fa4ec818bb6c1d9f014d1562fbc", size = 1709231, upload-time = "2026-04-07T11:14:56.524Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/cb/0e251d731b3166378644238e8f0cf9e89858c024e19f75ca9f7e3ae83fd5/rapidfuzz-3.14.5-cp313-cp313-win_amd64.whl", hash = "sha256:11bfc2ed8fbe4ab86bd516fadefab126f90e6dcadffa761739fcb304707dfd35", size = 1538519, upload-time = "2026-04-07T11:14:58.635Z" },
+    { url = "https://files.pythonhosted.org/packages/30/6f/4548132acc947db6d5346a248e44a8b3a22d608ef30e770fb578caaf2d00/rapidfuzz-3.14.5-cp313-cp313-win_arm64.whl", hash = "sha256:b486b5218808f6f4dc471b114b1054e63553db69705c97da0271f47bd706aedd", size = 812628, upload-time = "2026-04-07T11:15:00.552Z" },
+    { url = "https://files.pythonhosted.org/packages/00/60/69b177577290c5eab892c6f75fe89c3aff3f9ae80298a78d9372b1cecb9a/rapidfuzz-3.14.5-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:39ef8658aaf67d51667e7bdaf7096f432333377d8302ac43c70b5df8a4cf89b8", size = 1970231, upload-time = "2026-04-07T11:15:02.603Z" },
+    { url = "https://files.pythonhosted.org/packages/48/38/2fd790052659cc4e2907b63c25433f0987864b445c1aeec1a302ef5ad948/rapidfuzz-3.14.5-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:9ad37a0be705b544af6296da8edddc260d10a8ae5462530fc9991f66498bb1f9", size = 1194394, upload-time = "2026-04-07T11:15:04.572Z" },
+    { url = "https://files.pythonhosted.org/packages/80/f4/28430ad8472fc3536e8ebd51a864a226e979cfe924c6e3f83d111373aa74/rapidfuzz-3.14.5-cp313-cp313t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d45e06f60729e07d9b20c205f7e5cff90b6ef2584e852eecf46e045aea69627d", size = 1377051, upload-time = "2026-04-07T11:15:06.728Z" },
+    { url = "https://files.pythonhosted.org/packages/77/7e/9aeacabcfd1e77397968362e5b98fe14248b8307011136b17daf99752a8e/rapidfuzz-3.14.5-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e52da10236aa6212de71b9e170bace65b64b129c0dea7fc243d6c9ce976f5074", size = 3160565, upload-time = "2026-04-07T11:15:08.667Z" },
+    { url = "https://files.pythonhosted.org/packages/56/f4/db4dd7be0cd2f2022117ac5407d905f435d60e48baaea313a567ad27e865/rapidfuzz-3.14.5-cp313-cp313t-manylinux_2_39_riscv64.whl", hash = "sha256:440d30faaf682ca496170a7f0cc5453ec942e3e079f0fd802c9a7f938dfb50a3", size = 1442113, upload-time = "2026-04-07T11:15:11.138Z" },
+    { url = "https://files.pythonhosted.org/packages/a4/99/0e9f6aa57f3e32a767216f797e56dc96b720fcecfb9d8ee907ecc82f8d66/rapidfuzz-3.14.5-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:56227a61fd3d17b0cd9793132431f3a3d07c8654be96794ba9f89fe0fc8b2d09", size = 2396618, upload-time = "2026-04-07T11:15:13.154Z" },
+    { url = "https://files.pythonhosted.org/packages/60/94/44a78e39ffce17cbdd3e2b53b696acc751d5d153be0f499d052b07a4d904/rapidfuzz-3.14.5-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:2e83cd2e25bb4edd97b689d9979d9c3acccdaaf26ceac08212ceece202febcfa", size = 2478220, upload-time = "2026-04-07T11:15:15.193Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/df/454311469a09a507e9d784a35796742bec22e4cebe75551e2da4e0e290fd/rapidfuzz-3.14.5-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:af3b859726cd3374287e405e14b9634563c078c5531a4f62375508addebddad1", size = 4265027, upload-time = "2026-04-07T11:15:17.28Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/01/175465a9ab3e3b70ba669058372f009d1d49c1746e2dcd56b69df188d3a5/rapidfuzz-3.14.5-cp313-cp313t-win32.whl", hash = "sha256:8ce1d850b3c0178440efde9e884d98421b5e87ff925f364d6d79e23910d7593f", size = 1766814, upload-time = "2026-04-07T11:15:19.687Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/a0/a9b84a47af06ebed94a1439eb2f02adebfb8628bcd30af1fe3e02f5ef56c/rapidfuzz-3.14.5-cp313-cp313t-win_amd64.whl", hash = "sha256:c84af70bcf34e99aee894e46a0f1ac77f17d0ef828179c387407642e2466d28a", size = 1582448, upload-time = "2026-04-07T11:15:21.98Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/f1/5937800238b3f8248e70860d79f69ba8f73e764fff47e36bc9e2f26dbcc6/rapidfuzz-3.14.5-cp313-cp313t-win_arm64.whl", hash = "sha256:aac0ad28c686a5e72b81668b906c030ee28050b244544b8af68e12fb32543895", size = 832932, upload-time = "2026-04-07T11:15:24.358Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/ee/e71853bf82846c5c2174b924b71d8e8099fb05ff87c958a720380b434ba3/rapidfuzz-3.14.5-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:578e6051f6d5e6200c259b47a103cf06bb875ab5814d17333fc0b5c290b22f4c", size = 1888603, upload-time = "2026-04-07T11:16:18.223Z" },
+    { url = "https://files.pythonhosted.org/packages/36/82/40f67b730f32be2ebad9f62add1571c754f52249254b2e88af094b907eee/rapidfuzz-3.14.5-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:fbf1b8bb2695415b347f3727da1addca2acb82c9b97ac86bebf8b1bead1eb12d", size = 1120599, upload-time = "2026-04-07T11:16:20.682Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/9f/a3635cc4ec8fc6e14b46e7db1f7f8763d8c4bef33dcc124eea2e6cb2c8f3/rapidfuzz-3.14.5-pp311-pypy311_pp73-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8f4a8f5cc84c7ad6bffa0e9947b33eb343ad66e6b53e94fe54378a5508c5ed53", size = 1348524, upload-time = "2026-04-07T11:16:23.451Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/1b/2b229520f0b48464cfcd7aa758f74551d12c9bc4ab544022a60210aab064/rapidfuzz-3.14.5-pp311-pypy311_pp73-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:97c6d85283629646fa87acc22c66b30ea9d4de7f6fdf887daa2e30fa041829b5", size = 3099302, upload-time = "2026-04-07T11:16:25.858Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/b5/363906b1064fc6fe611783a61764927bbd91919aaaabe8cba82151ca93ef/rapidfuzz-3.14.5-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:dfef96543ced67d9513a422755db422ae1dc34dade0a1485e0b43e7342ed3ebf", size = 1509889, upload-time = "2026-04-07T11:16:28.487Z" },
 ]
 
 [[package]]
 name = "rapidocr"
-version = "3.7.0"
+version = "3.8.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "colorlog" },
@@ -6988,7 +7075,7 @@ dependencies = [
     { name = "tqdm" },
 ]
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/5c/b8/011338eec8aea40cf9b82da7481f3e65e100537cff4c866b3c1b1e719b97/rapidocr-3.7.0-py3-none-any.whl", hash = "sha256:ace47f037956fa3780875f8556a0f27ab20d91962d36a9a2816aa367bb48718f", size = 15080131, upload-time = "2026-03-04T15:38:20.339Z" },
+    { url = "https://files.pythonhosted.org/packages/49/1f/5f815e17c0b02b8f937b5b680b85d0ec5f34b195314dfa8f11ed14a6de03/rapidocr-3.8.0-py3-none-any.whl", hash = "sha256:54abb10883d588120a3390bc447566f1590aea641e127f63a4ca44415fecd18a", size = 15082360, upload-time = "2026-04-08T13:42:15.89Z" },
 ]
 
 [[package]]
@@ -7767,49 +7854,49 @@ wheels = [
 
 [[package]]
 name = "sqlalchemy"
-version = "2.0.48"
+version = "2.0.49"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "greenlet", marker = "platform_machine == 'AMD64' or platform_machine == 'WIN32' or platform_machine == 'aarch64' or platform_machine == 'amd64' or platform_machine == 'ppc64le' or platform_machine == 'win32' or platform_machine == 'x86_64'" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/1f/73/b4a9737255583b5fa858e0bb8e116eb94b88c910164ed2ed719147bde3de/sqlalchemy-2.0.48.tar.gz", hash = "sha256:5ca74f37f3369b45e1f6b7b06afb182af1fd5dde009e4ffd831830d98cbe5fe7", size = 9886075, upload-time = "2026-03-02T15:28:51.474Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/09/45/461788f35e0364a8da7bda51a1fe1b09762d0c32f12f63727998d85a873b/sqlalchemy-2.0.49.tar.gz", hash = "sha256:d15950a57a210e36dd4cec1aac22787e2a4d57ba9318233e2ef8b2daf9ff2d5f", size = 9898221, upload-time = "2026-04-03T16:38:11.704Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/9a/67/1235676e93dd3b742a4a8eddfae49eea46c85e3eed29f0da446a8dd57500/sqlalchemy-2.0.48-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:7001dc9d5f6bb4deb756d5928eaefe1930f6f4179da3924cbd95ee0e9f4dce89", size = 2157384, upload-time = "2026-03-02T15:38:26.781Z" },
-    { url = "https://files.pythonhosted.org/packages/4d/d7/fa728b856daa18c10e1390e76f26f64ac890c947008284387451d56ca3d0/sqlalchemy-2.0.48-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1a89ce07ad2d4b8cfc30bd5889ec40613e028ed80ef47da7d9dd2ce969ad30e0", size = 3236981, upload-time = "2026-03-02T15:58:53.53Z" },
-    { url = "https://files.pythonhosted.org/packages/5c/ad/6c4395649a212a6c603a72c5b9ab5dce3135a1546cfdffa3c427e71fd535/sqlalchemy-2.0.48-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:10853a53a4a00417a00913d270dddda75815fcb80675874285f41051c094d7dd", size = 3235232, upload-time = "2026-03-02T15:52:25.654Z" },
-    { url = "https://files.pythonhosted.org/packages/01/f4/58f845e511ac0509765a6f85eb24924c1ef0d54fb50de9d15b28c3601458/sqlalchemy-2.0.48-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:fac0fa4e4f55f118fd87177dacb1c6522fe39c28d498d259014020fec9164c29", size = 3188106, upload-time = "2026-03-02T15:58:55.193Z" },
-    { url = "https://files.pythonhosted.org/packages/3f/f9/6dcc7bfa5f5794c3a095e78cd1de8269dfb5584dfd4c2c00a50d3c1ade44/sqlalchemy-2.0.48-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:3713e21ea67bca727eecd4a24bf68bcd414c403faae4989442be60994301ded0", size = 3209522, upload-time = "2026-03-02T15:52:27.407Z" },
-    { url = "https://files.pythonhosted.org/packages/d7/5a/b632875ab35874d42657f079529f0745410604645c269a8c21fb4272ff7a/sqlalchemy-2.0.48-cp310-cp310-win32.whl", hash = "sha256:d404dc897ce10e565d647795861762aa2d06ca3f4a728c5e9a835096c7059018", size = 2117695, upload-time = "2026-03-02T15:46:51.389Z" },
-    { url = "https://files.pythonhosted.org/packages/de/03/9752eb2a41afdd8568e41ac3c3128e32a0a73eada5ab80483083604a56d1/sqlalchemy-2.0.48-cp310-cp310-win_amd64.whl", hash = "sha256:841a94c66577661c1f088ac958cd767d7c9bf507698f45afffe7a4017049de76", size = 2140928, upload-time = "2026-03-02T15:46:52.992Z" },
-    { url = "https://files.pythonhosted.org/packages/d7/6d/b8b78b5b80f3c3ab3f7fa90faa195ec3401f6d884b60221260fd4d51864c/sqlalchemy-2.0.48-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:1b4c575df7368b3b13e0cebf01d4679f9a28ed2ae6c1cd0b1d5beffb6b2007dc", size = 2157184, upload-time = "2026-03-02T15:38:28.161Z" },
-    { url = "https://files.pythonhosted.org/packages/21/4b/4f3d4a43743ab58b95b9ddf5580a265b593d017693df9e08bd55780af5bb/sqlalchemy-2.0.48-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e83e3f959aaa1c9df95c22c528096d94848a1bc819f5d0ebf7ee3df0ca63db6c", size = 3313555, upload-time = "2026-03-02T15:58:57.21Z" },
-    { url = "https://files.pythonhosted.org/packages/21/dd/3b7c53f1dbbf736fd27041aee68f8ac52226b610f914085b1652c2323442/sqlalchemy-2.0.48-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6f7b7243850edd0b8b97043f04748f31de50cf426e939def5c16bedb540698f7", size = 3313057, upload-time = "2026-03-02T15:52:29.366Z" },
-    { url = "https://files.pythonhosted.org/packages/d9/cc/3e600a90ae64047f33313d7d32e5ad025417f09d2ded487e8284b5e21a15/sqlalchemy-2.0.48-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:82745b03b4043e04600a6b665cb98697c4339b24e34d74b0a2ac0a2488b6f94d", size = 3265431, upload-time = "2026-03-02T15:58:59.096Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/19/780138dacfe3f5024f4cf96e4005e91edf6653d53d3673be4844578faf1d/sqlalchemy-2.0.48-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:e5e088bf43f6ee6fec7dbf1ef7ff7774a616c236b5c0cb3e00662dd71a56b571", size = 3287646, upload-time = "2026-03-02T15:52:31.569Z" },
-    { url = "https://files.pythonhosted.org/packages/40/fd/f32ced124f01a23151f4777e4c705f3a470adc7bd241d9f36a7c941a33bf/sqlalchemy-2.0.48-cp311-cp311-win32.whl", hash = "sha256:9c7d0a77e36b5f4b01ca398482230ab792061d243d715299b44a0b55c89fe617", size = 2116956, upload-time = "2026-03-02T15:46:54.535Z" },
-    { url = "https://files.pythonhosted.org/packages/58/d5/dd767277f6feef12d05651538f280277e661698f617fa4d086cce6055416/sqlalchemy-2.0.48-cp311-cp311-win_amd64.whl", hash = "sha256:583849c743e0e3c9bb7446f5b5addeacedc168d657a69b418063dfdb2d90081c", size = 2141627, upload-time = "2026-03-02T15:46:55.849Z" },
-    { url = "https://files.pythonhosted.org/packages/ef/91/a42ae716f8925e9659df2da21ba941f158686856107a61cc97a95e7647a3/sqlalchemy-2.0.48-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:348174f228b99f33ca1f773e85510e08927620caa59ffe7803b37170df30332b", size = 2155737, upload-time = "2026-03-02T15:49:13.207Z" },
-    { url = "https://files.pythonhosted.org/packages/b9/52/f75f516a1f3888f027c1cfb5d22d4376f4b46236f2e8669dcb0cddc60275/sqlalchemy-2.0.48-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:53667b5f668991e279d21f94ccfa6e45b4e3f4500e7591ae59a8012d0f010dcb", size = 3337020, upload-time = "2026-03-02T15:50:34.547Z" },
-    { url = "https://files.pythonhosted.org/packages/37/9a/0c28b6371e0cdcb14f8f1930778cb3123acfcbd2c95bb9cf6b4a2ba0cce3/sqlalchemy-2.0.48-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:34634e196f620c7a61d18d5cf7dc841ca6daa7961aed75d532b7e58b309ac894", size = 3349983, upload-time = "2026-03-02T15:53:25.542Z" },
-    { url = "https://files.pythonhosted.org/packages/1c/46/0aee8f3ff20b1dcbceb46ca2d87fcc3d48b407925a383ff668218509d132/sqlalchemy-2.0.48-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:546572a1793cc35857a2ffa1fe0e58571af1779bcc1ffa7c9fb0839885ed69a9", size = 3279690, upload-time = "2026-03-02T15:50:36.277Z" },
-    { url = "https://files.pythonhosted.org/packages/ce/8c/a957bc91293b49181350bfd55e6dfc6e30b7f7d83dc6792d72043274a390/sqlalchemy-2.0.48-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:07edba08061bc277bfdc772dd2a1a43978f5a45994dd3ede26391b405c15221e", size = 3314738, upload-time = "2026-03-02T15:53:27.519Z" },
-    { url = "https://files.pythonhosted.org/packages/4b/44/1d257d9f9556661e7bdc83667cc414ba210acfc110c82938cb3611eea58f/sqlalchemy-2.0.48-cp312-cp312-win32.whl", hash = "sha256:908a3fa6908716f803b86896a09a2c4dde5f5ce2bb07aacc71ffebb57986ce99", size = 2115546, upload-time = "2026-03-02T15:54:31.591Z" },
-    { url = "https://files.pythonhosted.org/packages/f2/af/c3c7e1f3a2b383155a16454df62ae8c62a30dd238e42e68c24cebebbfae6/sqlalchemy-2.0.48-cp312-cp312-win_amd64.whl", hash = "sha256:68549c403f79a8e25984376480959975212a670405e3913830614432b5daa07a", size = 2142484, upload-time = "2026-03-02T15:54:34.072Z" },
-    { url = "https://files.pythonhosted.org/packages/d1/c6/569dc8bf3cd375abc5907e82235923e986799f301cd79a903f784b996fca/sqlalchemy-2.0.48-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e3070c03701037aa418b55d36532ecb8f8446ed0135acb71c678dbdf12f5b6e4", size = 2152599, upload-time = "2026-03-02T15:49:14.41Z" },
-    { url = "https://files.pythonhosted.org/packages/6d/ff/f4e04a4bd5a24304f38cb0d4aa2ad4c0fb34999f8b884c656535e1b2b74c/sqlalchemy-2.0.48-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2645b7d8a738763b664a12a1542c89c940daa55196e8d73e55b169cc5c99f65f", size = 3278825, upload-time = "2026-03-02T15:50:38.269Z" },
-    { url = "https://files.pythonhosted.org/packages/fe/88/cb59509e4668d8001818d7355d9995be90c321313078c912420603a7cb95/sqlalchemy-2.0.48-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b19151e76620a412c2ac1c6f977ab1b9fa7ad43140178345136456d5265b32ed", size = 3295200, upload-time = "2026-03-02T15:53:29.366Z" },
-    { url = "https://files.pythonhosted.org/packages/87/dc/1609a4442aefd750ea2f32629559394ec92e89ac1d621a7f462b70f736ff/sqlalchemy-2.0.48-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:5b193a7e29fd9fa56e502920dca47dffe60f97c863494946bd698c6058a55658", size = 3226876, upload-time = "2026-03-02T15:50:39.802Z" },
-    { url = "https://files.pythonhosted.org/packages/37/c3/6ae2ab5ea2fa989fbac4e674de01224b7a9d744becaf59bb967d62e99bed/sqlalchemy-2.0.48-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:36ac4ddc3d33e852da9cb00ffb08cea62ca05c39711dc67062ca2bb1fae35fd8", size = 3265045, upload-time = "2026-03-02T15:53:31.421Z" },
-    { url = "https://files.pythonhosted.org/packages/6f/82/ea4665d1bb98c50c19666e672f21b81356bd6077c4574e3d2bbb84541f53/sqlalchemy-2.0.48-cp313-cp313-win32.whl", hash = "sha256:389b984139278f97757ea9b08993e7b9d1142912e046ab7d82b3fbaeb0209131", size = 2113700, upload-time = "2026-03-02T15:54:35.825Z" },
-    { url = "https://files.pythonhosted.org/packages/b7/2b/b9040bec58c58225f073f5b0c1870defe1940835549dafec680cbd58c3c3/sqlalchemy-2.0.48-cp313-cp313-win_amd64.whl", hash = "sha256:d612c976cbc2d17edfcc4c006874b764e85e990c29ce9bd411f926bbfb02b9a2", size = 2139487, upload-time = "2026-03-02T15:54:37.079Z" },
-    { url = "https://files.pythonhosted.org/packages/f4/f4/7b17bd50244b78a49d22cc63c969d71dc4de54567dc152a9b46f6fae40ce/sqlalchemy-2.0.48-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:69f5bc24904d3bc3640961cddd2523e361257ef68585d6e364166dfbe8c78fae", size = 3558851, upload-time = "2026-03-02T15:57:48.607Z" },
-    { url = "https://files.pythonhosted.org/packages/20/0d/213668e9aca61d370f7d2a6449ea4ec699747fac67d4bda1bb3d129025be/sqlalchemy-2.0.48-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:fd08b90d211c086181caed76931ecfa2bdfc83eea3cfccdb0f82abc6c4b876cb", size = 3525525, upload-time = "2026-03-02T16:04:38.058Z" },
-    { url = "https://files.pythonhosted.org/packages/85/d7/a84edf412979e7d59c69b89a5871f90a49228360594680e667cb2c46a828/sqlalchemy-2.0.48-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:1ccd42229aaac2df431562117ac7e667d702e8e44afdb6cf0e50fa3f18160f0b", size = 3466611, upload-time = "2026-03-02T15:57:50.759Z" },
-    { url = "https://files.pythonhosted.org/packages/86/55/42404ce5770f6be26a2b0607e7866c31b9a4176c819e9a7a5e0a055770be/sqlalchemy-2.0.48-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:f0dcbc588cd5b725162c076eb9119342f6579c7f7f55057bb7e3c6ff27e13121", size = 3475812, upload-time = "2026-03-02T16:04:40.092Z" },
-    { url = "https://files.pythonhosted.org/packages/ae/ae/29b87775fadc43e627cf582fe3bda4d02e300f6b8f2747c764950d13784c/sqlalchemy-2.0.48-cp313-cp313t-win32.whl", hash = "sha256:9764014ef5e58aab76220c5664abb5d47d5bc858d9debf821e55cfdd0f128485", size = 2141335, upload-time = "2026-03-02T15:52:51.518Z" },
-    { url = "https://files.pythonhosted.org/packages/91/44/f39d063c90f2443e5b46ec4819abd3d8de653893aae92df42a5c4f5843de/sqlalchemy-2.0.48-cp313-cp313t-win_amd64.whl", hash = "sha256:e2f35b4cccd9ed286ad62e0a3c3ac21e06c02abc60e20aa51a3e305a30f5fa79", size = 2173095, upload-time = "2026-03-02T15:52:52.79Z" },
-    { url = "https://files.pythonhosted.org/packages/46/2c/9664130905f03db57961b8980b05cab624afd114bf2be2576628a9f22da4/sqlalchemy-2.0.48-py3-none-any.whl", hash = "sha256:a66fe406437dd65cacd96a72689a3aaaecaebbcd62d81c5ac1c0fdbeac835096", size = 1940202, upload-time = "2026-03-02T15:52:43.285Z" },
+    { url = "https://files.pythonhosted.org/packages/96/76/f908955139842c362aa877848f42f9249642d5b69e06cee9eae5111da1bd/sqlalchemy-2.0.49-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:42e8804962f9e6f4be2cbaedc0c3718f08f60a16910fa3d86da5a1e3b1bfe60f", size = 2159321, upload-time = "2026-04-03T16:50:11.8Z" },
+    { url = "https://files.pythonhosted.org/packages/24/e2/17ba0b7bfbd8de67196889b6d951de269e8a46057d92baca162889beb16d/sqlalchemy-2.0.49-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:cc992c6ed024c8c3c592c5fc9846a03dd68a425674900c70122c77ea16c5fb0b", size = 3238937, upload-time = "2026-04-03T16:54:45.731Z" },
+    { url = "https://files.pythonhosted.org/packages/90/1e/410dd499c039deacff395eec01a9da057125fcd0c97e3badc252c6a2d6a7/sqlalchemy-2.0.49-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6eb188b84269f357669b62cb576b5b918de10fb7c728a005fa0ebb0b758adce1", size = 3237188, upload-time = "2026-04-03T16:56:53.217Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/06/e797a8b98a3993ac4bc785309b9b6d005457fc70238ee6cefa7c8867a92e/sqlalchemy-2.0.49-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:62557958002b69699bdb7f5137c6714ca1133f045f97b3903964f47db97ea339", size = 3190061, upload-time = "2026-04-03T16:54:47.489Z" },
+    { url = "https://files.pythonhosted.org/packages/44/d3/5a9f7ef580af1031184b38235da6ac58c3b571df01c9ec061c44b2b0c5a6/sqlalchemy-2.0.49-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:da9b91bca419dc9b9267ffadde24eae9b1a6bffcd09d0a207e5e3af99a03ce0d", size = 3211477, upload-time = "2026-04-03T16:56:55.056Z" },
+    { url = "https://files.pythonhosted.org/packages/69/ec/7be8c8cb35f038e963a203e4fe5a028989167cc7299927b7cf297c271e37/sqlalchemy-2.0.49-cp310-cp310-win32.whl", hash = "sha256:5e61abbec255be7b122aa461021daa7c3f310f3e743411a67079f9b3cc91ece3", size = 2119965, upload-time = "2026-04-03T17:00:50.009Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/31/0defb93e3a10b0cf7d1271aedd87251a08c3a597ee4f353281769b547b5a/sqlalchemy-2.0.49-cp310-cp310-win_amd64.whl", hash = "sha256:0c98c59075b890df8abfcc6ad632879540f5791c68baebacb4f833713b510e75", size = 2142935, upload-time = "2026-04-03T17:00:51.675Z" },
+    { url = "https://files.pythonhosted.org/packages/60/b5/e3617cc67420f8f403efebd7b043128f94775e57e5b84e7255203390ceae/sqlalchemy-2.0.49-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:c5070135e1b7409c4161133aa525419b0062088ed77c92b1da95366ec5cbebbe", size = 2159126, upload-time = "2026-04-03T16:50:13.242Z" },
+    { url = "https://files.pythonhosted.org/packages/20/9b/91ca80403b17cd389622a642699e5f6564096b698e7cdcbcbb6409898bc4/sqlalchemy-2.0.49-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9ac7a3e245fd0310fd31495eb61af772e637bdf7d88ee81e7f10a3f271bff014", size = 3315509, upload-time = "2026-04-03T16:54:49.332Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/61/0722511d98c54de95acb327824cb759e8653789af2b1944ab1cc69d32565/sqlalchemy-2.0.49-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4d4e5a0ceba319942fa6b585cf82539288a61e314ef006c1209f734551ab9536", size = 3315014, upload-time = "2026-04-03T16:56:56.376Z" },
+    { url = "https://files.pythonhosted.org/packages/46/55/d514a653ffeb4cebf4b54c47bec32ee28ad89d39fafba16eeed1d81dccd5/sqlalchemy-2.0.49-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:3ddcb27fb39171de36e207600116ac9dfd4ae46f86c82a9bf3934043e80ebb88", size = 3267388, upload-time = "2026-04-03T16:54:51.272Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/16/0dcc56cb6d3335c1671a2258f5d2cb8267c9a2260e27fde53cbfb1b3540a/sqlalchemy-2.0.49-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:32fe6a41ad97302db2931f05bb91abbcc65b5ce4c675cd44b972428dd2947700", size = 3289602, upload-time = "2026-04-03T16:56:57.63Z" },
+    { url = "https://files.pythonhosted.org/packages/51/6c/f8ab6fb04470a133cd80608db40aa292e6bae5f162c3a3d4ab19544a67af/sqlalchemy-2.0.49-cp311-cp311-win32.whl", hash = "sha256:46d51518d53edfbe0563662c96954dc8fcace9832332b914375f45a99b77cc9a", size = 2119044, upload-time = "2026-04-03T17:00:53.455Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/59/55a6d627d04b6ebb290693681d7683c7da001eddf90b60cfcc41ee907978/sqlalchemy-2.0.49-cp311-cp311-win_amd64.whl", hash = "sha256:951d4a210744813be63019f3df343bf233b7432aadf0db54c75802247330d3af", size = 2143642, upload-time = "2026-04-03T17:00:54.769Z" },
+    { url = "https://files.pythonhosted.org/packages/49/b3/2de412451330756aaaa72d27131db6dde23995efe62c941184e15242a5fa/sqlalchemy-2.0.49-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:4bbccb45260e4ff1b7db0be80a9025bb1e6698bdb808b83fff0000f7a90b2c0b", size = 2157681, upload-time = "2026-04-03T16:53:07.132Z" },
+    { url = "https://files.pythonhosted.org/packages/50/84/b2a56e2105bd11ebf9f0b93abddd748e1a78d592819099359aa98134a8bf/sqlalchemy-2.0.49-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:fb37f15714ec2652d574f021d479e78cd4eb9d04396dca36568fdfffb3487982", size = 3338976, upload-time = "2026-04-03T17:07:40Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/fa/65fcae2ed62f84ab72cf89536c7c3217a156e71a2c111b1305ab6f0690e2/sqlalchemy-2.0.49-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3bb9ec6436a820a4c006aad1ac351f12de2f2dbdaad171692ee457a02429b672", size = 3351937, upload-time = "2026-04-03T17:12:23.374Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/2f/6fd118563572a7fe475925742eb6b3443b2250e346a0cc27d8d408e73773/sqlalchemy-2.0.49-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8d6efc136f44a7e8bc8088507eaabbb8c2b55b3dbb63fe102c690da0ddebe55e", size = 3281646, upload-time = "2026-04-03T17:07:41.949Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/d7/410f4a007c65275b9cf82354adb4bb8ba587b176d0a6ee99caa16fe638f8/sqlalchemy-2.0.49-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:e06e617e3d4fd9e51d385dfe45b077a41e9d1b033a7702551e3278ac597dc750", size = 3316695, upload-time = "2026-04-03T17:12:25.642Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/95/81f594aa60ded13273a844539041ccf1e66c5a7bed0a8e27810a3b52d522/sqlalchemy-2.0.49-cp312-cp312-win32.whl", hash = "sha256:83101a6930332b87653886c01d1ee7e294b1fe46a07dd9a2d2b4f91bcc88eec0", size = 2117483, upload-time = "2026-04-03T17:05:40.896Z" },
+    { url = "https://files.pythonhosted.org/packages/47/9e/fd90114059175cac64e4fafa9bf3ac20584384d66de40793ae2e2f26f3bb/sqlalchemy-2.0.49-cp312-cp312-win_amd64.whl", hash = "sha256:618a308215b6cececb6240b9abde545e3acdabac7ae3e1d4e666896bf5ba44b4", size = 2144494, upload-time = "2026-04-03T17:05:42.282Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/81/81755f50eb2478eaf2049728491d4ea4f416c1eb013338682173259efa09/sqlalchemy-2.0.49-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:df2d441bacf97022e81ad047e1597552eb3f83ca8a8f1a1fdd43cd7fe3898120", size = 2154547, upload-time = "2026-04-03T16:53:08.64Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/bc/3494270da80811d08bcfa247404292428c4fe16294932bce5593f215cad9/sqlalchemy-2.0.49-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8e20e511dc15265fb433571391ba313e10dd8ea7e509d51686a51313b4ac01a2", size = 3280782, upload-time = "2026-04-03T17:07:43.508Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/f5/038741f5e747a5f6ea3e72487211579d8cbea5eb9827a9cbd61d0108c4bd/sqlalchemy-2.0.49-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:47604cb2159f8bbd5a1ab48a714557156320f20871ee64d550d8bf2683d980d3", size = 3297156, upload-time = "2026-04-03T17:12:27.697Z" },
+    { url = "https://files.pythonhosted.org/packages/88/50/a6af0ff9dc954b43a65ca9b5367334e45d99684c90a3d3413fc19a02d43c/sqlalchemy-2.0.49-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:22d8798819f86720bc646ab015baff5ea4c971d68121cb36e2ebc2ee43ead2b7", size = 3228832, upload-time = "2026-04-03T17:07:45.38Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/d1/5f6bdad8de0bf546fc74370939621396515e0cdb9067402d6ba1b8afbe9a/sqlalchemy-2.0.49-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:9b1c058c171b739e7c330760044803099c7fff11511e3ab3573e5327116a9c33", size = 3267000, upload-time = "2026-04-03T17:12:29.657Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/30/ad62227b4a9819a5e1c6abff77c0f614fa7c9326e5a3bdbee90f7139382b/sqlalchemy-2.0.49-cp313-cp313-win32.whl", hash = "sha256:a143af2ea6672f2af3f44ed8f9cd020e9cc34c56f0e8db12019d5d9ecf41cb3b", size = 2115641, upload-time = "2026-04-03T17:05:43.989Z" },
+    { url = "https://files.pythonhosted.org/packages/17/3a/7215b1b7d6d49dc9a87211be44562077f5f04f9bb5a59552c1c8e2d98173/sqlalchemy-2.0.49-cp313-cp313-win_amd64.whl", hash = "sha256:12b04d1db2663b421fe072d638a138460a51d5a862403295671c4f3987fb9148", size = 2141498, upload-time = "2026-04-03T17:05:45.7Z" },
+    { url = "https://files.pythonhosted.org/packages/28/4b/52a0cb2687a9cd1648252bb257be5a1ba2c2ded20ba695c65756a55a15a4/sqlalchemy-2.0.49-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:24bd94bb301ec672d8f0623eba9226cc90d775d25a0c92b5f8e4965d7f3a1518", size = 3560807, upload-time = "2026-04-03T16:58:31.666Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/d8/fda95459204877eed0458550d6c7c64c98cc50c2d8d618026737de9ed41a/sqlalchemy-2.0.49-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a51d3db74ba489266ef55c7a4534eb0b8db9a326553df481c11e5d7660c8364d", size = 3527481, upload-time = "2026-04-03T17:06:00.155Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/0a/2aac8b78ac6487240cf7afef8f203ca783e8796002dc0cf65c4ee99ff8bb/sqlalchemy-2.0.49-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:55250fe61d6ebfd6934a272ee16ef1244e0f16b7af6cd18ab5b1fc9f08631db0", size = 3468565, upload-time = "2026-04-03T16:58:33.414Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/3d/ce71cfa82c50a373fd2148b3c870be05027155ce791dc9a5dcf439790b8b/sqlalchemy-2.0.49-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:46796877b47034b559a593d7e4b549aba151dae73f9e78212a3478161c12ab08", size = 3477769, upload-time = "2026-04-03T17:06:02.787Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/e8/0a9f5c1f7c6f9ca480319bf57c2d7423f08d31445974167a27d14483c948/sqlalchemy-2.0.49-cp313-cp313t-win32.whl", hash = "sha256:9c4969a86e41454f2858256c39bdfb966a20961e9b58bf8749b65abf447e9a8d", size = 2143319, upload-time = "2026-04-03T17:02:04.328Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/51/fb5240729fbec73006e137c4f7a7918ffd583ab08921e6ff81a999d6517a/sqlalchemy-2.0.49-cp313-cp313t-win_amd64.whl", hash = "sha256:b9870d15ef00e4d0559ae10ee5bc71b654d1f20076dbe8bc7ed19b4c0625ceba", size = 2175104, upload-time = "2026-04-03T17:02:05.989Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/30/8519fdde58a7bdf155b714359791ad1dc018b47d60269d5d160d311fdc36/sqlalchemy-2.0.49-py3-none-any.whl", hash = "sha256:ec44cfa7ef1a728e88ad41674de50f6db8cfdb3e2af84af86e0041aaf02d43d0", size = 1942158, upload-time = "2026-04-03T16:53:44.135Z" },
 ]
 
 [[package]]
@@ -7836,7 +7923,7 @@ wheels = [
 
 [[package]]
 name = "stagehand"
-version = "3.19.1"
+version = "3.19.5"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "anyio" },
@@ -7846,12 +7933,12 @@ dependencies = [
     { name = "sniffio" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/86/81/da1fc0e559708f6d3c722e2a231209e4f0bcd235e5f7864467598a046b94/stagehand-3.19.1.tar.gz", hash = "sha256:79f90149617c66b52f3d5ef98eec670084576ced21adfc5047f0287f1825bd0a", size = 279625, upload-time = "2026-03-31T22:05:48.01Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/d9/f8/ccd2bb2758a4eaf0af3846e097ff206e0aa76c8d3b5aa2bded77fb47825e/stagehand-3.19.5.tar.gz", hash = "sha256:3cb8279ac82051e584b34d26e87dc764f0ccad766a01625198ca578eb35f0b6c", size = 281033, upload-time = "2026-04-03T20:21:09.792Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/82/f5/691c3e050b059fdb949dcb34e6e692e22bf2bb5913d595a7142afa33fa9d/stagehand-3.19.1-py3-none-macosx_10_9_x86_64.whl", hash = "sha256:ec7e2f0ed5a33c8374ce29cc0be96d5bd79f3b0912c862268df9a87cba3abee0", size = 34492500, upload-time = "2026-03-31T22:05:49.574Z" },
-    { url = "https://files.pythonhosted.org/packages/42/c8/4d40169828de0ed9f9d108aa8c8a5a4e2ee42d13c4a5f2612cec6acec63e/stagehand-3.19.1-py3-none-macosx_11_0_arm64.whl", hash = "sha256:002989a7730c91c51ea38c1b11b0b07b25610ccf823779e709951568ae0e65de", size = 33190159, upload-time = "2026-03-31T22:05:55.079Z" },
-    { url = "https://files.pythonhosted.org/packages/25/4d/787a3a5a4a0a0661dba24d8904734d48934c28b20ba9af842c8c84892487/stagehand-3.19.1-py3-none-manylinux2014_x86_64.whl", hash = "sha256:baea3a6cff498e096c3d1933751aa1879838d5e308b479d50e60cdd4fe104d99", size = 37269772, upload-time = "2026-03-31T22:05:45.856Z" },
-    { url = "https://files.pythonhosted.org/packages/f1/65/03072d2d5e8178fd4cfa7cbb51088ea4248c1a29ad0cb84c4ab813e5e416/stagehand-3.19.1-py3-none-win_amd64.whl", hash = "sha256:1cd73285d80517a674aaaa40a3bf40cf9b85da50e8f29a01d7f5f2ef2f11d70e", size = 30754952, upload-time = "2026-03-31T22:05:52.481Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/6f/a47bad258bfafc193ebb8e0e8c440e8028c9ab28b54a333b46aa3c0cff53/stagehand-3.19.5-py3-none-macosx_10_9_x86_64.whl", hash = "sha256:14f39a4f8d30d77c089166185c705f66aade25432b903a663a937b3747439c26", size = 34495874, upload-time = "2026-04-03T20:21:07.366Z" },
+    { url = "https://files.pythonhosted.org/packages/72/f7/e39868903121f1a80ae6eda088383362cd2d3a578c04493a2f83c1aac1da/stagehand-3.19.5-py3-none-macosx_11_0_arm64.whl", hash = "sha256:80ed0d732cb9c3e952ad851e071dad5775a9ea88d2787c006289d61097fd2609", size = 33193535, upload-time = "2026-04-03T20:21:18.536Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/0b/35cb92bb53e9539c0147892dbd0a227b43bf0d8adcd0a8e867dc5f2bf7fd/stagehand-3.19.5-py3-none-manylinux2014_x86_64.whl", hash = "sha256:aa947a5f6241f5953ac238cd9b0ab72e0cb87f559f97e5ee875f83dbc0c351d1", size = 37273148, upload-time = "2026-04-03T20:21:11.939Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/c7/dccf63cba1941b5710dc9968218e2883a937cf6534d644bb0c5222d3f40a/stagehand-3.19.5-py3-none-win_amd64.whl", hash = "sha256:e37bf630b99b4a9b7d95f151c56b296940db88b3049b68f0abb56f9e31cc6095", size = 30758357, upload-time = "2026-04-03T20:21:15.121Z" },
 ]
 
 [[package]]
@@ -7931,7 +8018,7 @@ wheels = [
 
 [[package]]
 name = "textual"
-version = "8.2.2"
+version = "8.2.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "markdown-it-py", extra = ["linkify"] },
@@ -7941,9 +8028,9 @@ dependencies = [
     { name = "rich" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/69/b0/a9aedf13af1bfb1bf01cbc645ea5d5a4151b5d77ac1748b85c4f0d777d7d/textual-8.2.2.tar.gz", hash = "sha256:94e85267650cf679ac16ade5ac929055e836dc00798a0e6e3925926a5beee303", size = 1848623, upload-time = "2026-04-03T13:19:06.057Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/cf/2f/d44f0f12b3ddb1f0b88f7775652e99c6b5a43fd733badf4ce064bdbfef4a/textual-8.2.3.tar.gz", hash = "sha256:beea7b86b03b03558a2224f0cc35252e60ef8b0c4353b117b2f40972902d976a", size = 1848738, upload-time = "2026-04-05T09:12:45.338Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a7/18/4d59eb3f2241db6d346a90f2452fc47a19d61090a38b9cf331afe23e8431/textual-8.2.2-py3-none-any.whl", hash = "sha256:35a8f439875dc6e5b4dc7ee72dc9698a40bd13091c2de5bd5b2d4318522af8df", size = 724078, upload-time = "2026-04-03T13:19:08.115Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/28/a81d6ce9f4804818bd1231a9a6e4d56ea84ebbe8385c49591444f0234fa2/textual-8.2.3-py3-none-any.whl", hash = "sha256:5008ac581bebf1f6fa0520404261844a231e5715fdbddd10ca73916a3af48ca2", size = 724231, upload-time = "2026-04-05T09:12:48.747Z" },
 ]
 
 [[package]]
@@ -8351,11 +8438,11 @@ wheels = [
 
 [[package]]
 name = "types-aiofiles"
-version = "25.1.0.20251011"
+version = "25.1.0.20260409"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/84/6c/6d23908a8217e36704aa9c79d99a620f2fdd388b66a4b7f72fbc6b6ff6c6/types_aiofiles-25.1.0.20251011.tar.gz", hash = "sha256:1c2b8ab260cb3cd40c15f9d10efdc05a6e1e6b02899304d80dfa0410e028d3ff", size = 14535, upload-time = "2025-10-11T02:44:51.237Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/6c/66/9e62a2692792bc96c0f423f478149f4a7b84720704c546c8960b0a047c89/types_aiofiles-25.1.0.20260409.tar.gz", hash = "sha256:49e67d72bdcf9fe406f5815758a78dc34a1249bb5aa2adba78a80aec0a775435", size = 14812, upload-time = "2026-04-09T04:22:35.308Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/71/0f/76917bab27e270bb6c32addd5968d69e558e5b6f7fb4ac4cbfa282996a96/types_aiofiles-25.1.0.20251011-py3-none-any.whl", hash = "sha256:8ff8de7f9d42739d8f0dadcceeb781ce27cd8d8c4152d4a7c52f6b20edb8149c", size = 14338, upload-time = "2025-10-11T02:44:50.054Z" },
+    { url = "https://files.pythonhosted.org/packages/27/d0/28236f869ba4dfb223ecdbc267eb2bdb634b81a561dd992230a4f9ec48fa/types_aiofiles-25.1.0.20260409-py3-none-any.whl", hash = "sha256:923fedb532c772cc0f62e0ce4282725afa82ca5b41cabd9857f06b55e5eee8de", size = 14372, upload-time = "2026-04-09T04:22:34.328Z" },
 ]
 
 [[package]]
@@ -8396,11 +8483,11 @@ wheels = [
 
 [[package]]
 name = "types-pyyaml"
-version = "6.0.12.20250915"
+version = "6.0.12.20260408"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/7e/69/3c51b36d04da19b92f9e815be12753125bd8bc247ba0470a982e6979e71c/types_pyyaml-6.0.12.20250915.tar.gz", hash = "sha256:0f8b54a528c303f0e6f7165687dd33fafa81c807fcac23f632b63aa624ced1d3", size = 17522, upload-time = "2025-09-15T03:01:00.728Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/74/73/b759b1e413c31034cc01ecdfb96b38115d0ab4db55a752a3929f0cd449fd/types_pyyaml-6.0.12.20260408.tar.gz", hash = "sha256:92a73f2b8d7f39ef392a38131f76b970f8c66e4c42b3125ae872b7c93b556307", size = 17735, upload-time = "2026-04-08T04:30:50.974Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/bd/e0/1eed384f02555dde685fff1a1ac805c1c7dcb6dd019c916fe659b1c1f9ec/types_pyyaml-6.0.12.20250915-py3-none-any.whl", hash = "sha256:e7d4d9e064e89a3b3cae120b4990cd370874d2bf12fa5f46c97018dd5d3c9ab6", size = 20338, upload-time = "2025-09-15T03:00:59.218Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/f0/c391068b86abb708882c6d75a08cd7d25b2c7227dab527b3a3685a3c635b/types_pyyaml-6.0.12.20260408-py3-none-any.whl", hash = "sha256:fbc42037d12159d9c801ebfcc79ebd28335a7c13b08a4cfbc6916df78fee9384", size = 20339, upload-time = "2026-04-08T04:30:50.113Z" },
 ]
 
 [[package]]
@@ -8694,16 +8781,16 @@ wheels = [
 
 [[package]]
 name = "uvicorn"
-version = "0.42.0"
+version = "0.44.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "click" },
     { name = "h11" },
     { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/e3/ad/4a96c425be6fb67e0621e62d86c402b4a17ab2be7f7c055d9bd2f638b9e2/uvicorn-0.42.0.tar.gz", hash = "sha256:9b1f190ce15a2dd22e7758651d9b6d12df09a13d51ba5bf4fc33c383a48e1775", size = 85393, upload-time = "2026-03-16T06:19:50.077Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/5e/da/6eee1ff8b6cbeed47eeb5229749168e81eb4b7b999a1a15a7176e51410c9/uvicorn-0.44.0.tar.gz", hash = "sha256:6c942071b68f07e178264b9152f1f16dfac5da85880c4ce06366a96d70d4f31e", size = 86947, upload-time = "2026-04-06T09:23:22.826Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/0a/89/f8827ccff89c1586027a105e5630ff6139a64da2515e24dafe860bd9ae4d/uvicorn-0.42.0-py3-none-any.whl", hash = "sha256:96c30f5c7abe6f74ae8900a70e92b85ad6613b745d4879eb9b16ccad15645359", size = 68830, upload-time = "2026-03-16T06:19:48.325Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/23/a5bbd9600dd607411fa644c06ff4951bec3a4d82c4b852374024359c19c0/uvicorn-0.44.0-py3-none-any.whl", hash = "sha256:ce937c99a2cc70279556967274414c087888e8cec9f9c94644dfca11bd3ced89", size = 69425, upload-time = "2026-04-06T09:23:21.524Z" },
 ]
 
 [package.optional-dependencies]
@@ -8900,18 +8987,48 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/68/5a/199c59e0a824a3db2b89c5d2dade7ab5f9624dbf6448dc291b46d5ec94d3/wcwidth-0.6.0-py3-none-any.whl", hash = "sha256:1a3a1e510b553315f8e146c54764f4fb6264ffad731b3d78088cdb1478ffbdad", size = 94189, upload-time = "2026-02-06T19:19:39.646Z" },
 ]
 
+[[package]]
+name = "weaviate-client"
+version = "4.16.2"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.13' and platform_machine != 's390x'",
+    "python_full_version < '3.11' and platform_machine != 's390x'",
+    "python_full_version < '3.11' and platform_machine == 's390x'",
+]
+dependencies = [
+    { name = "authlib", marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
+    { name = "deprecation", marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
+    { name = "grpcio", version = "1.80.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
+    { name = "grpcio-health-checking", marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
+    { name = "httpx", marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
+    { name = "pydantic", marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
+    { name = "validators", marker = "python_full_version < '3.11' or (python_full_version >= '3.13' and platform_machine != 's390x')" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a7/b9/7b9e05cf923743aa1479afcd85c48ebca82d031c3c3a5d02b1b3fcb52eb9/weaviate_client-4.16.2.tar.gz", hash = "sha256:eb7107a3221a5ad68d604cafc65195bd925a9709512ea0b6fe0dd212b0678fab", size = 681321, upload-time = "2025-07-22T09:10:48.79Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d7/c8/8a8c7ddbdd2c7fc73782056310666736a36a7d860f9935ce1d21f5f6c02e/weaviate_client-4.16.2-py3-none-any.whl", hash = "sha256:c236adca30d18667943544ad89fcd9157947af95dfc6de4a8ecf9e7619f1c979", size = 451475, upload-time = "2025-07-22T09:10:46.941Z" },
+]
+
 [[package]]
 name = "weaviate-client"
 version = "4.18.3"
 source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.13' and platform_machine == 's390x'",
+    "python_full_version == '3.12.*' and platform_machine != 's390x'",
+    "python_full_version == '3.12.*' and platform_machine == 's390x'",
+    "python_full_version == '3.11.*' and platform_machine != 's390x'",
+    "python_full_version == '3.11.*' and platform_machine == 's390x'",
+]
 dependencies = [
-    { name = "authlib" },
-    { name = "deprecation" },
-    { name = "grpcio" },
-    { name = "httpx" },
-    { name = "protobuf" },
-    { name = "pydantic" },
-    { name = "validators" },
+    { name = "authlib", marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
+    { name = "deprecation", marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
+    { name = "grpcio", version = "1.78.0", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
+    { name = "httpx", marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
+    { name = "protobuf", marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
+    { name = "pydantic", marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
+    { name = "validators", marker = "(python_full_version >= '3.11' and python_full_version < '3.13') or (python_full_version >= '3.11' and platform_machine == 's390x')" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/a8/76/14e07761c5fb7e8573e3cff562e2d9073c65f266db0e67511403d10435b1/weaviate_client-4.18.3.tar.gz", hash = "sha256:9d889246d62be36641a7f2b8cedf5fb665b804d46f7a53ae37e02d297a11f119", size = 783634, upload-time = "2025-12-03T09:38:28.261Z" }
 wheels = [

From 68c754883d12f36335c73b5a3a8287a71b01da4c Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Fri, 10 Apr 2026 00:03:28 +0800
Subject: [PATCH 20/70] feat: add checkpoint forking with lineage tracking

---
 lib/crewai/src/crewai/crew.py                 |  28 ++
 lib/crewai/src/crewai/flow/flow.py            |  28 ++
 .../src/crewai/state/checkpoint_listener.py   |  10 +-
 lib/crewai/src/crewai/state/provider/core.py  |  39 ++-
 .../crewai/state/provider/json_provider.py    |  86 ++++-
 .../crewai/state/provider/sqlite_provider.py  |  47 ++-
 lib/crewai/src/crewai/state/runtime.py        |  66 +++-
 lib/crewai/tests/test_checkpoint.py           | 300 +++++++++++++++++-
 8 files changed, 560 insertions(+), 44 deletions(-)

diff --git a/lib/crewai/src/crewai/crew.py b/lib/crewai/src/crewai/crew.py
index 4090e706b..d279a265d 100644
--- a/lib/crewai/src/crewai/crew.py
+++ b/lib/crewai/src/crewai/crew.py
@@ -400,6 +400,34 @@ class Crew(FlowTrackable, BaseModel):
                 return entity
         raise ValueError(f"No Crew found in checkpoint: {path}")
 
+    @classmethod
+    def fork(
+        cls,
+        path: str,
+        *,
+        branch: str | None = None,
+        provider: BaseProvider | None = None,
+    ) -> Crew:
+        """Fork a Crew from a checkpoint, creating a new execution branch.
+
+        Args:
+            path: Path to a checkpoint file.
+            branch: Branch label for the fork. Auto-generated if not provided.
+            provider: Storage backend to read from. Defaults to auto-detect.
+
+        Returns:
+            A Crew instance on the new branch. Call kickoff() to run.
+        """
+        crew = cls.from_checkpoint(path, provider=provider)
+        state = crewai_event_bus._runtime_state
+        if state is None:
+            raise RuntimeError(
+                "Cannot fork: no runtime state on the event bus. "
+                "Ensure from_checkpoint() succeeded before calling fork()."
+            )
+        state.fork(branch)
+        return crew
+
     def _restore_runtime(self) -> None:
         """Re-create runtime objects after restoring from a checkpoint."""
         for agent in self.agents:
diff --git a/lib/crewai/src/crewai/flow/flow.py b/lib/crewai/src/crewai/flow/flow.py
index a057da581..a85885bd9 100644
--- a/lib/crewai/src/crewai/flow/flow.py
+++ b/lib/crewai/src/crewai/flow/flow.py
@@ -960,6 +960,34 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
             return instance
         raise ValueError(f"No Flow found in checkpoint: {path}")
 
+    @classmethod
+    def fork(
+        cls,
+        path: str,
+        *,
+        branch: str | None = None,
+        provider: BaseProvider | None = None,
+    ) -> Flow:  # type: ignore[type-arg]
+        """Fork a Flow from a checkpoint, creating a new execution branch.
+
+        Args:
+            path: Path to a checkpoint file.
+            branch: Branch label for the fork. Auto-generated if not provided.
+            provider: Storage backend to read from. Defaults to auto-detect.
+
+        Returns:
+            A Flow instance on the new branch. Call kickoff() to run.
+        """
+        flow = cls.from_checkpoint(path, provider=provider)
+        state = crewai_event_bus._runtime_state
+        if state is None:
+            raise RuntimeError(
+                "Cannot fork: no runtime state on the event bus. "
+                "Ensure from_checkpoint() succeeded before calling fork()."
+            )
+        state.fork(branch)
+        return flow
+
     checkpoint_completed_methods: set[str] | None = Field(default=None)
     checkpoint_method_outputs: list[Any] | None = Field(default=None)
     checkpoint_method_counts: dict[str, int] | None = Field(default=None)
diff --git a/lib/crewai/src/crewai/state/checkpoint_listener.py b/lib/crewai/src/crewai/state/checkpoint_listener.py
index 6471b9bde..c2ac728a8 100644
--- a/lib/crewai/src/crewai/state/checkpoint_listener.py
+++ b/lib/crewai/src/crewai/state/checkpoint_listener.py
@@ -106,10 +106,16 @@ def _do_checkpoint(state: RuntimeState, cfg: CheckpointConfig) -> None:
     """Write a checkpoint and prune old ones if configured."""
     _prepare_entities(state.root)
     data = state.model_dump_json()
-    cfg.provider.checkpoint(data, cfg.location)
+    location = cfg.provider.checkpoint(
+        data,
+        cfg.location,
+        parent_id=state._parent_id,
+        branch=state._branch,
+    )
+    state._chain_lineage(cfg.provider, location)
 
     if cfg.max_checkpoints is not None:
-        cfg.provider.prune(cfg.location, cfg.max_checkpoints)
+        cfg.provider.prune(cfg.location, cfg.max_checkpoints, branch=state._branch)
 
 
 def _should_checkpoint(source: Any, event: BaseEvent) -> CheckpointConfig | None:
diff --git a/lib/crewai/src/crewai/state/provider/core.py b/lib/crewai/src/crewai/state/provider/core.py
index 0b12364c0..c386d519f 100644
--- a/lib/crewai/src/crewai/state/provider/core.py
+++ b/lib/crewai/src/crewai/state/provider/core.py
@@ -17,12 +17,21 @@ class BaseProvider(BaseModel, ABC):
     provider_type: str = "base"
 
     @abstractmethod
-    def checkpoint(self, data: str, location: str) -> str:
+    def checkpoint(
+        self,
+        data: str,
+        location: str,
+        *,
+        parent_id: str | None = None,
+        branch: str = "main",
+    ) -> str:
         """Persist a snapshot synchronously.
 
         Args:
             data: The serialized string to persist.
             location: Storage destination (directory, file path, URI, etc.).
+            parent_id: ID of the parent checkpoint for lineage tracking.
+            branch: Branch label for this checkpoint.
 
         Returns:
             A location identifier for the saved checkpoint.
@@ -30,12 +39,21 @@ class BaseProvider(BaseModel, ABC):
         ...
 
     @abstractmethod
-    async def acheckpoint(self, data: str, location: str) -> str:
+    async def acheckpoint(
+        self,
+        data: str,
+        location: str,
+        *,
+        parent_id: str | None = None,
+        branch: str = "main",
+    ) -> str:
         """Persist a snapshot asynchronously.
 
         Args:
             data: The serialized string to persist.
             location: Storage destination (directory, file path, URI, etc.).
+            parent_id: ID of the parent checkpoint for lineage tracking.
+            branch: Branch label for this checkpoint.
 
         Returns:
             A location identifier for the saved checkpoint.
@@ -43,12 +61,25 @@ class BaseProvider(BaseModel, ABC):
         ...
 
     @abstractmethod
-    def prune(self, location: str, max_keep: int) -> None:
-        """Remove old checkpoints, keeping at most *max_keep*.
+    def prune(self, location: str, max_keep: int, *, branch: str = "main") -> None:
+        """Remove old checkpoints, keeping at most *max_keep* per branch.
 
         Args:
             location: The storage destination passed to ``checkpoint``.
             max_keep: Maximum number of checkpoints to retain.
+            branch: Only prune checkpoints on this branch.
+        """
+        ...
+
+    @abstractmethod
+    def extract_id(self, location: str) -> str:
+        """Extract the checkpoint ID from a location string.
+
+        Args:
+            location: The identifier returned by a previous ``checkpoint`` call.
+
+        Returns:
+            The checkpoint ID.
         """
         ...
 
diff --git a/lib/crewai/src/crewai/state/provider/json_provider.py b/lib/crewai/src/crewai/state/provider/json_provider.py
index f9763e6f3..0f18a5901 100644
--- a/lib/crewai/src/crewai/state/provider/json_provider.py
+++ b/lib/crewai/src/crewai/state/provider/json_provider.py
@@ -19,48 +19,87 @@ from crewai.state.provider.core import BaseProvider
 logger = logging.getLogger(__name__)
 
 
+def _safe_branch(base: str, branch: str) -> None:
+    """Validate that a branch name doesn't escape the base directory.
+
+    Raises:
+        ValueError: If the branch resolves outside the base directory.
+    """
+    base_resolved = str(Path(base).resolve())
+    target_resolved = str((Path(base) / branch).resolve())
+    if (
+        not target_resolved.startswith(base_resolved + os.sep)
+        and target_resolved != base_resolved
+    ):
+        raise ValueError(f"Branch name escapes checkpoint directory: {branch!r}")
+
+
 class JsonProvider(BaseProvider):
     """Persists runtime state checkpoints as JSON files on the local filesystem."""
 
     provider_type: Literal["json"] = "json"
 
-    def checkpoint(self, data: str, location: str) -> str:
+    def checkpoint(
+        self,
+        data: str,
+        location: str,
+        *,
+        parent_id: str | None = None,
+        branch: str = "main",
+    ) -> str:
         """Write a JSON checkpoint file.
 
         Args:
             data: The serialized JSON string to persist.
-            location: Directory where the checkpoint will be saved.
+            location: Base directory where checkpoints are saved.
+            parent_id: ID of the parent checkpoint for lineage tracking.
+                Encoded in the filename for queryable lineage without
+                parsing the blob.
+            branch: Branch label. Files are stored under ``location/branch/``.
 
         Returns:
             The path to the written checkpoint file.
         """
-        file_path = _build_path(location)
+        file_path = _build_path(location, branch, parent_id)
         file_path.parent.mkdir(parents=True, exist_ok=True)
 
         with open(file_path, "w") as f:
             f.write(data)
         return str(file_path)
 
-    async def acheckpoint(self, data: str, location: str) -> str:
+    async def acheckpoint(
+        self,
+        data: str,
+        location: str,
+        *,
+        parent_id: str | None = None,
+        branch: str = "main",
+    ) -> str:
         """Write a JSON checkpoint file asynchronously.
 
         Args:
             data: The serialized JSON string to persist.
-            location: Directory where the checkpoint will be saved.
+            location: Base directory where checkpoints are saved.
+            parent_id: ID of the parent checkpoint for lineage tracking.
+                Encoded in the filename for queryable lineage without
+                parsing the blob.
+            branch: Branch label. Files are stored under ``location/branch/``.
 
         Returns:
             The path to the written checkpoint file.
         """
-        file_path = _build_path(location)
+        file_path = _build_path(location, branch, parent_id)
         await aiofiles.os.makedirs(str(file_path.parent), exist_ok=True)
 
         async with aiofiles.open(file_path, "w") as f:
             await f.write(data)
         return str(file_path)
 
-    def prune(self, location: str, max_keep: int) -> None:
-        """Remove oldest checkpoint files beyond *max_keep*."""
-        pattern = os.path.join(location, "*.json")
+    def prune(self, location: str, max_keep: int, *, branch: str = "main") -> None:
+        """Remove oldest checkpoint files beyond *max_keep* on a branch."""
+        _safe_branch(location, branch)
+        branch_dir = os.path.join(location, branch)
+        pattern = os.path.join(branch_dir, "*.json")
         files = sorted(glob.glob(pattern), key=os.path.getmtime)
         for path in files if max_keep == 0 else files[:-max_keep]:
             try:
@@ -68,6 +107,16 @@ class JsonProvider(BaseProvider):
             except OSError:  # noqa: PERF203
                 logger.debug("Failed to remove %s", path, exc_info=True)
 
+    def extract_id(self, location: str) -> str:
+        """Extract the checkpoint ID from a file path.
+
+        The filename format is ``{ts}_{uuid8}_p-{parent}.json``.
+        The checkpoint ID is the ``{ts}_{uuid8}`` prefix.
+        """
+        stem = Path(location).stem
+        idx = stem.find("_p-")
+        return stem[:idx] if idx != -1 else stem
+
     def from_checkpoint(self, location: str) -> str:
         """Read a JSON checkpoint file.
 
@@ -92,15 +141,24 @@ class JsonProvider(BaseProvider):
             return await f.read()
 
 
-def _build_path(directory: str) -> Path:
-    """Build a timestamped checkpoint file path.
+def _build_path(
+    directory: str, branch: str = "main", parent_id: str | None = None
+) -> Path:
+    """Build a timestamped checkpoint file path under a branch subdirectory.
+
+    Filename format: ``{ts}_{uuid8}_p-{parent_id}.json``
 
     Args:
-        directory: Parent directory for the checkpoint file.
+        directory: Base directory for checkpoints.
+        branch: Branch label used as a subdirectory name.
+        parent_id: Parent checkpoint ID to encode in the filename.
 
     Returns:
         The target file path.
     """
+    _safe_branch(directory, branch)
     ts = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%S")
-    filename = f"{ts}_{uuid.uuid4().hex[:8]}.json"
-    return Path(directory) / filename
+    short_uuid = uuid.uuid4().hex[:8]
+    parent_suffix = parent_id or "none"
+    filename = f"{ts}_{short_uuid}_p-{parent_suffix}.json"
+    return Path(directory) / branch / filename
diff --git a/lib/crewai/src/crewai/state/provider/sqlite_provider.py b/lib/crewai/src/crewai/state/provider/sqlite_provider.py
index e54f56180..5ee4dca26 100644
--- a/lib/crewai/src/crewai/state/provider/sqlite_provider.py
+++ b/lib/crewai/src/crewai/state/provider/sqlite_provider.py
@@ -17,15 +17,20 @@ _CREATE_TABLE = """
 CREATE TABLE IF NOT EXISTS checkpoints (
     id TEXT PRIMARY KEY,
     created_at TEXT NOT NULL,
+    parent_id TEXT,
+    branch TEXT NOT NULL DEFAULT 'main',
     data JSONB NOT NULL
 )
 """
 
-_INSERT = "INSERT INTO checkpoints (id, created_at, data) VALUES (?, ?, jsonb(?))"
+_INSERT = (
+    "INSERT INTO checkpoints (id, created_at, parent_id, branch, data) "
+    "VALUES (?, ?, ?, ?, jsonb(?))"
+)
 _SELECT = "SELECT json(data) FROM checkpoints WHERE id = ?"
 _PRUNE = """
-DELETE FROM checkpoints WHERE rowid NOT IN (
-    SELECT rowid FROM checkpoints ORDER BY rowid DESC LIMIT ?
+DELETE FROM checkpoints WHERE branch = ? AND rowid NOT IN (
+    SELECT rowid FROM checkpoints WHERE branch = ? ORDER BY rowid DESC LIMIT ?
 )
 """
 
@@ -50,12 +55,21 @@ class SqliteProvider(BaseProvider):
 
     provider_type: Literal["sqlite"] = "sqlite"
 
-    def checkpoint(self, data: str, location: str) -> str:
+    def checkpoint(
+        self,
+        data: str,
+        location: str,
+        *,
+        parent_id: str | None = None,
+        branch: str = "main",
+    ) -> str:
         """Write a checkpoint to the SQLite database.
 
         Args:
             data: The serialized JSON string to persist.
             location: Path to the SQLite database file.
+            parent_id: ID of the parent checkpoint for lineage tracking.
+            branch: Branch label for this checkpoint.
 
         Returns:
             A location string in the format ``"db_path#checkpoint_id"``.
@@ -65,16 +79,25 @@ class SqliteProvider(BaseProvider):
         with sqlite3.connect(location) as conn:
             conn.execute("PRAGMA journal_mode=WAL")
             conn.execute(_CREATE_TABLE)
-            conn.execute(_INSERT, (checkpoint_id, ts, data))
+            conn.execute(_INSERT, (checkpoint_id, ts, parent_id, branch, data))
             conn.commit()
         return f"{location}#{checkpoint_id}"
 
-    async def acheckpoint(self, data: str, location: str) -> str:
+    async def acheckpoint(
+        self,
+        data: str,
+        location: str,
+        *,
+        parent_id: str | None = None,
+        branch: str = "main",
+    ) -> str:
         """Write a checkpoint to the SQLite database asynchronously.
 
         Args:
             data: The serialized JSON string to persist.
             location: Path to the SQLite database file.
+            parent_id: ID of the parent checkpoint for lineage tracking.
+            branch: Branch label for this checkpoint.
 
         Returns:
             A location string in the format ``"db_path#checkpoint_id"``.
@@ -84,16 +107,20 @@ class SqliteProvider(BaseProvider):
         async with aiosqlite.connect(location) as db:
             await db.execute("PRAGMA journal_mode=WAL")
             await db.execute(_CREATE_TABLE)
-            await db.execute(_INSERT, (checkpoint_id, ts, data))
+            await db.execute(_INSERT, (checkpoint_id, ts, parent_id, branch, data))
             await db.commit()
         return f"{location}#{checkpoint_id}"
 
-    def prune(self, location: str, max_keep: int) -> None:
-        """Remove oldest checkpoint rows beyond *max_keep*."""
+    def prune(self, location: str, max_keep: int, *, branch: str = "main") -> None:
+        """Remove oldest checkpoint rows beyond *max_keep* on a branch."""
         with sqlite3.connect(location) as conn:
-            conn.execute(_PRUNE, (max_keep,))
+            conn.execute(_PRUNE, (branch, branch, max_keep))
             conn.commit()
 
+    def extract_id(self, location: str) -> str:
+        """Extract the checkpoint ID from a ``db_path#id`` string."""
+        return location.rsplit("#", 1)[1]
+
     def from_checkpoint(self, location: str) -> str:
         """Read a checkpoint from the SQLite database.
 
diff --git a/lib/crewai/src/crewai/state/runtime.py b/lib/crewai/src/crewai/state/runtime.py
index 6f1c5de80..b4293ad39 100644
--- a/lib/crewai/src/crewai/state/runtime.py
+++ b/lib/crewai/src/crewai/state/runtime.py
@@ -10,6 +10,7 @@ via ``RuntimeState.model_rebuild()``.
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any
+import uuid
 
 from pydantic import (
     ModelWrapValidatorHandler,
@@ -64,6 +65,9 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
     root: list[Entity]
     _provider: BaseProvider = PrivateAttr(default_factory=JsonProvider)
     _event_record: EventRecord = PrivateAttr(default_factory=EventRecord)
+    _checkpoint_id: str | None = PrivateAttr(default=None)
+    _parent_id: str | None = PrivateAttr(default=None)
+    _branch: str = PrivateAttr(default="main")
 
     @property
     def event_record(self) -> EventRecord:
@@ -73,6 +77,8 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
     @model_serializer(mode="plain")
     def _serialize(self) -> dict[str, Any]:
         return {
+            "parent_id": self._parent_id,
+            "branch": self._branch,
             "entities": [e.model_dump(mode="json") for e in self.root],
             "event_record": self._event_record.model_dump(),
         }
@@ -87,9 +93,24 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
             state = handler(data["entities"])
             if record_data:
                 state._event_record = EventRecord.model_validate(record_data)
+            state._parent_id = data.get("parent_id")
+            state._branch = data.get("branch", "main")
             return state
         return handler(data)
 
+    def _chain_lineage(self, provider: BaseProvider, location: str) -> None:
+        """Update lineage fields after a successful checkpoint write.
+
+        Sets ``_checkpoint_id`` and ``_parent_id`` so the next write
+        records the correct parent in the lineage chain.
+
+        Args:
+            provider: The provider that performed the write.
+            location: The location string returned by the provider.
+        """
+        self._checkpoint_id = provider.extract_id(location)
+        self._parent_id = self._checkpoint_id
+
     def checkpoint(self, location: str) -> str:
         """Write a checkpoint.
 
@@ -101,7 +122,14 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
             A location identifier for the saved checkpoint.
         """
         _prepare_entities(self.root)
-        return self._provider.checkpoint(self.model_dump_json(), location)
+        result = self._provider.checkpoint(
+            self.model_dump_json(),
+            location,
+            parent_id=self._parent_id,
+            branch=self._branch,
+        )
+        self._chain_lineage(self._provider, result)
+        return result
 
     async def acheckpoint(self, location: str) -> str:
         """Async version of :meth:`checkpoint`.
@@ -114,7 +142,29 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
             A location identifier for the saved checkpoint.
         """
         _prepare_entities(self.root)
-        return await self._provider.acheckpoint(self.model_dump_json(), location)
+        result = await self._provider.acheckpoint(
+            self.model_dump_json(),
+            location,
+            parent_id=self._parent_id,
+            branch=self._branch,
+        )
+        self._chain_lineage(self._provider, result)
+        return result
+
+    def fork(self, branch: str | None = None) -> None:
+        """Mark this state as a fork for subsequent checkpoints.
+
+        Args:
+            branch: Branch label. Auto-generated from the current checkpoint
+                ID if not provided. Always unique — safe to call multiple
+                times without collisions.
+        """
+        if branch:
+            self._branch = branch
+        elif self._checkpoint_id:
+            self._branch = f"fork/{self._checkpoint_id}"
+        else:
+            self._branch = f"fork/{uuid.uuid4().hex[:8]}"
 
     @classmethod
     def from_checkpoint(
@@ -131,7 +181,11 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
             A restored RuntimeState.
         """
         raw = provider.from_checkpoint(location)
-        return cls.model_validate_json(raw, **kwargs)
+        state = cls.model_validate_json(raw, **kwargs)
+        checkpoint_id = provider.extract_id(location)
+        state._checkpoint_id = checkpoint_id
+        state._parent_id = checkpoint_id
+        return state
 
     @classmethod
     async def afrom_checkpoint(
@@ -148,7 +202,11 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
             A restored RuntimeState.
         """
         raw = await provider.afrom_checkpoint(location)
-        return cls.model_validate_json(raw, **kwargs)
+        state = cls.model_validate_json(raw, **kwargs)
+        checkpoint_id = provider.extract_id(location)
+        state._checkpoint_id = checkpoint_id
+        state._parent_id = checkpoint_id
+        return state
 
 
 def _prepare_entities(root: list[Entity]) -> None:
diff --git a/lib/crewai/tests/test_checkpoint.py b/lib/crewai/tests/test_checkpoint.py
index 29dc289b4..cbea4b562 100644
--- a/lib/crewai/tests/test_checkpoint.py
+++ b/lib/crewai/tests/test_checkpoint.py
@@ -1,8 +1,10 @@
-"""Tests for CheckpointConfig, checkpoint listener, and pruning."""
+"""Tests for CheckpointConfig, checkpoint listener, pruning, and forking."""
 
 from __future__ import annotations
 
+import json
 import os
+import sqlite3
 import tempfile
 import time
 from typing import Any
@@ -21,6 +23,8 @@ from crewai.state.checkpoint_listener import (
     _SENTINEL,
 )
 from crewai.state.provider.json_provider import JsonProvider
+from crewai.state.provider.sqlite_provider import SqliteProvider
+from crewai.state.runtime import RuntimeState
 from crewai.task import Task
 
 
@@ -116,35 +120,41 @@ class TestFindCheckpoint:
 class TestPrune:
     def test_prune_keeps_newest(self) -> None:
         with tempfile.TemporaryDirectory() as d:
+            branch_dir = os.path.join(d, "main")
+            os.makedirs(branch_dir)
             for i in range(5):
-                path = os.path.join(d, f"cp_{i}.json")
+                path = os.path.join(branch_dir, f"cp_{i}.json")
                 with open(path, "w") as f:
                     f.write("{}")
                 # Ensure distinct mtime
                 time.sleep(0.01)
 
-            JsonProvider().prune(d, max_keep=2)
-            remaining = os.listdir(d)
+            JsonProvider().prune(d, max_keep=2, branch="main")
+            remaining = os.listdir(branch_dir)
             assert len(remaining) == 2
             assert "cp_3.json" in remaining
             assert "cp_4.json" in remaining
 
     def test_prune_zero_removes_all(self) -> None:
         with tempfile.TemporaryDirectory() as d:
+            branch_dir = os.path.join(d, "main")
+            os.makedirs(branch_dir)
             for i in range(3):
-                with open(os.path.join(d, f"cp_{i}.json"), "w") as f:
+                with open(os.path.join(branch_dir, f"cp_{i}.json"), "w") as f:
                     f.write("{}")
 
-            JsonProvider().prune(d, max_keep=0)
-            assert os.listdir(d) == []
+            JsonProvider().prune(d, max_keep=0, branch="main")
+            assert os.listdir(branch_dir) == []
 
     def test_prune_more_than_existing(self) -> None:
         with tempfile.TemporaryDirectory() as d:
-            with open(os.path.join(d, "cp.json"), "w") as f:
+            branch_dir = os.path.join(d, "main")
+            os.makedirs(branch_dir)
+            with open(os.path.join(branch_dir, "cp.json"), "w") as f:
                 f.write("{}")
 
-            JsonProvider().prune(d, max_keep=10)
-            assert len(os.listdir(d)) == 1
+            JsonProvider().prune(d, max_keep=10, branch="main")
+            assert len(os.listdir(branch_dir)) == 1
 
 
 # ---------- CheckpointConfig ----------
@@ -167,3 +177,273 @@ class TestCheckpointConfig:
             on_events=["task_completed", "crew_kickoff_completed"]
         )
         assert cfg.trigger_events == {"task_completed", "crew_kickoff_completed"}
+
+
+# ---------- RuntimeState lineage ----------
+
+
+class TestRuntimeStateLineage:
+    def _make_state(self) -> RuntimeState:
+        from crewai import Agent, Crew
+
+        agent = Agent(role="r", goal="g", backstory="b", llm="gpt-4o-mini")
+        crew = Crew(agents=[agent], tasks=[], verbose=False)
+        return RuntimeState(root=[crew])
+
+    def test_default_lineage_fields(self) -> None:
+        state = self._make_state()
+        assert state._checkpoint_id is None
+        assert state._parent_id is None
+        assert state._branch == "main"
+
+    def test_serialize_includes_lineage(self) -> None:
+        state = self._make_state()
+        state._parent_id = "parent456"
+        state._branch = "experiment"
+        dumped = json.loads(state.model_dump_json())
+        assert dumped["parent_id"] == "parent456"
+        assert dumped["branch"] == "experiment"
+        assert "checkpoint_id" not in dumped
+
+    def test_deserialize_restores_lineage(self) -> None:
+        state = self._make_state()
+        state._parent_id = "parent456"
+        state._branch = "experiment"
+        raw = state.model_dump_json()
+        restored = RuntimeState.model_validate_json(
+            raw, context={"from_checkpoint": True}
+        )
+        assert restored._parent_id == "parent456"
+        assert restored._branch == "experiment"
+
+    def test_deserialize_defaults_missing_lineage(self) -> None:
+        state = self._make_state()
+        raw = state.model_dump_json()
+        data = json.loads(raw)
+        data.pop("parent_id", None)
+        data.pop("branch", None)
+        restored = RuntimeState.model_validate_json(
+            json.dumps(data), context={"from_checkpoint": True}
+        )
+        assert restored._parent_id is None
+        assert restored._branch == "main"
+
+    def test_from_checkpoint_sets_checkpoint_id(self) -> None:
+        """from_checkpoint sets _checkpoint_id from the location, not the blob."""
+        state = self._make_state()
+        state._provider = JsonProvider()
+        with tempfile.TemporaryDirectory() as d:
+            loc = state.checkpoint(d)
+            written_id = state._checkpoint_id
+
+            provider = JsonProvider()
+            restored = RuntimeState.from_checkpoint(
+                loc, provider, context={"from_checkpoint": True}
+            )
+            assert restored._checkpoint_id == written_id
+            assert restored._parent_id == written_id
+
+    def test_fork_sets_branch(self) -> None:
+        state = self._make_state()
+        state._checkpoint_id = "abc12345"
+        state._parent_id = "abc12345"
+        state.fork("my-experiment")
+        assert state._branch == "my-experiment"
+        assert state._parent_id == "abc12345"
+
+    def test_fork_auto_branch(self) -> None:
+        state = self._make_state()
+        state._checkpoint_id = "20260409T120000_abc12345"
+        state.fork()
+        assert state._branch == "fork/20260409T120000_abc12345"
+
+    def test_fork_no_checkpoint_id_unique(self) -> None:
+        state = self._make_state()
+        state.fork()
+        assert state._branch.startswith("fork/")
+        assert len(state._branch) == len("fork/") + 8
+        # Two forks without checkpoint_id produce different branches
+        first = state._branch
+        state.fork()
+        assert state._branch != first
+
+
+# ---------- JsonProvider forking ----------
+
+
+class TestJsonProviderFork:
+    def test_checkpoint_writes_to_branch_subdir(self) -> None:
+        provider = JsonProvider()
+        with tempfile.TemporaryDirectory() as d:
+            path = provider.checkpoint("{}", d, branch="main")
+            assert "/main/" in path
+            assert path.endswith(".json")
+            assert os.path.isfile(path)
+
+    def test_checkpoint_fork_branch_subdir(self) -> None:
+        provider = JsonProvider()
+        with tempfile.TemporaryDirectory() as d:
+            path = provider.checkpoint("{}", d, branch="fork/exp1")
+            assert "/fork/exp1/" in path
+            assert os.path.isfile(path)
+
+    def test_prune_branch_aware(self) -> None:
+        provider = JsonProvider()
+        with tempfile.TemporaryDirectory() as d:
+            # Write 3 checkpoints on main, 2 on fork
+            for _ in range(3):
+                provider.checkpoint("{}", d, branch="main")
+                time.sleep(0.01)
+            for _ in range(2):
+                provider.checkpoint("{}", d, branch="fork/a")
+                time.sleep(0.01)
+
+            # Prune main to 1
+            provider.prune(d, max_keep=1, branch="main")
+
+            main_dir = os.path.join(d, "main")
+            fork_dir = os.path.join(d, "fork", "a")
+            assert len(os.listdir(main_dir)) == 1
+            assert len(os.listdir(fork_dir)) == 2  # untouched
+
+    def test_extract_id(self) -> None:
+        provider = JsonProvider()
+        assert provider.extract_id("/dir/main/20260409T120000_abc12345_p-none.json") == "20260409T120000_abc12345"
+        assert provider.extract_id("/dir/main/20260409T120000_abc12345_p-20260409T115900_def67890.json") == "20260409T120000_abc12345"
+
+    def test_branch_traversal_rejected(self) -> None:
+        provider = JsonProvider()
+        with tempfile.TemporaryDirectory() as d:
+            with pytest.raises(ValueError, match="escapes checkpoint directory"):
+                provider.checkpoint("{}", d, branch="../../etc")
+            with pytest.raises(ValueError, match="escapes checkpoint directory"):
+                provider.prune(d, max_keep=1, branch="../../etc")
+
+    def test_filename_encodes_parent_id(self) -> None:
+        provider = JsonProvider()
+        with tempfile.TemporaryDirectory() as d:
+            # First checkpoint — no parent
+            path1 = provider.checkpoint("{}", d, branch="main")
+            assert "_p-none.json" in path1
+
+            # Second checkpoint — with parent
+            id1 = provider.extract_id(path1)
+            path2 = provider.checkpoint("{}", d, parent_id=id1, branch="main")
+            assert f"_p-{id1}.json" in path2
+
+    def test_checkpoint_chaining(self) -> None:
+        """RuntimeState.checkpoint() chains parent_id after each write."""
+        state = self._make_state()
+        state._provider = JsonProvider()
+        with tempfile.TemporaryDirectory() as d:
+            state.checkpoint(d)
+            id1 = state._checkpoint_id
+            assert id1 is not None
+            assert state._parent_id == id1
+
+            loc2 = state.checkpoint(d)
+            id2 = state._checkpoint_id
+            assert id2 is not None
+            assert id2 != id1
+            assert state._parent_id == id2
+
+            # Verify the second checkpoint blob has parent_id == id1
+            with open(loc2) as f:
+                data2 = json.loads(f.read())
+            assert data2["parent_id"] == id1
+
+    @pytest.mark.asyncio
+    async def test_acheckpoint_chaining(self) -> None:
+        """Async checkpoint path chains lineage identically to sync."""
+        state = self._make_state()
+        state._provider = JsonProvider()
+        with tempfile.TemporaryDirectory() as d:
+            await state.acheckpoint(d)
+            id1 = state._checkpoint_id
+            assert id1 is not None
+
+            loc2 = await state.acheckpoint(d)
+            id2 = state._checkpoint_id
+            assert id2 != id1
+            assert state._parent_id == id2
+
+            with open(loc2) as f:
+                data2 = json.loads(f.read())
+            assert data2["parent_id"] == id1
+
+    def _make_state(self) -> RuntimeState:
+        from crewai import Agent, Crew
+
+        agent = Agent(role="r", goal="g", backstory="b", llm="gpt-4o-mini")
+        crew = Crew(agents=[agent], tasks=[], verbose=False)
+        return RuntimeState(root=[crew])
+
+
+# ---------- SqliteProvider forking ----------
+
+
+class TestSqliteProviderFork:
+    def test_checkpoint_stores_branch_and_parent(self) -> None:
+        provider = SqliteProvider()
+        with tempfile.TemporaryDirectory() as d:
+            db = os.path.join(d, "cp.db")
+            loc = provider.checkpoint("{}", db, parent_id="p1", branch="exp")
+            cid = provider.extract_id(loc)
+
+            with sqlite3.connect(db) as conn:
+                row = conn.execute(
+                    "SELECT parent_id, branch FROM checkpoints WHERE id = ?",
+                    (cid,),
+                ).fetchone()
+            assert row == ("p1", "exp")
+
+    def test_prune_branch_aware(self) -> None:
+        provider = SqliteProvider()
+        with tempfile.TemporaryDirectory() as d:
+            db = os.path.join(d, "cp.db")
+            for _ in range(3):
+                provider.checkpoint("{}", db, branch="main")
+            for _ in range(2):
+                provider.checkpoint("{}", db, branch="fork/a")
+
+            provider.prune(db, max_keep=1, branch="main")
+
+            with sqlite3.connect(db) as conn:
+                main_count = conn.execute(
+                    "SELECT COUNT(*) FROM checkpoints WHERE branch = 'main'"
+                ).fetchone()[0]
+                fork_count = conn.execute(
+                    "SELECT COUNT(*) FROM checkpoints WHERE branch = 'fork/a'"
+                ).fetchone()[0]
+            assert main_count == 1
+            assert fork_count == 2
+
+    def test_extract_id(self) -> None:
+        provider = SqliteProvider()
+        assert provider.extract_id("/path/to/db#abc123") == "abc123"
+
+    def test_checkpoint_chaining_sqlite(self) -> None:
+        state = self._make_state()
+        state._provider = SqliteProvider()
+        with tempfile.TemporaryDirectory() as d:
+            db = os.path.join(d, "cp.db")
+            state.checkpoint(db)
+            id1 = state._checkpoint_id
+
+            state.checkpoint(db)
+            id2 = state._checkpoint_id
+            assert id2 != id1
+
+            # Second row should have parent_id == id1
+            with sqlite3.connect(db) as conn:
+                row = conn.execute(
+                    "SELECT parent_id FROM checkpoints WHERE id = ?", (id2,)
+                ).fetchone()
+            assert row[0] == id1
+
+    def _make_state(self) -> RuntimeState:
+        from crewai import Agent, Crew
+
+        agent = Agent(role="r", goal="g", backstory="b", llm="gpt-4o-mini")
+        crew = Crew(agents=[agent], tasks=[], verbose=False)
+        return RuntimeState(root=[crew])

From 56cf8a4384e4c25f9fee730ba5e47c9b83ecb8d5 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Fri, 10 Apr 2026 01:13:30 +0800
Subject: [PATCH 21/70] feat: embed crewai_version in checkpoints with
 migration framework

Write the crewAI package version into every checkpoint blob. On restore,
run version-based migrations so older checkpoints can be transformed
forward to the current format. Adds crewai.utilities.version module.
---
 lib/crewai/src/crewai/cli/crew_chat.py        |  2 +-
 lib/crewai/src/crewai/cli/enterprise/main.py  |  2 +-
 lib/crewai/src/crewai/cli/plus_api.py         |  2 +-
 lib/crewai/src/crewai/cli/run_crew.py         |  2 +-
 lib/crewai/src/crewai/cli/version.py          |  8 +---
 .../listeners/tracing/trace_batch_manager.py  |  2 +-
 .../listeners/tracing/trace_listener.py       |  2 +-
 lib/crewai/src/crewai/state/runtime.py        | 41 +++++++++++++++++++
 lib/crewai/src/crewai/utilities/version.py    | 12 ++++++
 lib/crewai/tests/test_checkpoint.py           | 33 +++++++++++++++
 10 files changed, 94 insertions(+), 12 deletions(-)
 create mode 100644 lib/crewai/src/crewai/utilities/version.py

diff --git a/lib/crewai/src/crewai/cli/crew_chat.py b/lib/crewai/src/crewai/cli/crew_chat.py
index ad1c65894..61d9b4d9e 100644
--- a/lib/crewai/src/crewai/cli/crew_chat.py
+++ b/lib/crewai/src/crewai/cli/crew_chat.py
@@ -13,7 +13,6 @@ from packaging import version
 import tomli
 
 from crewai.cli.utils import read_toml
-from crewai.cli.version import get_crewai_version
 from crewai.crew import Crew
 from crewai.llm import LLM
 from crewai.llms.base_llm import BaseLLM
@@ -21,6 +20,7 @@ from crewai.types.crew_chat import ChatInputField, ChatInputs
 from crewai.utilities.llm_utils import create_llm
 from crewai.utilities.printer import PRINTER
 from crewai.utilities.types import LLMMessage
+from crewai.utilities.version import get_crewai_version
 
 
 MIN_REQUIRED_VERSION: Final[Literal["0.98.0"]] = "0.98.0"
diff --git a/lib/crewai/src/crewai/cli/enterprise/main.py b/lib/crewai/src/crewai/cli/enterprise/main.py
index 395de418b..2977868f2 100644
--- a/lib/crewai/src/crewai/cli/enterprise/main.py
+++ b/lib/crewai/src/crewai/cli/enterprise/main.py
@@ -7,7 +7,7 @@ from rich.console import Console
 from crewai.cli.authentication.main import Oauth2Settings, ProviderFactory
 from crewai.cli.command import BaseCommand
 from crewai.cli.settings.main import SettingsCommand
-from crewai.cli.version import get_crewai_version
+from crewai.utilities.version import get_crewai_version
 
 
 console = Console()
diff --git a/lib/crewai/src/crewai/cli/plus_api.py b/lib/crewai/src/crewai/cli/plus_api.py
index ac7acfda9..862ab81e8 100644
--- a/lib/crewai/src/crewai/cli/plus_api.py
+++ b/lib/crewai/src/crewai/cli/plus_api.py
@@ -6,7 +6,7 @@ import httpx
 
 from crewai.cli.config import Settings
 from crewai.cli.constants import DEFAULT_CREWAI_ENTERPRISE_URL
-from crewai.cli.version import get_crewai_version
+from crewai.utilities.version import get_crewai_version
 
 
 class PlusAPI:
diff --git a/lib/crewai/src/crewai/cli/run_crew.py b/lib/crewai/src/crewai/cli/run_crew.py
index 6f031f245..ba2202032 100644
--- a/lib/crewai/src/crewai/cli/run_crew.py
+++ b/lib/crewai/src/crewai/cli/run_crew.py
@@ -5,7 +5,7 @@ import click
 from packaging import version
 
 from crewai.cli.utils import build_env_with_all_tool_credentials, read_toml
-from crewai.cli.version import get_crewai_version
+from crewai.utilities.version import get_crewai_version
 
 
 class CrewType(Enum):
diff --git a/lib/crewai/src/crewai/cli/version.py b/lib/crewai/src/crewai/cli/version.py
index 60eb3a95a..232aa2423 100644
--- a/lib/crewai/src/crewai/cli/version.py
+++ b/lib/crewai/src/crewai/cli/version.py
@@ -3,7 +3,6 @@
 from collections.abc import Mapping
 from datetime import datetime, timedelta
 from functools import lru_cache
-import importlib.metadata
 import json
 from pathlib import Path
 from typing import Any
@@ -13,6 +12,8 @@ from urllib.error import URLError
 import appdirs
 from packaging.version import InvalidVersion, Version, parse
 
+from crewai.utilities.version import get_crewai_version
+
 
 @lru_cache(maxsize=1)
 def _get_cache_file() -> Path:
@@ -25,11 +26,6 @@ def _get_cache_file() -> Path:
     return cache_dir / "version_cache.json"
 
 
-def get_crewai_version() -> str:
-    """Get the version number of CrewAI running the CLI."""
-    return importlib.metadata.version("crewai")
-
-
 def _is_cache_valid(cache_data: Mapping[str, Any]) -> bool:
     """Check if the cache is still valid, less than 24 hours old."""
     if "timestamp" not in cache_data:
diff --git a/lib/crewai/src/crewai/events/listeners/tracing/trace_batch_manager.py b/lib/crewai/src/crewai/events/listeners/tracing/trace_batch_manager.py
index 1a25b68a9..d2a0912f6 100644
--- a/lib/crewai/src/crewai/events/listeners/tracing/trace_batch_manager.py
+++ b/lib/crewai/src/crewai/events/listeners/tracing/trace_batch_manager.py
@@ -13,13 +13,13 @@ from crewai.cli.authentication.token import AuthError, get_auth_token
 from crewai.cli.config import Settings
 from crewai.cli.constants import DEFAULT_CREWAI_ENTERPRISE_URL
 from crewai.cli.plus_api import PlusAPI
-from crewai.cli.version import get_crewai_version
 from crewai.events.listeners.tracing.types import TraceEvent
 from crewai.events.listeners.tracing.utils import (
     get_user_id,
     is_tracing_enabled_in_context,
     should_auto_collect_first_time_traces,
 )
+from crewai.utilities.version import get_crewai_version
 
 
 logger = getLogger(__name__)
diff --git a/lib/crewai/src/crewai/events/listeners/tracing/trace_listener.py b/lib/crewai/src/crewai/events/listeners/tracing/trace_listener.py
index 0e3b284c0..c4cc6cb71 100644
--- a/lib/crewai/src/crewai/events/listeners/tracing/trace_listener.py
+++ b/lib/crewai/src/crewai/events/listeners/tracing/trace_listener.py
@@ -7,7 +7,6 @@ import uuid
 from typing_extensions import Self
 
 from crewai.cli.authentication.token import AuthError, get_auth_token
-from crewai.cli.version import get_crewai_version
 from crewai.events.base_event_listener import BaseEventListener
 from crewai.events.base_events import BaseEvent
 from crewai.events.event_bus import CrewAIEventsBus
@@ -127,6 +126,7 @@ from crewai.events.types.tool_usage_events import (
     ToolUsageStartedEvent,
 )
 from crewai.events.utils.console_formatter import ConsoleFormatter
+from crewai.utilities.version import get_crewai_version
 
 
 class TraceCollectionListener(BaseEventListener):
diff --git a/lib/crewai/src/crewai/state/runtime.py b/lib/crewai/src/crewai/state/runtime.py
index b4293ad39..79c836e1e 100644
--- a/lib/crewai/src/crewai/state/runtime.py
+++ b/lib/crewai/src/crewai/state/runtime.py
@@ -9,9 +9,11 @@ via ``RuntimeState.model_rebuild()``.
 
 from __future__ import annotations
 
+import logging
 from typing import TYPE_CHECKING, Any
 import uuid
 
+from packaging.version import Version
 from pydantic import (
     ModelWrapValidatorHandler,
     PrivateAttr,
@@ -24,6 +26,10 @@ from crewai.context import capture_execution_context
 from crewai.state.event_record import EventRecord
 from crewai.state.provider.core import BaseProvider
 from crewai.state.provider.json_provider import JsonProvider
+from crewai.utilities.version import get_crewai_version
+
+
+logger = logging.getLogger(__name__)
 
 
 if TYPE_CHECKING:
@@ -61,6 +67,39 @@ def _sync_checkpoint_fields(entity: object) -> None:
         entity.checkpoint_kickoff_event_id = entity._kickoff_event_id
 
 
+def _migrate(data: dict[str, Any]) -> dict[str, Any]:
+    """Apply version-based migrations to checkpoint data.
+
+    Each block handles checkpoints older than a specific version,
+    transforming them forward to the current format. Blocks run in
+    version order so migrations compose.
+
+    Args:
+        data: The raw deserialized checkpoint dict.
+
+    Returns:
+        The migrated checkpoint dict.
+    """
+    raw = data.get("crewai_version")
+    current = Version(get_crewai_version())
+    stored = Version(raw) if raw else Version("0.0.0")
+
+    if raw is None:
+        logger.warning("Checkpoint has no crewai_version — treating as 0.0.0")
+    elif stored != current:
+        logger.debug(
+            "Migrating checkpoint from crewAI %s to %s",
+            stored,
+            current,
+        )
+
+    # --- migrations in version order ---
+    # if stored < Version("X.Y.Z"):
+    #     data.setdefault("some_field", "default")
+
+    return data
+
+
 class RuntimeState(RootModel):  # type: ignore[type-arg]
     root: list[Entity]
     _provider: BaseProvider = PrivateAttr(default_factory=JsonProvider)
@@ -77,6 +116,7 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
     @model_serializer(mode="plain")
     def _serialize(self) -> dict[str, Any]:
         return {
+            "crewai_version": get_crewai_version(),
             "parent_id": self._parent_id,
             "branch": self._branch,
             "entities": [e.model_dump(mode="json") for e in self.root],
@@ -89,6 +129,7 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
         cls, data: Any, handler: ModelWrapValidatorHandler[RuntimeState]
     ) -> RuntimeState:
         if isinstance(data, dict) and "entities" in data:
+            data = _migrate(data)
             record_data = data.get("event_record")
             state = handler(data["entities"])
             if record_data:
diff --git a/lib/crewai/src/crewai/utilities/version.py b/lib/crewai/src/crewai/utilities/version.py
new file mode 100644
index 000000000..57a5c562d
--- /dev/null
+++ b/lib/crewai/src/crewai/utilities/version.py
@@ -0,0 +1,12 @@
+"""Version utilities for crewAI."""
+
+from __future__ import annotations
+
+from functools import cache
+import importlib.metadata
+
+
+@cache
+def get_crewai_version() -> str:
+    """Get the installed crewAI version string."""
+    return importlib.metadata.version("crewai")
diff --git a/lib/crewai/tests/test_checkpoint.py b/lib/crewai/tests/test_checkpoint.py
index cbea4b562..0a0c00027 100644
--- a/lib/crewai/tests/test_checkpoint.py
+++ b/lib/crewai/tests/test_checkpoint.py
@@ -196,6 +196,39 @@ class TestRuntimeStateLineage:
         assert state._parent_id is None
         assert state._branch == "main"
 
+    def test_serialize_includes_version(self) -> None:
+        from crewai.utilities.version import get_crewai_version
+
+        state = self._make_state()
+        dumped = json.loads(state.model_dump_json())
+        assert dumped["crewai_version"] == get_crewai_version()
+
+    def test_deserialize_migrates_on_version_mismatch(self, caplog: Any) -> None:
+        import logging
+
+        state = self._make_state()
+        raw = state.model_dump_json()
+        data = json.loads(raw)
+        data["crewai_version"] = "0.1.0"
+        with caplog.at_level(logging.DEBUG):
+            RuntimeState.model_validate_json(
+                json.dumps(data), context={"from_checkpoint": True}
+            )
+        assert "Migrating checkpoint from crewAI 0.1.0" in caplog.text
+
+    def test_deserialize_warns_on_missing_version(self, caplog: Any) -> None:
+        import logging
+
+        state = self._make_state()
+        raw = state.model_dump_json()
+        data = json.loads(raw)
+        data.pop("crewai_version", None)
+        with caplog.at_level(logging.WARNING):
+            RuntimeState.model_validate_json(
+                json.dumps(data), context={"from_checkpoint": True}
+            )
+        assert "treating as 0.0.0" in caplog.text
+
     def test_serialize_includes_lineage(self) -> None:
         state = self._make_state()
         state._parent_id = "parent456"

From 84b1b0a0b0e72886334caac56303fa4fb7ca967b Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Fri, 10 Apr 2026 03:47:23 +0800
Subject: [PATCH 22/70] feat: add from_checkpoint parameter to kickoff methods

Accept CheckpointConfig on Crew and Flow kickoff/kickoff_async/akickoff.
When restore_from is set, the entity resumes from that checkpoint.
When only config fields are set, checkpointing is enabled for the run.
Adds restore_from field (Path | str | None) to CheckpointConfig.
---
 .../crewai/agents/agent_builder/base_agent.py | 22 ++++---
 lib/crewai/src/crewai/cli/checkpoint_tui.py   |  3 +-
 lib/crewai/src/crewai/crew.py                 | 58 ++++++++++--------
 lib/crewai/src/crewai/flow/flow.py            | 56 ++++++++++-------
 .../src/crewai/state/checkpoint_config.py     | 29 +++++++++
 lib/crewai/src/crewai/state/runtime.py        | 25 +++++---
 lib/crewai/tests/test_checkpoint.py           | 60 ++++++++++++++++++-
 7 files changed, 185 insertions(+), 68 deletions(-)

diff --git a/lib/crewai/src/crewai/agents/agent_builder/base_agent.py b/lib/crewai/src/crewai/agents/agent_builder/base_agent.py
index c55f5e417..9d37373e8 100644
--- a/lib/crewai/src/crewai/agents/agent_builder/base_agent.py
+++ b/lib/crewai/src/crewai/agents/agent_builder/base_agent.py
@@ -51,7 +51,6 @@ from crewai.utilities.string_utils import interpolate_only
 if TYPE_CHECKING:
     from crewai.context import ExecutionContext
     from crewai.crew import Crew
-    from crewai.state.provider.core import BaseProvider
 
 
 def _validate_crew_ref(value: Any) -> Any:
@@ -338,19 +337,16 @@ class BaseAgent(BaseModel, ABC, metaclass=AgentMeta):
     execution_context: ExecutionContext | None = Field(default=None)
 
     @classmethod
-    def from_checkpoint(
-        cls, path: str, *, provider: BaseProvider | None = None
-    ) -> Self:
-        """Restore an Agent from a checkpoint file."""
+    def from_checkpoint(cls, config: CheckpointConfig) -> Self:
+        """Restore an Agent from a checkpoint.
+
+        Args:
+            config: Checkpoint configuration with ``restore_from`` set.
+        """
         from crewai.context import apply_execution_context
-        from crewai.state.provider.json_provider import JsonProvider
         from crewai.state.runtime import RuntimeState
 
-        state = RuntimeState.from_checkpoint(
-            path,
-            provider=provider or JsonProvider(),
-            context={"from_checkpoint": True},
-        )
+        state = RuntimeState.from_checkpoint(config, context={"from_checkpoint": True})
         for entity in state.root:
             if isinstance(entity, cls):
                 if entity.execution_context is not None:
@@ -359,7 +355,9 @@ class BaseAgent(BaseModel, ABC, metaclass=AgentMeta):
                     entity.agent_executor.agent = entity
                     entity.agent_executor._resuming = True
                 return entity
-        raise ValueError(f"No {cls.__name__} found in checkpoint: {path}")
+        raise ValueError(
+            f"No {cls.__name__} found in checkpoint: {config.restore_from}"
+        )
 
     @model_validator(mode="before")
     @classmethod
diff --git a/lib/crewai/src/crewai/cli/checkpoint_tui.py b/lib/crewai/src/crewai/cli/checkpoint_tui.py
index 5f81d5fad..c58ed2ea6 100644
--- a/lib/crewai/src/crewai/cli/checkpoint_tui.py
+++ b/lib/crewai/src/crewai/cli/checkpoint_tui.py
@@ -353,8 +353,9 @@ async def _run_checkpoint_tui_async(location: str) -> None:
     click.echo(f"\nResuming from: {selected}\n")
 
     from crewai.crew import Crew
+    from crewai.state.checkpoint_config import CheckpointConfig
 
-    crew = Crew.from_checkpoint(selected)
+    crew = Crew.from_checkpoint(CheckpointConfig(restore_from=selected))
     result = await crew.akickoff()
     click.echo(f"\nResult: {getattr(result, 'raw', result)}")
 
diff --git a/lib/crewai/src/crewai/crew.py b/lib/crewai/src/crewai/crew.py
index d279a265d..111babbf3 100644
--- a/lib/crewai/src/crewai/crew.py
+++ b/lib/crewai/src/crewai/crew.py
@@ -42,7 +42,6 @@ if TYPE_CHECKING:
     from opentelemetry.trace import Span
 
     from crewai.context import ExecutionContext
-    from crewai.state.provider.core import BaseProvider
 
 try:
     from crewai_files import get_supported_content_types
@@ -104,7 +103,11 @@ from crewai.rag.types import SearchResult
 from crewai.security.fingerprint import Fingerprint
 from crewai.security.security_config import SecurityConfig
 from crewai.skills.models import Skill
-from crewai.state.checkpoint_config import CheckpointConfig, _coerce_checkpoint
+from crewai.state.checkpoint_config import (
+    CheckpointConfig,
+    _coerce_checkpoint,
+    apply_checkpoint,
+)
 from crewai.task import Task
 from crewai.tasks.conditional_task import ConditionalTask
 from crewai.tasks.task_output import TaskOutput
@@ -365,32 +368,21 @@ class Crew(FlowTrackable, BaseModel):
     checkpoint_kickoff_event_id: str | None = Field(default=None)
 
     @classmethod
-    def from_checkpoint(
-        cls, path: str, *, provider: BaseProvider | None = None
-    ) -> Crew:
-        """Restore a Crew from a checkpoint file, ready to resume via kickoff().
+    def from_checkpoint(cls, config: CheckpointConfig) -> Crew:
+        """Restore a Crew from a checkpoint, ready to resume via kickoff().
 
         Args:
-            path: Path to a checkpoint JSON file.
-            provider: Storage backend to read from. Defaults to JsonProvider.
+            config: Checkpoint configuration with ``restore_from`` set to
+                the path of the checkpoint to load.
 
         Returns:
             A Crew instance. Call kickoff() to resume from the last completed task.
         """
         from crewai.context import apply_execution_context
         from crewai.events.event_bus import crewai_event_bus
-        from crewai.state.provider.json_provider import JsonProvider
-        from crewai.state.provider.utils import detect_provider
         from crewai.state.runtime import RuntimeState
 
-        if provider is None:
-            provider = detect_provider(path)
-
-        state = RuntimeState.from_checkpoint(
-            path,
-            provider=provider or JsonProvider(),
-            context={"from_checkpoint": True},
-        )
+        state = RuntimeState.from_checkpoint(config, context={"from_checkpoint": True})
         crewai_event_bus.set_runtime_state(state)
         for entity in state.root:
             if isinstance(entity, cls):
@@ -398,27 +390,24 @@ class Crew(FlowTrackable, BaseModel):
                     apply_execution_context(entity.execution_context)
                 entity._restore_runtime()
                 return entity
-        raise ValueError(f"No Crew found in checkpoint: {path}")
+        raise ValueError(f"No Crew found in checkpoint: {config.restore_from}")
 
     @classmethod
     def fork(
         cls,
-        path: str,
-        *,
+        config: CheckpointConfig,
         branch: str | None = None,
-        provider: BaseProvider | None = None,
     ) -> Crew:
         """Fork a Crew from a checkpoint, creating a new execution branch.
 
         Args:
-            path: Path to a checkpoint file.
+            config: Checkpoint configuration with ``restore_from`` set.
             branch: Branch label for the fork. Auto-generated if not provided.
-            provider: Storage backend to read from. Defaults to auto-detect.
 
         Returns:
             A Crew instance on the new branch. Call kickoff() to run.
         """
-        crew = cls.from_checkpoint(path, provider=provider)
+        crew = cls.from_checkpoint(config)
         state = crewai_event_bus._runtime_state
         if state is None:
             raise RuntimeError(
@@ -882,16 +871,23 @@ class Crew(FlowTrackable, BaseModel):
         self,
         inputs: dict[str, Any] | None = None,
         input_files: dict[str, FileInput] | None = None,
+        from_checkpoint: CheckpointConfig | None = None,
     ) -> CrewOutput | CrewStreamingOutput:
         """Execute the crew's workflow.
 
         Args:
             inputs: Optional input dictionary for task interpolation.
             input_files: Optional dict of named file inputs for the crew.
+            from_checkpoint: Optional checkpoint config. If ``restore_from``
+                is set, the crew resumes from that checkpoint. Remaining
+                config fields enable checkpointing for the run.
 
         Returns:
             CrewOutput or CrewStreamingOutput if streaming is enabled.
         """
+        restored = apply_checkpoint(self, from_checkpoint)
+        if restored is not None:
+            return restored.kickoff(inputs=inputs, input_files=input_files)  # type: ignore[no-any-return]
         get_env_context()
         if self.stream:
             enable_agent_streaming(self.agents)
@@ -1004,12 +1000,15 @@ class Crew(FlowTrackable, BaseModel):
         self,
         inputs: dict[str, Any] | None = None,
         input_files: dict[str, FileInput] | None = None,
+        from_checkpoint: CheckpointConfig | None = None,
     ) -> CrewOutput | CrewStreamingOutput:
         """Asynchronous kickoff method to start the crew execution.
 
         Args:
             inputs: Optional input dictionary for task interpolation.
             input_files: Optional dict of named file inputs for the crew.
+            from_checkpoint: Optional checkpoint config. If ``restore_from``
+                is set, the crew resumes from that checkpoint.
 
         Returns:
             CrewOutput or CrewStreamingOutput if streaming is enabled.
@@ -1018,6 +1017,9 @@ class Crew(FlowTrackable, BaseModel):
         to get stream chunks. After iteration completes, access the final result
         via .result.
         """
+        restored = apply_checkpoint(self, from_checkpoint)
+        if restored is not None:
+            return await restored.kickoff_async(inputs=inputs, input_files=input_files)  # type: ignore[no-any-return]
         inputs = inputs or {}
 
         if self.stream:
@@ -1078,6 +1080,7 @@ class Crew(FlowTrackable, BaseModel):
         self,
         inputs: dict[str, Any] | None = None,
         input_files: dict[str, FileInput] | None = None,
+        from_checkpoint: CheckpointConfig | None = None,
     ) -> CrewOutput | CrewStreamingOutput:
         """Native async kickoff method using async task execution throughout.
 
@@ -1088,10 +1091,15 @@ class Crew(FlowTrackable, BaseModel):
         Args:
             inputs: Optional input dictionary for task interpolation.
             input_files: Optional dict of named file inputs for the crew.
+            from_checkpoint: Optional checkpoint config. If ``restore_from``
+                is set, the crew resumes from that checkpoint.
 
         Returns:
             CrewOutput or CrewStreamingOutput if streaming is enabled.
         """
+        restored = apply_checkpoint(self, from_checkpoint)
+        if restored is not None:
+            return await restored.akickoff(inputs=inputs, input_files=input_files)  # type: ignore[no-any-return]
         if self.stream:
             enable_agent_streaming(self.agents)
             ctx = StreamingContext(use_async=True)
diff --git a/lib/crewai/src/crewai/flow/flow.py b/lib/crewai/src/crewai/flow/flow.py
index a85885bd9..057f60ffb 100644
--- a/lib/crewai/src/crewai/flow/flow.py
+++ b/lib/crewai/src/crewai/flow/flow.py
@@ -113,7 +113,11 @@ from crewai.flow.utils import (
 )
 from crewai.memory.memory_scope import MemoryScope, MemorySlice
 from crewai.memory.unified_memory import Memory
-from crewai.state.checkpoint_config import CheckpointConfig, _coerce_checkpoint
+from crewai.state.checkpoint_config import (
+    CheckpointConfig,
+    _coerce_checkpoint,
+    apply_checkpoint,
+)
 
 
 if TYPE_CHECKING:
@@ -122,7 +126,6 @@ if TYPE_CHECKING:
     from crewai.context import ExecutionContext
     from crewai.flow.async_feedback.types import PendingFeedbackContext
     from crewai.llms.base_llm import BaseLLM
-    from crewai.state.provider.core import BaseProvider
 
 from crewai.flow.visualization import build_flow_structure, render_interactive
 from crewai.types.streaming import CrewStreamingOutput, FlowStreamingOutput
@@ -928,20 +931,21 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
     ] = Field(default=None)
 
     @classmethod
-    def from_checkpoint(
-        cls, path: str, *, provider: BaseProvider | None = None
-    ) -> Flow:  # type: ignore[type-arg]
-        """Restore a Flow from a checkpoint file."""
+    def from_checkpoint(cls, config: CheckpointConfig) -> Flow:  # type: ignore[type-arg]
+        """Restore a Flow from a checkpoint.
+
+        Args:
+            config: Checkpoint configuration with ``restore_from`` set to
+                the path of the checkpoint to load.
+
+        Returns:
+            A Flow instance ready to resume.
+        """
         from crewai.context import apply_execution_context
         from crewai.events.event_bus import crewai_event_bus
-        from crewai.state.provider.json_provider import JsonProvider
         from crewai.state.runtime import RuntimeState
 
-        state = RuntimeState.from_checkpoint(
-            path,
-            provider=provider or JsonProvider(),
-            context={"from_checkpoint": True},
-        )
+        state = RuntimeState.from_checkpoint(config, context={"from_checkpoint": True})
         crewai_event_bus.set_runtime_state(state)
         for entity in state.root:
             if not isinstance(entity, Flow):
@@ -958,27 +962,24 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
             instance.checkpoint_state = entity.checkpoint_state
             instance._restore_from_checkpoint()
             return instance
-        raise ValueError(f"No Flow found in checkpoint: {path}")
+        raise ValueError(f"No Flow found in checkpoint: {config.restore_from}")
 
     @classmethod
     def fork(
         cls,
-        path: str,
-        *,
+        config: CheckpointConfig,
         branch: str | None = None,
-        provider: BaseProvider | None = None,
     ) -> Flow:  # type: ignore[type-arg]
         """Fork a Flow from a checkpoint, creating a new execution branch.
 
         Args:
-            path: Path to a checkpoint file.
+            config: Checkpoint configuration with ``restore_from`` set.
             branch: Branch label for the fork. Auto-generated if not provided.
-            provider: Storage backend to read from. Defaults to auto-detect.
 
         Returns:
             A Flow instance on the new branch. Call kickoff() to run.
         """
-        flow = cls.from_checkpoint(path, provider=provider)
+        flow = cls.from_checkpoint(config)
         state = crewai_event_bus._runtime_state
         if state is None:
             raise RuntimeError(
@@ -1984,6 +1985,7 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
         self,
         inputs: dict[str, Any] | None = None,
         input_files: dict[str, FileInput] | None = None,
+        from_checkpoint: CheckpointConfig | None = None,
     ) -> Any | FlowStreamingOutput:
         """Start the flow execution in a synchronous context.
 
@@ -1993,10 +1995,15 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
         Args:
             inputs: Optional dictionary containing input values and/or a state ID.
             input_files: Optional dict of named file inputs for the flow.
+            from_checkpoint: Optional checkpoint config. If ``restore_from``
+                is set, the flow resumes from that checkpoint.
 
         Returns:
             The final output from the flow or FlowStreamingOutput if streaming.
         """
+        restored = apply_checkpoint(self, from_checkpoint)
+        if restored is not None:
+            return restored.kickoff(inputs=inputs, input_files=input_files)
         get_env_context()
         if self.stream:
             result_holder: list[Any] = []
@@ -2053,6 +2060,7 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
         self,
         inputs: dict[str, Any] | None = None,
         input_files: dict[str, FileInput] | None = None,
+        from_checkpoint: CheckpointConfig | None = None,
     ) -> Any | FlowStreamingOutput:
         """Start the flow execution asynchronously.
 
@@ -2064,10 +2072,15 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
         Args:
             inputs: Optional dictionary containing input values and/or a state ID for restoration.
             input_files: Optional dict of named file inputs for the flow.
+            from_checkpoint: Optional checkpoint config. If ``restore_from``
+                is set, the flow resumes from that checkpoint.
 
         Returns:
             The final output from the flow, which is the result of the last executed method.
         """
+        restored = apply_checkpoint(self, from_checkpoint)
+        if restored is not None:
+            return await restored.kickoff_async(inputs=inputs, input_files=input_files)
         if self.stream:
             result_holder: list[Any] = []
             current_task_info: TaskInfo = {
@@ -2326,17 +2339,20 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
         self,
         inputs: dict[str, Any] | None = None,
         input_files: dict[str, FileInput] | None = None,
+        from_checkpoint: CheckpointConfig | None = None,
     ) -> Any | FlowStreamingOutput:
         """Native async method to start the flow execution. Alias for kickoff_async.
 
         Args:
             inputs: Optional dictionary containing input values and/or a state ID for restoration.
             input_files: Optional dict of named file inputs for the flow.
+            from_checkpoint: Optional checkpoint config. If ``restore_from``
+                is set, the flow resumes from that checkpoint.
 
         Returns:
             The final output from the flow, which is the result of the last executed method.
         """
-        return await self.kickoff_async(inputs, input_files)
+        return await self.kickoff_async(inputs, input_files, from_checkpoint)
 
     async def _execute_start_method(self, start_method_name: FlowMethodName) -> None:
         """Executes a flow's start method and its triggered listeners.
diff --git a/lib/crewai/src/crewai/state/checkpoint_config.py b/lib/crewai/src/crewai/state/checkpoint_config.py
index 38c6b0490..bd24ef8eb 100644
--- a/lib/crewai/src/crewai/state/checkpoint_config.py
+++ b/lib/crewai/src/crewai/state/checkpoint_config.py
@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from pathlib import Path
 from typing import Annotated, Any, Literal
 
 from pydantic import BaseModel, Field, model_validator
@@ -201,6 +202,12 @@ class CheckpointConfig(BaseModel):
         description="Maximum checkpoints to keep. Oldest are pruned after "
         "each write. None means keep all.",
     )
+    restore_from: Path | str | None = Field(
+        default=None,
+        description="Path or location of a checkpoint to restore from. "
+        "When passed via a kickoff method's from_checkpoint parameter, "
+        "the crew or flow resumes from this checkpoint.",
+    )
 
     @model_validator(mode="after")
     def _register_handlers(self) -> CheckpointConfig:
@@ -216,3 +223,25 @@ class CheckpointConfig(BaseModel):
     @property
     def trigger_events(self) -> set[str]:
         return set(self.on_events)
+
+
+def apply_checkpoint(instance: Any, from_checkpoint: CheckpointConfig | None) -> Any:
+    """Handle checkpoint config for a kickoff method.
+
+    If *from_checkpoint* carries a ``restore_from`` path, builds and returns a
+    restored instance (with ``restore_from`` cleared).  The caller should
+    dispatch into its own kickoff variant on that restored instance.
+
+    If *from_checkpoint* is present but has no ``restore_from``, sets
+    ``instance.checkpoint`` and returns ``None`` (proceed normally).
+
+    If *from_checkpoint* is ``None``, returns ``None`` immediately.
+    """
+    if from_checkpoint is None:
+        return None
+    if from_checkpoint.restore_from is not None:
+        restored = type(instance).from_checkpoint(from_checkpoint)
+        restored.checkpoint = from_checkpoint.model_copy(update={"restore_from": None})
+        return restored
+    instance.checkpoint = from_checkpoint
+    return None
diff --git a/lib/crewai/src/crewai/state/runtime.py b/lib/crewai/src/crewai/state/runtime.py
index 79c836e1e..3f32457bb 100644
--- a/lib/crewai/src/crewai/state/runtime.py
+++ b/lib/crewai/src/crewai/state/runtime.py
@@ -23,6 +23,7 @@ from pydantic import (
 )
 
 from crewai.context import capture_execution_context
+from crewai.state.checkpoint_config import CheckpointConfig
 from crewai.state.event_record import EventRecord
 from crewai.state.provider.core import BaseProvider
 from crewai.state.provider.json_provider import JsonProvider
@@ -208,19 +209,22 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
             self._branch = f"fork/{uuid.uuid4().hex[:8]}"
 
     @classmethod
-    def from_checkpoint(
-        cls, location: str, provider: BaseProvider, **kwargs: Any
-    ) -> RuntimeState:
+    def from_checkpoint(cls, config: CheckpointConfig, **kwargs: Any) -> RuntimeState:
         """Restore a RuntimeState from a checkpoint.
 
         Args:
-            location: The identifier returned by a previous ``checkpoint`` call.
-            provider: The storage backend to read from.
+            config: Checkpoint configuration with ``restore_from`` set.
             **kwargs: Passed to ``model_validate_json``.
 
         Returns:
             A restored RuntimeState.
         """
+        from crewai.state.provider.utils import detect_provider
+
+        if config.restore_from is None:
+            raise ValueError("CheckpointConfig.restore_from must be set")
+        location = str(config.restore_from)
+        provider = detect_provider(location)
         raw = provider.from_checkpoint(location)
         state = cls.model_validate_json(raw, **kwargs)
         checkpoint_id = provider.extract_id(location)
@@ -230,18 +234,23 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
 
     @classmethod
     async def afrom_checkpoint(
-        cls, location: str, provider: BaseProvider, **kwargs: Any
+        cls, config: CheckpointConfig, **kwargs: Any
     ) -> RuntimeState:
         """Async version of :meth:`from_checkpoint`.
 
         Args:
-            location: The identifier returned by a previous ``acheckpoint`` call.
-            provider: The storage backend to read from.
+            config: Checkpoint configuration with ``restore_from`` set.
             **kwargs: Passed to ``model_validate_json``.
 
         Returns:
             A restored RuntimeState.
         """
+        from crewai.state.provider.utils import detect_provider
+
+        if config.restore_from is None:
+            raise ValueError("CheckpointConfig.restore_from must be set")
+        location = str(config.restore_from)
+        provider = detect_provider(location)
         raw = await provider.afrom_checkpoint(location)
         state = cls.model_validate_json(raw, **kwargs)
         checkpoint_id = provider.extract_id(location)
diff --git a/lib/crewai/tests/test_checkpoint.py b/lib/crewai/tests/test_checkpoint.py
index 0a0c00027..1f1541790 100644
--- a/lib/crewai/tests/test_checkpoint.py
+++ b/lib/crewai/tests/test_checkpoint.py
@@ -172,6 +172,14 @@ class TestCheckpointConfig:
         cfg = CheckpointConfig(on_events=["*"])
         assert cfg.trigger_all
 
+    def test_restore_from_field(self) -> None:
+        cfg = CheckpointConfig(restore_from="/path/to/checkpoint.json")
+        assert cfg.restore_from == "/path/to/checkpoint.json"
+
+    def test_restore_from_default_none(self) -> None:
+        cfg = CheckpointConfig()
+        assert cfg.restore_from is None
+
     def test_trigger_events(self) -> None:
         cfg = CheckpointConfig(
             on_events=["task_completed", "crew_kickoff_completed"]
@@ -269,9 +277,9 @@ class TestRuntimeStateLineage:
             loc = state.checkpoint(d)
             written_id = state._checkpoint_id
 
-            provider = JsonProvider()
+            cfg = CheckpointConfig(restore_from=loc)
             restored = RuntimeState.from_checkpoint(
-                loc, provider, context={"from_checkpoint": True}
+                cfg, context={"from_checkpoint": True}
             )
             assert restored._checkpoint_id == written_id
             assert restored._parent_id == written_id
@@ -480,3 +488,51 @@ class TestSqliteProviderFork:
         agent = Agent(role="r", goal="g", backstory="b", llm="gpt-4o-mini")
         crew = Crew(agents=[agent], tasks=[], verbose=False)
         return RuntimeState(root=[crew])
+
+
+# ---------- Kickoff from_checkpoint parameter ----------
+
+
+class TestKickoffFromCheckpoint:
+    def test_crew_kickoff_delegates_to_from_checkpoint(self) -> None:
+        mock_restored = MagicMock(spec=Crew)
+        mock_restored.kickoff.return_value = "result"
+
+        cfg = CheckpointConfig(restore_from="/path/to/cp.json")
+        with patch.object(Crew, "from_checkpoint", return_value=mock_restored):
+            agent = Agent(role="r", goal="g", backstory="b", llm="gpt-4o-mini")
+            crew = Crew(agents=[agent], tasks=[], verbose=False)
+            result = crew.kickoff(inputs={"k": "v"}, from_checkpoint=cfg)
+
+        mock_restored.kickoff.assert_called_once_with(
+            inputs={"k": "v"}, input_files=None
+        )
+        assert mock_restored.checkpoint.restore_from is None
+        assert result == "result"
+
+    def test_crew_kickoff_config_only_sets_checkpoint(self) -> None:
+        cfg = CheckpointConfig(on_events=["task_completed"])
+        agent = Agent(role="r", goal="g", backstory="b", llm="gpt-4o-mini")
+        crew = Crew(agents=[agent], tasks=[], verbose=False)
+        assert crew.checkpoint is None
+        with patch("crewai.crew.get_env_context"), \
+             patch("crewai.crew.prepare_kickoff", side_effect=RuntimeError("stop")):
+            with pytest.raises(RuntimeError, match="stop"):
+                crew.kickoff(from_checkpoint=cfg)
+        assert isinstance(crew.checkpoint, CheckpointConfig)
+        assert crew.checkpoint.on_events == ["task_completed"]
+
+    def test_flow_kickoff_delegates_to_from_checkpoint(self) -> None:
+        mock_restored = MagicMock(spec=Flow)
+        mock_restored.kickoff.return_value = "flow_result"
+
+        cfg = CheckpointConfig(restore_from="/path/to/flow_cp.json")
+        with patch.object(Flow, "from_checkpoint", return_value=mock_restored):
+            flow = Flow()
+            result = flow.kickoff(from_checkpoint=cfg)
+
+        mock_restored.kickoff.assert_called_once_with(
+            inputs=None, input_files=None
+        )
+        assert mock_restored.checkpoint.restore_from is None
+        assert result == "flow_result"

From fc6792d0678fb6c80a81b13289b09ae01a29a3fd Mon Sep 17 00:00:00 2001
From: Lucas Gomide <lucaslg200@gmail.com>
Date: Fri, 10 Apr 2026 01:22:27 -0300
Subject: [PATCH 23/70] feat: enrich LLM token tracking with reasoning tokens,
 cache creation tokens (#5389)

---
 lib/crewai/src/crewai/llms/base_llm.py        | 12 +++
 .../llms/providers/anthropic/completion.py    |  9 +-
 .../crewai/llms/providers/azure/completion.py | 12 ++-
 .../llms/providers/bedrock/completion.py      |  7 ++
 .../llms/providers/gemini/completion.py       |  7 +-
 .../llms/providers/openai/completion.py       | 20 +++--
 lib/crewai/src/crewai/types/usage_metrics.py  | 10 +++
 .../tests/events/test_llm_usage_event.py      | 48 +++++++++++
 .../tests/llms/anthropic/test_anthropic.py    | 42 ++++++++++
 lib/crewai/tests/llms/azure/test_azure.py     | 41 ++++++++++
 lib/crewai/tests/llms/bedrock/test_bedrock.py | 78 ++++++++++++++++++
 lib/crewai/tests/llms/google/test_google.py   | 39 +++++++++
 lib/crewai/tests/llms/openai/test_openai.py   | 82 +++++++++++++++++++
 lib/crewai/tests/test_llm.py                  | 10 +++
 14 files changed, 405 insertions(+), 12 deletions(-)

diff --git a/lib/crewai/src/crewai/llms/base_llm.py b/lib/crewai/src/crewai/llms/base_llm.py
index 41ce1d2cd..4f45572ee 100644
--- a/lib/crewai/src/crewai/llms/base_llm.py
+++ b/lib/crewai/src/crewai/llms/base_llm.py
@@ -172,6 +172,8 @@ class BaseLLM(BaseModel, ABC):
             "completion_tokens": 0,
             "successful_requests": 0,
             "cached_prompt_tokens": 0,
+            "reasoning_tokens": 0,
+            "cache_creation_tokens": 0,
         }
     )
 
@@ -808,14 +810,24 @@ class BaseLLM(BaseModel, ABC):
         cached_tokens = (
             usage_data.get("cached_tokens")
             or usage_data.get("cached_prompt_tokens")
+            or usage_data.get("cache_read_input_tokens")
             or 0
         )
+        if not cached_tokens:
+            prompt_details = usage_data.get("prompt_tokens_details")
+            if isinstance(prompt_details, dict):
+                cached_tokens = prompt_details.get("cached_tokens", 0) or 0
+
+        reasoning_tokens = usage_data.get("reasoning_tokens", 0) or 0
+        cache_creation_tokens = usage_data.get("cache_creation_tokens", 0) or 0
 
         self._token_usage["prompt_tokens"] += prompt_tokens
         self._token_usage["completion_tokens"] += completion_tokens
         self._token_usage["total_tokens"] += prompt_tokens + completion_tokens
         self._token_usage["successful_requests"] += 1
         self._token_usage["cached_prompt_tokens"] += cached_tokens
+        self._token_usage["reasoning_tokens"] += reasoning_tokens
+        self._token_usage["cache_creation_tokens"] += cache_creation_tokens
 
     def get_token_usage_summary(self) -> UsageMetrics:
         """Get summary of token usage for this LLM instance.
diff --git a/lib/crewai/src/crewai/llms/providers/anthropic/completion.py b/lib/crewai/src/crewai/llms/providers/anthropic/completion.py
index b6df34b94..ad572afa8 100644
--- a/lib/crewai/src/crewai/llms/providers/anthropic/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/anthropic/completion.py
@@ -1704,18 +1704,23 @@ class AnthropicCompletion(BaseLLM):
     def _extract_anthropic_token_usage(
         response: Message | BetaMessage,
     ) -> dict[str, Any]:
-        """Extract token usage from Anthropic response."""
+        """Extract token usage and response metadata from Anthropic response."""
         if hasattr(response, "usage") and response.usage:
             usage = response.usage
             input_tokens = getattr(usage, "input_tokens", 0)
             output_tokens = getattr(usage, "output_tokens", 0)
             cache_read_tokens = getattr(usage, "cache_read_input_tokens", 0) or 0
-            return {
+            cache_creation_tokens = (
+                getattr(usage, "cache_creation_input_tokens", 0) or 0
+            )
+            result: dict[str, Any] = {
                 "input_tokens": input_tokens,
                 "output_tokens": output_tokens,
                 "total_tokens": input_tokens + output_tokens,
                 "cached_prompt_tokens": cache_read_tokens,
+                "cache_creation_tokens": cache_creation_tokens,
             }
+            return result
         return {"total_tokens": 0}
 
     def supports_multimodal(self) -> bool:
diff --git a/lib/crewai/src/crewai/llms/providers/azure/completion.py b/lib/crewai/src/crewai/llms/providers/azure/completion.py
index db7ab7e73..cac811bc7 100644
--- a/lib/crewai/src/crewai/llms/providers/azure/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/azure/completion.py
@@ -1076,19 +1076,27 @@ class AzureCompletion(BaseLLM):
 
     @staticmethod
     def _extract_azure_token_usage(response: ChatCompletions) -> dict[str, Any]:
-        """Extract token usage from Azure response."""
+        """Extract token usage and response metadata from Azure response."""
         if hasattr(response, "usage") and response.usage:
             usage = response.usage
             cached_tokens = 0
             prompt_details = getattr(usage, "prompt_tokens_details", None)
             if prompt_details:
                 cached_tokens = getattr(prompt_details, "cached_tokens", 0) or 0
-            return {
+            reasoning_tokens = 0
+            completion_details = getattr(usage, "completion_tokens_details", None)
+            if completion_details:
+                reasoning_tokens = (
+                    getattr(completion_details, "reasoning_tokens", 0) or 0
+                )
+            result: dict[str, Any] = {
                 "prompt_tokens": getattr(usage, "prompt_tokens", 0),
                 "completion_tokens": getattr(usage, "completion_tokens", 0),
                 "total_tokens": getattr(usage, "total_tokens", 0),
                 "cached_prompt_tokens": cached_tokens,
+                "reasoning_tokens": reasoning_tokens,
             }
+            return result
         return {"total_tokens": 0}
 
     async def aclose(self) -> None:
diff --git a/lib/crewai/src/crewai/llms/providers/bedrock/completion.py b/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
index c25c9bfec..c3a27d6e2 100644
--- a/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
@@ -2025,11 +2025,18 @@ class BedrockCompletion(BaseLLM):
         input_tokens = usage.get("inputTokens", 0)
         output_tokens = usage.get("outputTokens", 0)
         total_tokens = usage.get("totalTokens", input_tokens + output_tokens)
+        raw_cached = (
+            usage.get("cacheReadInputTokenCount")
+            or usage.get("cacheReadInputTokens")
+            or 0
+        )
+        cached_tokens = raw_cached if isinstance(raw_cached, int) else 0
 
         self._token_usage["prompt_tokens"] += input_tokens
         self._token_usage["completion_tokens"] += output_tokens
         self._token_usage["total_tokens"] += total_tokens
         self._token_usage["successful_requests"] += 1
+        self._token_usage["cached_prompt_tokens"] += cached_tokens
 
     def supports_function_calling(self) -> bool:
         """Check if the model supports function calling."""
diff --git a/lib/crewai/src/crewai/llms/providers/gemini/completion.py b/lib/crewai/src/crewai/llms/providers/gemini/completion.py
index c84f7f5fd..3959bc659 100644
--- a/lib/crewai/src/crewai/llms/providers/gemini/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/gemini/completion.py
@@ -1306,17 +1306,20 @@ class GeminiCompletion(BaseLLM):
 
     @staticmethod
     def _extract_token_usage(response: GenerateContentResponse) -> dict[str, Any]:
-        """Extract token usage from Gemini response."""
+        """Extract token usage and response metadata from Gemini response."""
         if response.usage_metadata:
             usage = response.usage_metadata
             cached_tokens = getattr(usage, "cached_content_token_count", 0) or 0
-            return {
+            thinking_tokens = getattr(usage, "thoughts_token_count", 0) or 0
+            result: dict[str, Any] = {
                 "prompt_token_count": getattr(usage, "prompt_token_count", 0),
                 "candidates_token_count": getattr(usage, "candidates_token_count", 0),
                 "total_token_count": getattr(usage, "total_token_count", 0),
                 "total_tokens": getattr(usage, "total_token_count", 0),
                 "cached_prompt_tokens": cached_tokens,
+                "reasoning_tokens": thinking_tokens,
             }
+            return result
         return {"total_tokens": 0}
 
     @staticmethod
diff --git a/lib/crewai/src/crewai/llms/providers/openai/completion.py b/lib/crewai/src/crewai/llms/providers/openai/completion.py
index b76f552df..668794e83 100644
--- a/lib/crewai/src/crewai/llms/providers/openai/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/openai/completion.py
@@ -1324,19 +1324,23 @@ class OpenAICompletion(BaseLLM):
         ]
 
     def _extract_responses_token_usage(self, response: Response) -> dict[str, Any]:
-        """Extract token usage from Responses API response."""
+        """Extract token usage and response metadata from Responses API response."""
         if response.usage:
-            result = {
+            result: dict[str, Any] = {
                 "prompt_tokens": response.usage.input_tokens,
                 "completion_tokens": response.usage.output_tokens,
                 "total_tokens": response.usage.total_tokens,
             }
-            # Extract cached prompt tokens from input_tokens_details
             input_details = getattr(response.usage, "input_tokens_details", None)
             if input_details:
                 result["cached_prompt_tokens"] = (
                     getattr(input_details, "cached_tokens", 0) or 0
                 )
+            output_details = getattr(response.usage, "output_tokens_details", None)
+            if output_details:
+                result["reasoning_tokens"] = (
+                    getattr(output_details, "reasoning_tokens", 0) or 0
+                )
             return result
         return {"total_tokens": 0}
 
@@ -2307,20 +2311,24 @@ class OpenAICompletion(BaseLLM):
     def _extract_openai_token_usage(
         self, response: ChatCompletion | ChatCompletionChunk
     ) -> dict[str, Any]:
-        """Extract token usage from OpenAI ChatCompletion or ChatCompletionChunk response."""
+        """Extract token usage and response metadata from OpenAI ChatCompletion."""
         if hasattr(response, "usage") and response.usage:
             usage = response.usage
-            result = {
+            result: dict[str, Any] = {
                 "prompt_tokens": getattr(usage, "prompt_tokens", 0),
                 "completion_tokens": getattr(usage, "completion_tokens", 0),
                 "total_tokens": getattr(usage, "total_tokens", 0),
             }
-            # Extract cached prompt tokens from prompt_tokens_details
             prompt_details = getattr(usage, "prompt_tokens_details", None)
             if prompt_details:
                 result["cached_prompt_tokens"] = (
                     getattr(prompt_details, "cached_tokens", 0) or 0
                 )
+            completion_details = getattr(usage, "completion_tokens_details", None)
+            if completion_details:
+                result["reasoning_tokens"] = (
+                    getattr(completion_details, "reasoning_tokens", 0) or 0
+                )
             return result
         return {"total_tokens": 0}
 
diff --git a/lib/crewai/src/crewai/types/usage_metrics.py b/lib/crewai/src/crewai/types/usage_metrics.py
index 77e9ef598..76fa7dca0 100644
--- a/lib/crewai/src/crewai/types/usage_metrics.py
+++ b/lib/crewai/src/crewai/types/usage_metrics.py
@@ -29,6 +29,14 @@ class UsageMetrics(BaseModel):
     completion_tokens: int = Field(
         default=0, description="Number of tokens used in completions."
     )
+    reasoning_tokens: int = Field(
+        default=0,
+        description="Number of reasoning/thinking tokens (e.g. OpenAI o-series, Gemini thinking).",
+    )
+    cache_creation_tokens: int = Field(
+        default=0,
+        description="Number of cache creation tokens (e.g. Anthropic cache writes).",
+    )
     successful_requests: int = Field(
         default=0, description="Number of successful requests made."
     )
@@ -43,4 +51,6 @@ class UsageMetrics(BaseModel):
         self.prompt_tokens += usage_metrics.prompt_tokens
         self.cached_prompt_tokens += usage_metrics.cached_prompt_tokens
         self.completion_tokens += usage_metrics.completion_tokens
+        self.reasoning_tokens += usage_metrics.reasoning_tokens
+        self.cache_creation_tokens += usage_metrics.cache_creation_tokens
         self.successful_requests += usage_metrics.successful_requests
diff --git a/lib/crewai/tests/events/test_llm_usage_event.py b/lib/crewai/tests/events/test_llm_usage_event.py
index f19f07b47..9be8c639f 100644
--- a/lib/crewai/tests/events/test_llm_usage_event.py
+++ b/lib/crewai/tests/events/test_llm_usage_event.py
@@ -174,3 +174,51 @@ class TestEmitCallCompletedEventPassesUsage:
         event = mock_emit.call_args[1]["event"]
         assert isinstance(event, LLMCallCompletedEvent)
         assert event.usage is None
+
+class TestUsageMetricsNewFields:
+    def test_add_usage_metrics_aggregates_reasoning_and_cache_creation(self):
+        from crewai.types.usage_metrics import UsageMetrics
+
+        metrics1 = UsageMetrics(
+            total_tokens=100,
+            prompt_tokens=60,
+            completion_tokens=40,
+            cached_prompt_tokens=10,
+            reasoning_tokens=15,
+            cache_creation_tokens=5,
+            successful_requests=1,
+        )
+        metrics2 = UsageMetrics(
+            total_tokens=200,
+            prompt_tokens=120,
+            completion_tokens=80,
+            cached_prompt_tokens=20,
+            reasoning_tokens=25,
+            cache_creation_tokens=10,
+            successful_requests=1,
+        )
+
+        metrics1.add_usage_metrics(metrics2)
+
+        assert metrics1.total_tokens == 300
+        assert metrics1.prompt_tokens == 180
+        assert metrics1.completion_tokens == 120
+        assert metrics1.cached_prompt_tokens == 30
+        assert metrics1.reasoning_tokens == 40
+        assert metrics1.cache_creation_tokens == 15
+        assert metrics1.successful_requests == 2
+
+    def test_new_fields_default_to_zero(self):
+        from crewai.types.usage_metrics import UsageMetrics
+
+        metrics = UsageMetrics()
+        assert metrics.reasoning_tokens == 0
+        assert metrics.cache_creation_tokens == 0
+
+    def test_model_dump_includes_new_fields(self):
+        from crewai.types.usage_metrics import UsageMetrics
+
+        metrics = UsageMetrics(reasoning_tokens=10, cache_creation_tokens=5)
+        dumped = metrics.model_dump()
+        assert dumped["reasoning_tokens"] == 10
+        assert dumped["cache_creation_tokens"] == 5
diff --git a/lib/crewai/tests/llms/anthropic/test_anthropic.py b/lib/crewai/tests/llms/anthropic/test_anthropic.py
index e8f16af5a..81a51c8d6 100644
--- a/lib/crewai/tests/llms/anthropic/test_anthropic.py
+++ b/lib/crewai/tests/llms/anthropic/test_anthropic.py
@@ -1463,3 +1463,45 @@ def test_tool_search_saves_input_tokens():
         f"Expected tool_search ({usage_search.prompt_tokens}) to use fewer input tokens "
         f"than no search ({usage_no_search.prompt_tokens})"
     )
+
+
+def test_anthropic_cache_creation_tokens_extraction():
+    """Test that cache_creation_input_tokens are extracted from Anthropic responses."""
+    llm = LLM(model="anthropic/claude-3-5-sonnet-20241022")
+
+    mock_response = MagicMock()
+    mock_response.content = [MagicMock(text="test response")]
+    mock_response.usage = MagicMock(
+        input_tokens=100,
+        output_tokens=50,
+        cache_read_input_tokens=30,
+        cache_creation_input_tokens=20,
+    )
+    mock_response.stop_reason = None
+    mock_response.model = None
+
+    usage = llm._extract_anthropic_token_usage(mock_response)
+    assert usage["input_tokens"] == 100
+    assert usage["output_tokens"] == 50
+    assert usage["total_tokens"] == 150
+    assert usage["cached_prompt_tokens"] == 30
+    assert usage["cache_creation_tokens"] == 20
+
+
+def test_anthropic_missing_cache_fields_default_to_zero():
+    """Test that missing cache fields default to zero."""
+    llm = LLM(model="anthropic/claude-3-5-sonnet-20241022")
+
+    mock_response = MagicMock()
+    mock_response.content = [MagicMock(text="test response")]
+    mock_response.usage = MagicMock(
+        input_tokens=40,
+        output_tokens=20,
+        spec=["input_tokens", "output_tokens"],
+    )
+    mock_response.usage.cache_read_input_tokens = None
+    mock_response.usage.cache_creation_input_tokens = None
+
+    usage = llm._extract_anthropic_token_usage(mock_response)
+    assert usage["cached_prompt_tokens"] == 0
+    assert usage["cache_creation_tokens"] == 0
diff --git a/lib/crewai/tests/llms/azure/test_azure.py b/lib/crewai/tests/llms/azure/test_azure.py
index a0da30998..38b31a2e2 100644
--- a/lib/crewai/tests/llms/azure/test_azure.py
+++ b/lib/crewai/tests/llms/azure/test_azure.py
@@ -1403,3 +1403,44 @@ def test_azure_stop_words_still_applied_to_regular_responses():
         assert "Observation:" not in result
         assert "Found results" not in result
         assert "I need to search for more information" in result
+
+
+def test_azure_reasoning_tokens_and_cached_tokens():
+    """Test that reasoning_tokens and cached_tokens are extracted from Azure responses."""
+    llm = LLM(model="azure/gpt-4")
+
+    mock_response = MagicMock()
+    mock_response.usage = MagicMock(
+        prompt_tokens=100,
+        completion_tokens=200,
+        total_tokens=300,
+    )
+    mock_response.usage.prompt_tokens_details = MagicMock(cached_tokens=40)
+    mock_response.usage.completion_tokens_details = MagicMock(reasoning_tokens=60)
+
+    usage = llm._extract_azure_token_usage(mock_response)
+    assert usage["prompt_tokens"] == 100
+    assert usage["completion_tokens"] == 200
+    assert usage["total_tokens"] == 300
+    assert usage["cached_prompt_tokens"] == 40
+    assert usage["reasoning_tokens"] == 60
+
+
+def test_azure_no_detail_fields():
+    """Test Azure extraction without detail fields."""
+    llm = LLM(model="azure/gpt-4")
+
+    mock_response = MagicMock()
+    mock_response.usage = MagicMock(
+        prompt_tokens=50,
+        completion_tokens=30,
+        total_tokens=80,
+    )
+    mock_response.usage.prompt_tokens_details = None
+    mock_response.usage.completion_tokens_details = None
+
+    usage = llm._extract_azure_token_usage(mock_response)
+    assert usage["prompt_tokens"] == 50
+    assert usage["completion_tokens"] == 30
+    assert usage["cached_prompt_tokens"] == 0
+    assert usage["reasoning_tokens"] == 0
diff --git a/lib/crewai/tests/llms/bedrock/test_bedrock.py b/lib/crewai/tests/llms/bedrock/test_bedrock.py
index 76958bf86..959b1dbc2 100644
--- a/lib/crewai/tests/llms/bedrock/test_bedrock.py
+++ b/lib/crewai/tests/llms/bedrock/test_bedrock.py
@@ -1175,3 +1175,81 @@ def test_bedrock_tool_results_not_merged_across_assistant_messages():
     )
     assert tool_result_messages[0]["content"][0]["toolResult"]["toolUseId"] == "call_a"
     assert tool_result_messages[1]["content"][0]["toolResult"]["toolUseId"] == "call_b"
+
+
+def test_bedrock_cached_token_tracking():
+    """Test that cached tokens (cacheReadInputTokenCount) are tracked for Bedrock."""
+    llm = LLM(model="bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0")
+
+    with patch.object(llm._client, 'converse') as mock_converse:
+        mock_response = {
+            'output': {
+                'message': {
+                    'role': 'assistant',
+                    'content': [{'text': 'test response'}]
+                }
+            },
+            'usage': {
+                'inputTokens': 100,
+                'outputTokens': 50,
+                'totalTokens': 150,
+                'cacheReadInputTokenCount': 30,
+            }
+        }
+        mock_converse.return_value = mock_response
+
+        result = llm.call("Hello")
+        assert result == "test response"
+        assert llm._token_usage['prompt_tokens'] == 100
+        assert llm._token_usage['completion_tokens'] == 50
+        assert llm._token_usage['total_tokens'] == 150
+        assert llm._token_usage['cached_prompt_tokens'] == 30
+
+
+def test_bedrock_cached_token_alternate_key():
+    """Test that the alternate key cacheReadInputTokens also works."""
+    llm = LLM(model="bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0")
+
+    with patch.object(llm._client, 'converse') as mock_converse:
+        mock_response = {
+            'output': {
+                'message': {
+                    'role': 'assistant',
+                    'content': [{'text': 'test response'}]
+                }
+            },
+            'usage': {
+                'inputTokens': 80,
+                'outputTokens': 40,
+                'totalTokens': 120,
+                'cacheReadInputTokens': 25,
+            }
+        }
+        mock_converse.return_value = mock_response
+
+        llm.call("Hello")
+        assert llm._token_usage['cached_prompt_tokens'] == 25
+
+
+def test_bedrock_no_cache_tokens_defaults_to_zero():
+    """Test that missing cache token keys default to zero."""
+    llm = LLM(model="bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0")
+
+    with patch.object(llm._client, 'converse') as mock_converse:
+        mock_response = {
+            'output': {
+                'message': {
+                    'role': 'assistant',
+                    'content': [{'text': 'test response'}]
+                }
+            },
+            'usage': {
+                'inputTokens': 60,
+                'outputTokens': 30,
+                'totalTokens': 90,
+            }
+        }
+        mock_converse.return_value = mock_response
+
+        llm.call("Hello")
+        assert llm._token_usage['cached_prompt_tokens'] == 0
diff --git a/lib/crewai/tests/llms/google/test_google.py b/lib/crewai/tests/llms/google/test_google.py
index d0553c7db..25b755dae 100644
--- a/lib/crewai/tests/llms/google/test_google.py
+++ b/lib/crewai/tests/llms/google/test_google.py
@@ -1190,3 +1190,42 @@ def test_gemini_cached_prompt_tokens_with_tools():
     # cached_prompt_tokens should be populated (may be 0 if Gemini
     # doesn't cache for this particular request, but the field should exist)
     assert usage.cached_prompt_tokens >= 0
+
+
+def test_gemini_reasoning_tokens_extraction():
+    """Test that thoughts_token_count is extracted as reasoning_tokens from Gemini."""
+    llm = LLM(model="google/gemini-2.0-flash-001")
+
+    mock_response = MagicMock()
+    mock_response.usage_metadata = MagicMock(
+        prompt_token_count=100,
+        candidates_token_count=50,
+        total_token_count=150,
+        cached_content_token_count=10,
+        thoughts_token_count=30,
+    )
+    usage = llm._extract_token_usage(mock_response)
+    assert usage["prompt_token_count"] == 100
+    assert usage["candidates_token_count"] == 50
+    assert usage["total_tokens"] == 150
+    assert usage["cached_prompt_tokens"] == 10
+    assert usage["reasoning_tokens"] == 30
+
+
+def test_gemini_no_thinking_tokens_defaults_to_zero():
+    """Test that missing thoughts_token_count defaults to zero."""
+    llm = LLM(model="google/gemini-2.0-flash-001")
+
+    mock_response = MagicMock()
+    mock_response.usage_metadata = MagicMock(
+        prompt_token_count=80,
+        candidates_token_count=40,
+        total_token_count=120,
+        cached_content_token_count=0,
+        thoughts_token_count=None,
+    )
+    mock_response.candidates = []
+
+    usage = llm._extract_token_usage(mock_response)
+    assert usage["reasoning_tokens"] == 0
+    assert usage["cached_prompt_tokens"] == 0
diff --git a/lib/crewai/tests/llms/openai/test_openai.py b/lib/crewai/tests/llms/openai/test_openai.py
index 3dada2d85..5a2a6a299 100644
--- a/lib/crewai/tests/llms/openai/test_openai.py
+++ b/lib/crewai/tests/llms/openai/test_openai.py
@@ -1929,6 +1929,47 @@ def test_openai_streaming_returns_tool_calls_without_available_functions():
     assert result[0]["type"] == "function"
 
 
+def test_openai_responses_api_reasoning_tokens_extraction():
+    """Test that reasoning_tokens are extracted from Responses API responses."""
+    llm = LLM(model="openai/gpt-4o")
+
+    mock_response = MagicMock()
+    mock_response.usage = MagicMock(
+        input_tokens=100,
+        output_tokens=200,
+        total_tokens=300,
+    )
+    mock_response.usage.input_tokens_details = MagicMock(cached_tokens=25)
+    mock_response.usage.output_tokens_details = MagicMock(reasoning_tokens=80)
+
+    usage = llm._extract_responses_token_usage(mock_response)
+    assert usage["prompt_tokens"] == 100
+    assert usage["completion_tokens"] == 200
+    assert usage["total_tokens"] == 300
+    assert usage["cached_prompt_tokens"] == 25
+    assert usage["reasoning_tokens"] == 80
+
+
+def test_openai_responses_api_no_detail_fields_omitted():
+    """Test that reasoning/cached fields are omitted when Responses API details are absent."""
+    llm = LLM(model="openai/gpt-4o")
+
+    mock_response = MagicMock()
+    mock_response.usage = MagicMock(
+        input_tokens=50,
+        output_tokens=30,
+        total_tokens=80,
+    )
+    mock_response.usage.input_tokens_details = None
+    mock_response.usage.output_tokens_details = None
+
+    usage = llm._extract_responses_token_usage(mock_response)
+    assert usage["prompt_tokens"] == 50
+    assert usage["completion_tokens"] == 30
+    assert "cached_prompt_tokens" not in usage
+    assert "reasoning_tokens" not in usage
+
+
 @pytest.mark.asyncio
 async def test_openai_async_streaming_returns_tool_calls_without_available_functions():
     """Test that async streaming returns tool calls list when available_functions is None.
@@ -2018,3 +2059,44 @@ async def test_openai_async_streaming_returns_tool_calls_without_available_funct
     assert result[0]["function"]["arguments"] == '{"expression": "1+1"}'
     assert result[0]["id"] == "call_abc123"
     assert result[0]["type"] == "function"
+
+
+def test_openai_reasoning_tokens_extraction():
+    """Test that reasoning_tokens are extracted from OpenAI o-series responses."""
+    llm = LLM(model="openai/gpt-4o")
+
+    mock_response = MagicMock()
+    mock_response.usage = MagicMock(
+        prompt_tokens=100,
+        completion_tokens=200,
+        total_tokens=300,
+    )
+    mock_response.usage.prompt_tokens_details = MagicMock(cached_tokens=25)
+    mock_response.usage.completion_tokens_details = MagicMock(reasoning_tokens=80)
+
+    usage = llm._extract_openai_token_usage(mock_response)
+    assert usage["prompt_tokens"] == 100
+    assert usage["completion_tokens"] == 200
+    assert usage["total_tokens"] == 300
+    assert usage["cached_prompt_tokens"] == 25
+    assert usage["reasoning_tokens"] == 80
+
+
+def test_openai_no_detail_fields_omitted():
+    """Test that reasoning/cached fields are omitted when details are absent."""
+    llm = LLM(model="openai/gpt-4o")
+
+    mock_response = MagicMock()
+    mock_response.usage = MagicMock(
+        prompt_tokens=50,
+        completion_tokens=30,
+        total_tokens=80,
+    )
+    mock_response.usage.prompt_tokens_details = None
+    mock_response.usage.completion_tokens_details = None
+
+    usage = llm._extract_openai_token_usage(mock_response)
+    assert usage["prompt_tokens"] == 50
+    assert usage["completion_tokens"] == 30
+    assert "cached_prompt_tokens" not in usage
+    assert "reasoning_tokens" not in usage
diff --git a/lib/crewai/tests/test_llm.py b/lib/crewai/tests/test_llm.py
index 413504f31..60ecca7f0 100644
--- a/lib/crewai/tests/test_llm.py
+++ b/lib/crewai/tests/test_llm.py
@@ -1001,6 +1001,8 @@ def test_usage_info_non_streaming_with_call():
         "completion_tokens": 0,
         "successful_requests": 0,
         "cached_prompt_tokens": 0,
+        "reasoning_tokens": 0,
+        "cache_creation_tokens": 0,
     }
     assert llm.stream is False
 
@@ -1025,6 +1027,8 @@ def test_usage_info_streaming_with_call():
         "completion_tokens": 0,
         "successful_requests": 0,
         "cached_prompt_tokens": 0,
+        "reasoning_tokens": 0,
+        "cache_creation_tokens": 0,
     }
     assert llm.stream is True
 
@@ -1056,6 +1060,8 @@ async def test_usage_info_non_streaming_with_acall():
         "completion_tokens": 0,
         "successful_requests": 0,
         "cached_prompt_tokens": 0,
+        "reasoning_tokens": 0,
+        "cache_creation_tokens": 0,
     }
 
     with patch.object(
@@ -1089,6 +1095,8 @@ async def test_usage_info_non_streaming_with_acall_and_stop():
         "completion_tokens": 0,
         "successful_requests": 0,
         "cached_prompt_tokens": 0,
+        "reasoning_tokens": 0,
+        "cache_creation_tokens": 0,
     }
 
     with patch.object(
@@ -1121,6 +1129,8 @@ async def test_usage_info_streaming_with_acall():
         "completion_tokens": 0,
         "successful_requests": 0,
         "cached_prompt_tokens": 0,
+        "reasoning_tokens": 0,
+        "cache_creation_tokens": 0,
     }
 
     with patch.object(

From 6efa142e220cba99cbdfd03cff80740618a7e135 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Fri, 10 Apr 2026 15:32:54 +0800
Subject: [PATCH 24/70] fix: forward strict mode to Anthropic and Bedrock
 providers

The OpenAI-format tool schema sets strict: true but this was dropped
during conversion to Anthropic/Bedrock formats, so neither provider
used constrained decoding. Without it, the model can return string
"None" instead of JSON null for nullable fields, causing Pydantic
validation failures.
---
 lib/crewai/pyproject.toml                     |   6 +-
 .../llms/providers/anthropic/completion.py    |   4 +
 .../llms/providers/bedrock/completion.py      |   5 +
 uv.lock                                       | 277 ++++++++++--------
 4 files changed, 170 insertions(+), 122 deletions(-)

diff --git a/lib/crewai/pyproject.toml b/lib/crewai/pyproject.toml
index fbe2bae52..c9f072c90 100644
--- a/lib/crewai/pyproject.toml
+++ b/lib/crewai/pyproject.toml
@@ -74,8 +74,8 @@ qdrant = [
     "qdrant-client[fastembed]~=1.14.3",
 ]
 aws = [
-    "boto3~=1.40.38",
-    "aiobotocore~=2.25.2",
+    "boto3~=1.42.79",
+    "aiobotocore~=3.4.0",
 ]
 watson = [
     "ibm-watsonx-ai~=1.3.39",
@@ -87,7 +87,7 @@ litellm = [
     "litellm~=1.83.0",
 ]
 bedrock = [
-    "boto3~=1.40.45",
+    "boto3~=1.42.79",
 ]
 google-genai = [
     "google-genai~=1.65.0",
diff --git a/lib/crewai/src/crewai/llms/providers/anthropic/completion.py b/lib/crewai/src/crewai/llms/providers/anthropic/completion.py
index ad572afa8..0d666a63c 100644
--- a/lib/crewai/src/crewai/llms/providers/anthropic/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/anthropic/completion.py
@@ -494,6 +494,10 @@ class AnthropicCompletion(BaseLLM):
                     "required": [],
                 }
 
+            func_info = tool.get("function", {})
+            if func_info.get("strict"):
+                anthropic_tool["strict"] = True
+
             anthropic_tools.append(anthropic_tool)
 
         return anthropic_tools
diff --git a/lib/crewai/src/crewai/llms/providers/bedrock/completion.py b/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
index c3a27d6e2..0747b7006 100644
--- a/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
@@ -169,6 +169,7 @@ class ToolSpec(TypedDict, total=False):
     name: Required[str]
     description: Required[str]
     inputSchema: ToolInputSchema
+    strict: bool
 
 
 class ConverseToolTypeDef(TypedDict):
@@ -1965,6 +1966,10 @@ class BedrockCompletion(BaseLLM):
                     input_schema: ToolInputSchema = {"json": parameters}
                     tool_spec["inputSchema"] = input_schema
 
+                func_info = tool.get("function", {})
+                if func_info.get("strict"):
+                    tool_spec["strict"] = True
+
                 converse_tool: ConverseToolTypeDef = {"toolSpec": tool_spec}
 
                 converse_tools.append(converse_tool)
diff --git a/uv.lock b/uv.lock
index 2df411274..aca62baa3 100644
--- a/uv.lock
+++ b/uv.lock
@@ -13,7 +13,7 @@ resolution-markers = [
 ]
 
 [options]
-exclude-newer = "2026-04-11T07:00:00Z"
+exclude-newer = "2026-04-10T16:00:00Z"
 
 [manifest]
 members = [
@@ -60,7 +60,7 @@ dev = [
 
 [[package]]
 name = "a2a-sdk"
-version = "0.3.25"
+version = "0.3.26"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "google-api-core" },
@@ -69,9 +69,9 @@ dependencies = [
     { name = "protobuf" },
     { name = "pydantic" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/55/83/3c99b276d09656cce039464509f05bf385e5600d6dc046a131bbcf686930/a2a_sdk-0.3.25.tar.gz", hash = "sha256:afda85bab8d6af0c5d15e82f326c94190f6be8a901ce562d045a338b7127242f", size = 270638, upload-time = "2026-03-10T13:08:46.417Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/be/97/a6840e01795b182ce751ca165430d46459927cde9bfab838087cbb24aef7/a2a_sdk-0.3.26.tar.gz", hash = "sha256:44068e2d037afbb07ab899267439e9bc7eaa7ac2af94f1e8b239933c993ad52d", size = 274598, upload-time = "2026-04-09T15:21:13.902Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/bd/f9/6a62520b7ecb945188a6e1192275f4732ff9341cd4629bc975a6c146aeab/a2a_sdk-0.3.25-py3-none-any.whl", hash = "sha256:2fce38faea82eb0b6f9f9c2bcf761b0d78612c80ef0e599b50d566db1b2654b5", size = 149609, upload-time = "2026-03-10T13:08:44.7Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/d5/51f4ee1bf3b736add42a542d3c8a3fd3fa85f3d36c17972127defc46c26f/a2a_sdk-0.3.26-py3-none-any.whl", hash = "sha256:754e0573f6d33b225c1d8d51f640efa69cbbed7bdfb06ce9c3540ea9f58d4a91", size = 151016, upload-time = "2026-04-09T15:21:12.35Z" },
 ]
 
 [[package]]
@@ -95,7 +95,7 @@ wheels = [
 
 [[package]]
 name = "aiobotocore"
-version = "2.25.2"
+version = "3.4.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "aiohttp" },
@@ -104,11 +104,12 @@ dependencies = [
     { name = "jmespath" },
     { name = "multidict" },
     { name = "python-dateutil" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
     { name = "wrapt" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/52/48/cf3c88c5e3fecdeed824f97a8a98a9fc0d7ef33e603f8f22c2fd32b9ef09/aiobotocore-2.25.2.tar.gz", hash = "sha256:ae0a512b34127097910b7af60752956254099ae54402a84c2021830768f92cda", size = 120585, upload-time = "2025-11-11T18:51:28.056Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/b8/50/a48ed11b15f926ce3dbb33e7fb0f25af17dbb99bcb7ae3b30c763723eca7/aiobotocore-3.4.0.tar.gz", hash = "sha256:a918b5cb903f81feba7e26835aed4b5e6bb2d0149d7f42bb2dd7d8089e3d9000", size = 122360, upload-time = "2026-04-07T06:12:24.884Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/8e/ad/a2f3964aa37da5a4c94c1e5f3934d6ac1333f991f675fcf08a618397a413/aiobotocore-2.25.2-py3-none-any.whl", hash = "sha256:0cec45c6ba7627dd5e5460337291c86ac38c3b512ec4054ce76407d0f7f2a48f", size = 86048, upload-time = "2025-11-11T18:51:26.139Z" },
+    { url = "https://files.pythonhosted.org/packages/df/d8/ce9386e6d76ea79e61dee15e62aa48cff6be69e89246b0ac4a11857cb02c/aiobotocore-3.4.0-py3-none-any.whl", hash = "sha256:26290eb6830ea92d8a6f5f90b56e9f5cedd6d126074d5db63b195e281d982465", size = 88018, upload-time = "2026-04-07T06:12:22.684Z" },
 ]
 
 [[package]]
@@ -614,16 +615,16 @@ wheels = [
 
 [[package]]
 name = "boto3"
-version = "1.40.70"
+version = "1.42.84"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "botocore" },
     { name = "jmespath" },
     { name = "s3transfer" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/37/12/d5ac34e0536e1914dde28245f014a635056dde0427f6efa09f104d7999f4/boto3-1.40.70.tar.gz", hash = "sha256:191443707b391232ed15676bf6bba7e53caec1e71aafa12ccad2e825c5ee15cc", size = 111638, upload-time = "2025-11-10T20:29:15.199Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/88/89/2d647bd717da55a8cc68602b197f53a5fa36fb95a2f9e76c4aff11a9cfd1/boto3-1.42.84.tar.gz", hash = "sha256:6a84b3293a5d8b3adf827a54588e7dcffcf0a85410d7dadca615544f97d27579", size = 112816, upload-time = "2026-04-06T19:39:07.585Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/f3/cf/e24d08b37cd318754a8e94906c8b34b88676899aad1907ff6942311f13c4/boto3-1.40.70-py3-none-any.whl", hash = "sha256:e8c2f4f4cb36297270f1023ebe5b100333e0e88ab6457a9687d80143d2e15bf9", size = 139358, upload-time = "2025-11-10T20:29:13.512Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/31/cdf4326841613d1d181a77b3038a988800fb3373ca50de1639fba9fa87de/boto3-1.42.84-py3-none-any.whl", hash = "sha256:4d03ad3211832484037337292586f71f48707141288d9ac23049c04204f4ab03", size = 140555, upload-time = "2026-04-06T19:39:06.009Z" },
 ]
 
 [[package]]
@@ -647,16 +648,16 @@ bedrock-runtime = [
 
 [[package]]
 name = "botocore"
-version = "1.40.70"
+version = "1.42.84"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "jmespath" },
     { name = "python-dateutil" },
     { name = "urllib3" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/35/c1/8c4c199ae1663feee579a15861e34f10b29da11ae6ea0ad7b6a847ef3823/botocore-1.40.70.tar.gz", hash = "sha256:61b1f2cecd54d1b28a081116fa113b97bf4e17da57c62ae2c2751fe4c528af1f", size = 14444592, upload-time = "2025-11-10T20:29:04.046Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/b4/b7/1c03423843fb0d1795b686511c00ee63fed1234c2400f469aeedfd42212f/botocore-1.42.84.tar.gz", hash = "sha256:234064604c80d9272a5e9f6b3566d260bcaa053a5e05246db90d7eca1c2cf44b", size = 15148615, upload-time = "2026-04-06T19:38:56.673Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/55/d2/507fd0ee4dd574d2bdbdeac5df83f39d2cae1ffe97d4622cca6f6bab39f1/botocore-1.40.70-py3-none-any.whl", hash = "sha256:4a394ad25f5d9f1ef0bed610365744523eeb5c22de6862ab25d8c93f9f6d295c", size = 14106829, upload-time = "2025-11-10T20:29:01.101Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/37/0c0c90361c8a1b9e6c75222ca24ae12996a298c0e18822a72ab229c37207/botocore-1.42.84-py3-none-any.whl", hash = "sha256:15f3fe07dfa6545e46a60c4b049fe2bdf63803c595ae4a4eec90e8f8172764f3", size = 14827061, upload-time = "2026-04-06T19:38:53.613Z" },
 ]
 
 [[package]]
@@ -1296,15 +1297,15 @@ watson = [
 [package.metadata]
 requires-dist = [
     { name = "a2a-sdk", marker = "extra == 'a2a'", specifier = "~=0.3.10" },
-    { name = "aiobotocore", marker = "extra == 'aws'", specifier = "~=2.25.2" },
+    { name = "aiobotocore", marker = "extra == 'aws'", specifier = "~=3.4.0" },
     { name = "aiocache", extras = ["memcached", "redis"], marker = "extra == 'a2a'", specifier = "~=0.12.3" },
     { name = "aiofiles", specifier = "~=24.1.0" },
     { name = "aiosqlite", specifier = "~=0.21.0" },
     { name = "anthropic", marker = "extra == 'anthropic'", specifier = "~=0.73.0" },
     { name = "appdirs", specifier = "~=1.4.4" },
     { name = "azure-ai-inference", marker = "extra == 'azure-ai-inference'", specifier = "~=1.0.0b9" },
-    { name = "boto3", marker = "extra == 'aws'", specifier = "~=1.40.38" },
-    { name = "boto3", marker = "extra == 'bedrock'", specifier = "~=1.40.45" },
+    { name = "boto3", marker = "extra == 'aws'", specifier = "~=1.42.79" },
+    { name = "boto3", marker = "extra == 'bedrock'", specifier = "~=1.42.79" },
     { name = "chromadb", specifier = "~=1.1.0" },
     { name = "click", specifier = "~=8.1.7" },
     { name = "crewai-files", marker = "extra == 'file-processing'", editable = "lib/crewai-files" },
@@ -1866,7 +1867,7 @@ wheels = [
 
 [[package]]
 name = "docling-core"
-version = "2.72.0"
+version = "2.73.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "defusedxml" },
@@ -1881,9 +1882,9 @@ dependencies = [
     { name = "typer" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/45/87/7b49ca0f4e39b051292694eb82e5ff3a7e6ae88a5bc11b8004747afb6e47/docling_core-2.72.0.tar.gz", hash = "sha256:981b789f7097c26b2fa84d0d28cdeaa58ddd8b49e277dce7e44b1b826b8f90f0", size = 304572, upload-time = "2026-04-07T12:35:55.736Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/4c/e3/b9c3b1a1ea62e5e03d9e844a5cff2f89b7a3e960725a862f009e8553ca3d/docling_core-2.73.0.tar.gz", hash = "sha256:33ffc2b2bf736ed0e079bba296081a26885f6cb08081c828d630ca85a51e22e0", size = 308895, upload-time = "2026-04-09T08:08:51.573Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/6a/e5/dfbcbfb3d258d5c44043cc1cd314d0447c8f08563ff8fa5a2f77d34eab31/docling_core-2.72.0-py3-none-any.whl", hash = "sha256:3592c35a423093c7fe087416a43de7db0bd1539148f2fa9ac775c41e4ec015a4", size = 269342, upload-time = "2026-04-07T12:35:54.06Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/c3/08143b7e8fe1b9230ce15e54926859f8c40ec2622fb612f0b2ff13169696/docling_core-2.73.0-py3-none-any.whl", hash = "sha256:4366fab8f4422fbde090ed87d9b091bd25b3b37cdd284dc0b02c9a5e24caaa22", size = 271518, upload-time = "2026-04-09T08:08:49.838Z" },
 ]
 
 [package.optional-dependencies]
@@ -2385,7 +2386,7 @@ wheels = [
 
 [[package]]
 name = "google-api-core"
-version = "2.30.2"
+version = "2.30.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "google-auth" },
@@ -2394,9 +2395,9 @@ dependencies = [
     { name = "protobuf" },
     { name = "requests" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/1a/2e/83ca41eb400eb228f9279ec14ed66f6475218b59af4c6daec2d5a509fe83/google_api_core-2.30.2.tar.gz", hash = "sha256:9a8113e1a88bdc09a7ff629707f2214d98d61c7f6ceb0ea38c42a095d02dc0f9", size = 176862, upload-time = "2026-04-02T21:23:44.876Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/16/ce/502a57fb0ec752026d24df1280b162294b22a0afb98a326084f9a979138b/google_api_core-2.30.3.tar.gz", hash = "sha256:e601a37f148585319b26db36e219df68c5d07b6382cff2d580e83404e44d641b", size = 177001, upload-time = "2026-04-10T00:41:28.035Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/84/e1/ebd5100cbb202e561c0c8b59e485ef3bd63fa9beb610f3fdcaea443f0288/google_api_core-2.30.2-py3-none-any.whl", hash = "sha256:a4c226766d6af2580577db1f1a51bf53cd262f722b49731ce7414c43068a9594", size = 173236, upload-time = "2026-04-02T21:23:06.395Z" },
+    { url = "https://files.pythonhosted.org/packages/03/15/e56f351cf6ef1cfea58e6ac226a7318ed1deb2218c4b3cc9bd9e4b786c5a/google_api_core-2.30.3-py3-none-any.whl", hash = "sha256:a85761ba72c444dad5d611c2220633480b2b6be2521eca69cca2dbb3ffd6bfe8", size = 173274, upload-time = "2026-04-09T22:57:16.198Z" },
 ]
 
 [package.optional-dependencies]
@@ -2408,15 +2409,15 @@ grpc = [
 
 [[package]]
 name = "google-auth"
-version = "2.49.1"
+version = "2.49.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "cryptography" },
     { name = "pyasn1-modules" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/ea/80/6a696a07d3d3b0a92488933532f03dbefa4a24ab80fb231395b9a2a1be77/google_auth-2.49.1.tar.gz", hash = "sha256:16d40da1c3c5a0533f57d268fe72e0ebb0ae1cc3b567024122651c045d879b64", size = 333825, upload-time = "2026-03-12T19:30:58.135Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/c6/fc/e925290a1ad95c975c459e2df070fac2b90954e13a0370ac505dff78cb99/google_auth-2.49.2.tar.gz", hash = "sha256:c1ae38500e73065dcae57355adb6278cf8b5c8e391994ae9cbadbcb9631ab409", size = 333958, upload-time = "2026-04-10T00:41:21.888Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/e9/eb/c6c2478d8a8d633460be40e2a8a6f8f429171997a35a96f81d3b680dec83/google_auth-2.49.1-py3-none-any.whl", hash = "sha256:195ebe3dca18eddd1b3db5edc5189b76c13e96f29e73043b923ebcf3f1a860f7", size = 240737, upload-time = "2026-03-12T19:30:53.159Z" },
+    { url = "https://files.pythonhosted.org/packages/73/76/d241a5c927433420507215df6cac1b1fa4ac0ba7a794df42a84326c68da8/google_auth-2.49.2-py3-none-any.whl", hash = "sha256:c2720924dfc82dedb962c9f52cabb2ab16714fd0a6a707e40561d217574ed6d5", size = 240638, upload-time = "2026-04-10T00:41:14.501Z" },
 ]
 
 [package.optional-dependencies]
@@ -2823,7 +2824,7 @@ wheels = [
 
 [[package]]
 name = "huggingface-hub"
-version = "1.9.2"
+version = "1.10.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "filelock" },
@@ -2836,9 +2837,9 @@ dependencies = [
     { name = "typer" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/cf/65/fb800d327bf25bf31b798dd08935d326d064ecb9b359059fecd91b3a98e8/huggingface_hub-1.9.2.tar.gz", hash = "sha256:8d09d080a186bd950a361bfc04b862dfb04d6a2b41d48e9ba1b37507cfd3f1e1", size = 750284, upload-time = "2026-04-08T08:43:11.127Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/e4/28/baf5d745559503ce8d28cf5bc9551f5ac59158eafd7b6a6afff0bcdb0f50/huggingface_hub-1.10.1.tar.gz", hash = "sha256:696c53cf9c2ac9befbfb5dd41d05392a031c69fc6930d1ed9671debd405b6fff", size = 758094, upload-time = "2026-04-09T15:01:18.928Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/57/d4/e33bf0b362810a9b96c5923e38908950d58ecb512db42e3730320c7f4a3a/huggingface_hub-1.9.2-py3-none-any.whl", hash = "sha256:e1e62ce237d4fbeca9f970aeb15176fbd503e04c25577bfd22f44aa7aa2b5243", size = 637349, upload-time = "2026-04-08T08:43:09.114Z" },
+    { url = "https://files.pythonhosted.org/packages/83/8c/c7a33f3efaa8d6a5bc40e012e5ecc2d72c2e6124550ca9085fe0ceed9993/huggingface_hub-1.10.1-py3-none-any.whl", hash = "sha256:6b981107a62fbe68c74374418983399c632e35786dcd14642a9f2972633c8b5a", size = 642630, upload-time = "2026-04-09T15:01:17.35Z" },
 ]
 
 [[package]]
@@ -3548,7 +3549,7 @@ sdist = { url = "https://files.pythonhosted.org/packages/0e/72/a3add0e4eec4eb9e2
 
 [[package]]
 name = "langsmith"
-version = "0.7.29"
+version = "0.7.30"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
@@ -3561,9 +3562,9 @@ dependencies = [
     { name = "xxhash" },
     { name = "zstandard" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/eb/b3/b9b2218483400c9c0f84ea781ec4fc92a9afb51c3f16d2b6369356990d47/langsmith-0.7.29.tar.gz", hash = "sha256:bcec464be00b35cdf0ed0087ef9b1f40889fe1017066f11136a02aa0276cedf5", size = 1094512, upload-time = "2026-04-09T03:17:12.961Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/46/e7/d27d952ce9824d684a3bb500a06541a2d55734bc4d849cdfcca2dfd4d93a/langsmith-0.7.30.tar.gz", hash = "sha256:d9df7ba5e42f818b63bda78776c8f2fc853388be3ae77b117e5d183a149321a2", size = 1106040, upload-time = "2026-04-09T21:12:01.892Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/aa/11/8189be47b5d5a64ecd7e19c81ad3fd9cd9f0bf6778abc5ff177db90ebb3d/langsmith-0.7.29-py3-none-any.whl", hash = "sha256:ec61cdca1f2e2add48742f97a4ee1d6894c968ef3d5a50122289dac56170978c", size = 367655, upload-time = "2026-04-09T03:17:10.944Z" },
+    { url = "https://files.pythonhosted.org/packages/37/19/96250cf58070c5563446651b03bb76c2eb5afbf08e754840ab639532d8c6/langsmith-0.7.30-py3-none-any.whl", hash = "sha256:43dd9f8d290e4d406606d6cc0bd62f5d1050963f05fe0ab6ffe50acf41f2f55a", size = 372682, upload-time = "2026-04-09T21:12:00.481Z" },
 ]
 
 [[package]]
@@ -3577,61 +3578,61 @@ wheels = [
 
 [[package]]
 name = "librt"
-version = "0.8.1"
+version = "0.9.0"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/56/9c/b4b0c54d84da4a94b37bd44151e46d5e583c9534c7e02250b961b1b6d8a8/librt-0.8.1.tar.gz", hash = "sha256:be46a14693955b3bd96014ccbdb8339ee8c9346fbe11c1b78901b55125f14c73", size = 177471, upload-time = "2026-02-17T16:13:06.101Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/eb/6b/3d5c13fb3e3c4f43206c8f9dfed13778c2ed4f000bacaa0b7ce3c402a265/librt-0.9.0.tar.gz", hash = "sha256:a0951822531e7aee6e0dfb556b30d5ee36bbe234faf60c20a16c01be3530869d", size = 184368, upload-time = "2026-04-09T16:06:26.173Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/7c/5f/63f5fa395c7a8a93558c0904ba8f1c8d1b997ca6a3de61bc7659970d66bf/librt-0.8.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:81fd938344fecb9373ba1b155968c8a329491d2ce38e7ddb76f30ffb938f12dc", size = 65697, upload-time = "2026-02-17T16:11:06.903Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/e0/0472cf37267b5920eff2f292ccfaede1886288ce35b7f3203d8de00abfe6/librt-0.8.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:5db05697c82b3a2ec53f6e72b2ed373132b0c2e05135f0696784e97d7f5d48e7", size = 68376, upload-time = "2026-02-17T16:11:08.395Z" },
-    { url = "https://files.pythonhosted.org/packages/c8/be/8bd1359fdcd27ab897cd5963294fa4a7c83b20a8564678e4fd12157e56a5/librt-0.8.1-cp310-cp310-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:d56bc4011975f7460bea7b33e1ff425d2f1adf419935ff6707273c77f8a4ada6", size = 197084, upload-time = "2026-02-17T16:11:09.774Z" },
-    { url = "https://files.pythonhosted.org/packages/e2/fe/163e33fdd091d0c2b102f8a60cc0a61fd730ad44e32617cd161e7cd67a01/librt-0.8.1-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5cdc0f588ff4b663ea96c26d2a230c525c6fc62b28314edaaaca8ed5af931ad0", size = 207337, upload-time = "2026-02-17T16:11:11.311Z" },
-    { url = "https://files.pythonhosted.org/packages/01/99/f85130582f05dcf0c8902f3d629270231d2f4afdfc567f8305a952ac7f14/librt-0.8.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:97c2b54ff6717a7a563b72627990bec60d8029df17df423f0ed37d56a17a176b", size = 219980, upload-time = "2026-02-17T16:11:12.499Z" },
-    { url = "https://files.pythonhosted.org/packages/6f/54/cb5e4d03659e043a26c74e08206412ac9a3742f0477d96f9761a55313b5f/librt-0.8.1-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:8f1125e6bbf2f1657d9a2f3ccc4a2c9b0c8b176965bb565dd4d86be67eddb4b6", size = 212921, upload-time = "2026-02-17T16:11:14.484Z" },
-    { url = "https://files.pythonhosted.org/packages/b1/81/a3a01e4240579c30f3487f6fed01eb4bc8ef0616da5b4ebac27ca19775f3/librt-0.8.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:8f4bb453f408137d7581be309b2fbc6868a80e7ef60c88e689078ee3a296ae71", size = 221381, upload-time = "2026-02-17T16:11:17.459Z" },
-    { url = "https://files.pythonhosted.org/packages/08/b0/fc2d54b4b1c6fb81e77288ff31ff25a2c1e62eaef4424a984f228839717b/librt-0.8.1-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:c336d61d2fe74a3195edc1646d53ff1cddd3a9600b09fa6ab75e5514ba4862a7", size = 216714, upload-time = "2026-02-17T16:11:19.197Z" },
-    { url = "https://files.pythonhosted.org/packages/96/96/85daa73ffbd87e1fb287d7af6553ada66bf25a2a6b0de4764344a05469f6/librt-0.8.1-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:eb5656019db7c4deacf0c1a55a898c5bb8f989be904597fcb5232a2f4828fa05", size = 214777, upload-time = "2026-02-17T16:11:20.443Z" },
-    { url = "https://files.pythonhosted.org/packages/12/9c/c3aa7a2360383f4bf4f04d98195f2739a579128720c603f4807f006a4225/librt-0.8.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:c25d9e338d5bed46c1632f851babf3d13c78f49a225462017cf5e11e845c5891", size = 237398, upload-time = "2026-02-17T16:11:22.083Z" },
-    { url = "https://files.pythonhosted.org/packages/61/19/d350ea89e5274665185dabc4bbb9c3536c3411f862881d316c8b8e00eb66/librt-0.8.1-cp310-cp310-win32.whl", hash = "sha256:aaab0e307e344cb28d800957ef3ec16605146ef0e59e059a60a176d19543d1b7", size = 54285, upload-time = "2026-02-17T16:11:23.27Z" },
-    { url = "https://files.pythonhosted.org/packages/4f/d6/45d587d3d41c112e9543a0093d883eb57a24a03e41561c127818aa2a6bcc/librt-0.8.1-cp310-cp310-win_amd64.whl", hash = "sha256:56e04c14b696300d47b3bc5f1d10a00e86ae978886d0cee14e5714fafb5df5d2", size = 61352, upload-time = "2026-02-17T16:11:24.207Z" },
-    { url = "https://files.pythonhosted.org/packages/1d/01/0e748af5e4fee180cf7cd12bd12b0513ad23b045dccb2a83191bde82d168/librt-0.8.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:681dc2451d6d846794a828c16c22dc452d924e9f700a485b7ecb887a30aad1fd", size = 65315, upload-time = "2026-02-17T16:11:25.152Z" },
-    { url = "https://files.pythonhosted.org/packages/9d/4d/7184806efda571887c798d573ca4134c80ac8642dcdd32f12c31b939c595/librt-0.8.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:a3b4350b13cc0e6f5bec8fa7caf29a8fb8cdc051a3bae45cfbfd7ce64f009965", size = 68021, upload-time = "2026-02-17T16:11:26.129Z" },
-    { url = "https://files.pythonhosted.org/packages/ae/88/c3c52d2a5d5101f28d3dc89298444626e7874aa904eed498464c2af17627/librt-0.8.1-cp311-cp311-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:ac1e7817fd0ed3d14fd7c5df91daed84c48e4c2a11ee99c0547f9f62fdae13da", size = 194500, upload-time = "2026-02-17T16:11:27.177Z" },
-    { url = "https://files.pythonhosted.org/packages/d6/5d/6fb0a25b6a8906e85b2c3b87bee1d6ed31510be7605b06772f9374ca5cb3/librt-0.8.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:747328be0c5b7075cde86a0e09d7a9196029800ba75a1689332348e998fb85c0", size = 205622, upload-time = "2026-02-17T16:11:28.242Z" },
-    { url = "https://files.pythonhosted.org/packages/b2/a6/8006ae81227105476a45691f5831499e4d936b1c049b0c1feb17c11b02d1/librt-0.8.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f0af2bd2bc204fa27f3d6711d0f360e6b8c684a035206257a81673ab924aa11e", size = 218304, upload-time = "2026-02-17T16:11:29.344Z" },
-    { url = "https://files.pythonhosted.org/packages/ee/19/60e07886ad16670aae57ef44dada41912c90906a6fe9f2b9abac21374748/librt-0.8.1-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:d480de377f5b687b6b1bc0c0407426da556e2a757633cc7e4d2e1a057aa688f3", size = 211493, upload-time = "2026-02-17T16:11:30.445Z" },
-    { url = "https://files.pythonhosted.org/packages/9c/cf/f666c89d0e861d05600438213feeb818c7514d3315bae3648b1fc145d2b6/librt-0.8.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d0ee06b5b5291f609ddb37b9750985b27bc567791bc87c76a569b3feed8481ac", size = 219129, upload-time = "2026-02-17T16:11:32.021Z" },
-    { url = "https://files.pythonhosted.org/packages/8f/ef/f1bea01e40b4a879364c031476c82a0dc69ce068daad67ab96302fed2d45/librt-0.8.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:9e2c6f77b9ad48ce5603b83b7da9ee3e36b3ab425353f695cba13200c5d96596", size = 213113, upload-time = "2026-02-17T16:11:33.192Z" },
-    { url = "https://files.pythonhosted.org/packages/9b/80/cdab544370cc6bc1b72ea369525f547a59e6938ef6863a11ab3cd24759af/librt-0.8.1-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:439352ba9373f11cb8e1933da194dcc6206daf779ff8df0ed69c5e39113e6a99", size = 212269, upload-time = "2026-02-17T16:11:34.373Z" },
-    { url = "https://files.pythonhosted.org/packages/9d/9c/48d6ed8dac595654f15eceab2035131c136d1ae9a1e3548e777bb6dbb95d/librt-0.8.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:82210adabbc331dbb65d7868b105185464ef13f56f7f76688565ad79f648b0fe", size = 234673, upload-time = "2026-02-17T16:11:36.063Z" },
-    { url = "https://files.pythonhosted.org/packages/16/01/35b68b1db517f27a01be4467593292eb5315def8900afad29fabf56304ba/librt-0.8.1-cp311-cp311-win32.whl", hash = "sha256:52c224e14614b750c0a6d97368e16804a98c684657c7518752c356834fff83bb", size = 54597, upload-time = "2026-02-17T16:11:37.544Z" },
-    { url = "https://files.pythonhosted.org/packages/71/02/796fe8f02822235966693f257bf2c79f40e11337337a657a8cfebba5febc/librt-0.8.1-cp311-cp311-win_amd64.whl", hash = "sha256:c00e5c884f528c9932d278d5c9cbbea38a6b81eb62c02e06ae53751a83a4d52b", size = 61733, upload-time = "2026-02-17T16:11:38.691Z" },
-    { url = "https://files.pythonhosted.org/packages/28/ad/232e13d61f879a42a4e7117d65e4984bb28371a34bb6fb9ca54ec2c8f54e/librt-0.8.1-cp311-cp311-win_arm64.whl", hash = "sha256:f7cdf7f26c2286ffb02e46d7bac56c94655540b26347673bea15fa52a6af17e9", size = 52273, upload-time = "2026-02-17T16:11:40.308Z" },
-    { url = "https://files.pythonhosted.org/packages/95/21/d39b0a87ac52fc98f621fb6f8060efb017a767ebbbac2f99fbcbc9ddc0d7/librt-0.8.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:a28f2612ab566b17f3698b0da021ff9960610301607c9a5e8eaca62f5e1c350a", size = 66516, upload-time = "2026-02-17T16:11:41.604Z" },
-    { url = "https://files.pythonhosted.org/packages/69/f1/46375e71441c43e8ae335905e069f1c54febee63a146278bcee8782c84fd/librt-0.8.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:60a78b694c9aee2a0f1aaeaa7d101cf713e92e8423a941d2897f4fa37908dab9", size = 68634, upload-time = "2026-02-17T16:11:43.268Z" },
-    { url = "https://files.pythonhosted.org/packages/0a/33/c510de7f93bf1fa19e13423a606d8189a02624a800710f6e6a0a0f0784b3/librt-0.8.1-cp312-cp312-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:758509ea3f1eba2a57558e7e98f4659d0ea7670bff49673b0dde18a3c7e6c0eb", size = 198941, upload-time = "2026-02-17T16:11:44.28Z" },
-    { url = "https://files.pythonhosted.org/packages/dd/36/e725903416409a533d92398e88ce665476f275081d0d7d42f9c4951999e5/librt-0.8.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:039b9f2c506bd0ab0f8725aa5ba339c6f0cd19d3b514b50d134789809c24285d", size = 209991, upload-time = "2026-02-17T16:11:45.462Z" },
-    { url = "https://files.pythonhosted.org/packages/30/7a/8d908a152e1875c9f8eac96c97a480df425e657cdb47854b9efaa4998889/librt-0.8.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5bb54f1205a3a6ab41a6fd71dfcdcbd278670d3a90ca502a30d9da583105b6f7", size = 224476, upload-time = "2026-02-17T16:11:46.542Z" },
-    { url = "https://files.pythonhosted.org/packages/a8/b8/a22c34f2c485b8903a06f3fe3315341fe6876ef3599792344669db98fcff/librt-0.8.1-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:05bd41cdee35b0c59c259f870f6da532a2c5ca57db95b5f23689fcb5c9e42440", size = 217518, upload-time = "2026-02-17T16:11:47.746Z" },
-    { url = "https://files.pythonhosted.org/packages/79/6f/5c6fea00357e4f82ba44f81dbfb027921f1ab10e320d4a64e1c408d035d9/librt-0.8.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:adfab487facf03f0d0857b8710cf82d0704a309d8ffc33b03d9302b4c64e91a9", size = 225116, upload-time = "2026-02-17T16:11:49.298Z" },
-    { url = "https://files.pythonhosted.org/packages/f2/a0/95ced4e7b1267fe1e2720a111685bcddf0e781f7e9e0ce59d751c44dcfe5/librt-0.8.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:153188fe98a72f206042be10a2c6026139852805215ed9539186312d50a8e972", size = 217751, upload-time = "2026-02-17T16:11:50.49Z" },
-    { url = "https://files.pythonhosted.org/packages/93/c2/0517281cb4d4101c27ab59472924e67f55e375bc46bedae94ac6dc6e1902/librt-0.8.1-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:dd3c41254ee98604b08bd5b3af5bf0a89740d4ee0711de95b65166bf44091921", size = 218378, upload-time = "2026-02-17T16:11:51.783Z" },
-    { url = "https://files.pythonhosted.org/packages/43/e8/37b3ac108e8976888e559a7b227d0ceac03c384cfd3e7a1c2ee248dbae79/librt-0.8.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:e0d138c7ae532908cbb342162b2611dbd4d90c941cd25ab82084aaf71d2c0bd0", size = 241199, upload-time = "2026-02-17T16:11:53.561Z" },
-    { url = "https://files.pythonhosted.org/packages/4b/5b/35812d041c53967fedf551a39399271bbe4257e681236a2cf1a69c8e7fa1/librt-0.8.1-cp312-cp312-win32.whl", hash = "sha256:43353b943613c5d9c49a25aaffdba46f888ec354e71e3529a00cca3f04d66a7a", size = 54917, upload-time = "2026-02-17T16:11:54.758Z" },
-    { url = "https://files.pythonhosted.org/packages/de/d1/fa5d5331b862b9775aaf2a100f5ef86854e5d4407f71bddf102f4421e034/librt-0.8.1-cp312-cp312-win_amd64.whl", hash = "sha256:ff8baf1f8d3f4b6b7257fcb75a501f2a5499d0dda57645baa09d4d0d34b19444", size = 62017, upload-time = "2026-02-17T16:11:55.748Z" },
-    { url = "https://files.pythonhosted.org/packages/c7/7c/c614252f9acda59b01a66e2ddfd243ed1c7e1deab0293332dfbccf862808/librt-0.8.1-cp312-cp312-win_arm64.whl", hash = "sha256:0f2ae3725904f7377e11cc37722d5d401e8b3d5851fb9273d7f4fe04f6b3d37d", size = 52441, upload-time = "2026-02-17T16:11:56.801Z" },
-    { url = "https://files.pythonhosted.org/packages/c5/3c/f614c8e4eaac7cbf2bbdf9528790b21d89e277ee20d57dc6e559c626105f/librt-0.8.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:7e6bad1cd94f6764e1e21950542f818a09316645337fd5ab9a7acc45d99a8f35", size = 66529, upload-time = "2026-02-17T16:11:57.809Z" },
-    { url = "https://files.pythonhosted.org/packages/ab/96/5836544a45100ae411eda07d29e3d99448e5258b6e9c8059deb92945f5c2/librt-0.8.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:cf450f498c30af55551ba4f66b9123b7185362ec8b625a773b3d39aa1a717583", size = 68669, upload-time = "2026-02-17T16:11:58.843Z" },
-    { url = "https://files.pythonhosted.org/packages/06/53/f0b992b57af6d5531bf4677d75c44f095f2366a1741fb695ee462ae04b05/librt-0.8.1-cp313-cp313-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:eca45e982fa074090057132e30585a7e8674e9e885d402eae85633e9f449ce6c", size = 199279, upload-time = "2026-02-17T16:11:59.862Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/ad/4848cc16e268d14280d8168aee4f31cea92bbd2b79ce33d3e166f2b4e4fc/librt-0.8.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0c3811485fccfda840861905b8c70bba5ec094e02825598bb9d4ca3936857a04", size = 210288, upload-time = "2026-02-17T16:12:00.954Z" },
-    { url = "https://files.pythonhosted.org/packages/52/05/27fdc2e95de26273d83b96742d8d3b7345f2ea2bdbd2405cc504644f2096/librt-0.8.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5e4af413908f77294605e28cfd98063f54b2c790561383971d2f52d113d9c363", size = 224809, upload-time = "2026-02-17T16:12:02.108Z" },
-    { url = "https://files.pythonhosted.org/packages/7a/d0/78200a45ba3240cb042bc597d6f2accba9193a2c57d0356268cbbe2d0925/librt-0.8.1-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:5212a5bd7fae98dae95710032902edcd2ec4dc994e883294f75c857b83f9aba0", size = 218075, upload-time = "2026-02-17T16:12:03.631Z" },
-    { url = "https://files.pythonhosted.org/packages/af/72/a210839fa74c90474897124c064ffca07f8d4b347b6574d309686aae7ca6/librt-0.8.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:e692aa2d1d604e6ca12d35e51fdc36f4cda6345e28e36374579f7ef3611b3012", size = 225486, upload-time = "2026-02-17T16:12:04.725Z" },
-    { url = "https://files.pythonhosted.org/packages/a3/c1/a03cc63722339ddbf087485f253493e2b013039f5b707e8e6016141130fa/librt-0.8.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:4be2a5c926b9770c9e08e717f05737a269b9d0ebc5d2f0060f0fe3fe9ce47acb", size = 218219, upload-time = "2026-02-17T16:12:05.828Z" },
-    { url = "https://files.pythonhosted.org/packages/58/f5/fff6108af0acf941c6f274a946aea0e484bd10cd2dc37610287ce49388c5/librt-0.8.1-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:fd1a720332ea335ceb544cf0a03f81df92abd4bb887679fd1e460976b0e6214b", size = 218750, upload-time = "2026-02-17T16:12:07.09Z" },
-    { url = "https://files.pythonhosted.org/packages/71/67/5a387bfef30ec1e4b4f30562c8586566faf87e47d696768c19feb49e3646/librt-0.8.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:93c2af9e01e0ef80d95ae3c720be101227edae5f2fe7e3dc63d8857fadfc5a1d", size = 241624, upload-time = "2026-02-17T16:12:08.43Z" },
-    { url = "https://files.pythonhosted.org/packages/d4/be/24f8502db11d405232ac1162eb98069ca49c3306c1d75c6ccc61d9af8789/librt-0.8.1-cp313-cp313-win32.whl", hash = "sha256:086a32dbb71336627e78cc1d6ee305a68d038ef7d4c39aaff41ae8c9aa46e91a", size = 54969, upload-time = "2026-02-17T16:12:09.633Z" },
-    { url = "https://files.pythonhosted.org/packages/5c/73/c9fdf6cb2a529c1a092ce769a12d88c8cca991194dfe641b6af12fa964d2/librt-0.8.1-cp313-cp313-win_amd64.whl", hash = "sha256:e11769a1dbda4da7b00a76cfffa67aa47cfa66921d2724539eee4b9ede780b79", size = 62000, upload-time = "2026-02-17T16:12:10.632Z" },
-    { url = "https://files.pythonhosted.org/packages/d3/97/68f80ca3ac4924f250cdfa6e20142a803e5e50fca96ef5148c52ee8c10ea/librt-0.8.1-cp313-cp313-win_arm64.whl", hash = "sha256:924817ab3141aca17893386ee13261f1d100d1ef410d70afe4389f2359fea4f0", size = 52495, upload-time = "2026-02-17T16:12:11.633Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/4a/c64265d71b84030174ff3ac2cd16d8b664072afab8c41fccd8e2ee5a6f8d/librt-0.9.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:2f8e12706dcb8ff6b3ed57514a19e45c49ad00bcd423e87b2b2e4b5f64578443", size = 67529, upload-time = "2026-04-09T16:04:27.373Z" },
+    { url = "https://files.pythonhosted.org/packages/23/b1/30ca0b3a8bdac209a00145c66cf42e5e7da2cc056ffc6ebc5c7b430ddd34/librt-0.9.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:4e3dda8345307fd7306db0ed0cb109a63a2c85ba780eb9dc2d09b2049a931f9c", size = 70248, upload-time = "2026-04-09T16:04:28.758Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/fc/c6018dc181478d6ac5aa24a5846b8185101eb90894346db239eb3ea53209/librt-0.9.0-cp310-cp310-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:de7dac64e3eb832ffc7b840eb8f52f76420cde1b845be51b2a0f6b870890645e", size = 202184, upload-time = "2026-04-09T16:04:29.893Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/58/d69629f002203370ef41ea69ff71c49a2c618aec39b226ff49986ecd8623/librt-0.9.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:22a904cbdb678f7cb348c90d543d3c52f581663d687992fee47fd566dcbf5285", size = 212926, upload-time = "2026-04-09T16:04:31.126Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/55/01d859f57824e42bd02465c77bec31fa5ef9d8c2bcee702ccf8ef1b9f508/librt-0.9.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:224b9727eb8bc188bc3bcf29d969dba0cd61b01d9bac80c41575520cc4baabb2", size = 225664, upload-time = "2026-04-09T16:04:32.352Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/02/32f63ad0ef085a94a70315291efe1151a48b9947af12261882f8445b2a30/librt-0.9.0-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e94cbc6ad9a6aeea46d775cbb11f361022f778a9cc8cc90af653d3a594b057ce", size = 219534, upload-time = "2026-04-09T16:04:33.667Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/5a/9d77111a183c885acf3b3b6e4c00f5b5b07b5817028226499a55f1fedc59/librt-0.9.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:7bc30ad339f4e1a01d4917d645e522a0bc0030644d8973f6346397c93ba1503f", size = 227322, upload-time = "2026-04-09T16:04:34.945Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/e7/05d700c93063753e12ab230b972002a3f8f3b9c95d8a980c2f646c8b6963/librt-0.9.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:56d65b583cf43b8cf4c8fbe1e1da20fa3076cc32a1149a141507af1062718236", size = 223407, upload-time = "2026-04-09T16:04:36.22Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/26/26c3124823c67c987456977c683da9a27cc874befc194ddcead5f9988425/librt-0.9.0-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:0a1be03168b2691ba61927e299b352a6315189199ca18a57b733f86cb3cc8d38", size = 221302, upload-time = "2026-04-09T16:04:37.62Z" },
+    { url = "https://files.pythonhosted.org/packages/50/2b/c7cc2be5cf4ff7b017d948a789256288cb33a517687ff1995e72a7eea79f/librt-0.9.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:63c12efcd160e1d14da11af0c46c0217473e1e0d2ae1acbccc83f561ea4c2a7b", size = 243893, upload-time = "2026-04-09T16:04:38.909Z" },
+    { url = "https://files.pythonhosted.org/packages/62/d3/da553d37417a337d12660450535d5fd51373caffbedf6962173c87867246/librt-0.9.0-cp310-cp310-win32.whl", hash = "sha256:e9002e98dcb1c0a66723592520decd86238ddcef168b37ff6cfb559200b4b774", size = 55375, upload-time = "2026-04-09T16:04:40.148Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/5a/46fa357bab8311b6442a83471591f2f9e5b15ecc1d2121a43725e0c529b8/librt-0.9.0-cp310-cp310-win_amd64.whl", hash = "sha256:9fcb461fbf70654a52a7cc670e606f04449e2374c199b1825f754e16dacfedd8", size = 62581, upload-time = "2026-04-09T16:04:41.452Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/1e/2ec7afcebcf3efea593d13aee18bbcfdd3a243043d848ebf385055e9f636/librt-0.9.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:90904fac73c478f4b83f4ed96c99c8208b75e6f9a8a1910548f69a00f1eaa671", size = 67155, upload-time = "2026-04-09T16:04:42.933Z" },
+    { url = "https://files.pythonhosted.org/packages/18/77/72b85afd4435268338ad4ec6231b3da8c77363f212a0227c1ff3b45e4d35/librt-0.9.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:789fff71757facc0738e8d89e3b84e4f0251c1c975e85e81b152cdaca927cc2d", size = 69916, upload-time = "2026-04-09T16:04:44.042Z" },
+    { url = "https://files.pythonhosted.org/packages/27/fb/948ea0204fbe2e78add6d46b48330e58d39897e425560674aee302dca81c/librt-0.9.0-cp311-cp311-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:1bf465d1e5b0a27713862441f6467b5ab76385f4ecf8f1f3a44f8aa3c695b4b6", size = 199635, upload-time = "2026-04-09T16:04:45.5Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/cd/894a29e251b296a27957856804cfd21e93c194aa131de8bb8032021be07e/librt-0.9.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f819e0c6413e259a17a7c0d49f97f405abadd3c2a316a3b46c6440b7dbbedbb1", size = 211051, upload-time = "2026-04-09T16:04:47.016Z" },
+    { url = "https://files.pythonhosted.org/packages/18/8f/dcaed0bc084a35f3721ff2d081158db569d2c57ea07d35623ddaca5cfc8e/librt-0.9.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e0785c2fb4a81e1aece366aa3e2e039f4a4d7d21aaaded5227d7f3c703427882", size = 224031, upload-time = "2026-04-09T16:04:48.207Z" },
+    { url = "https://files.pythonhosted.org/packages/03/44/88f6c1ed1132cd418601cc041fbd92fed28b3a09f39de81978e0822d13ff/librt-0.9.0-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:80b25c7b570a86c03b5da69e665809deb39265476e8e21d96a9328f9762f9990", size = 218069, upload-time = "2026-04-09T16:04:50.025Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/90/7d02e981c2db12188d82b4410ff3e35bfdb844b26aecd02233626f46af2b/librt-0.9.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d4d16b608a1c43d7e33142099a75cd93af482dadce0bf82421e91cad077157f4", size = 224857, upload-time = "2026-04-09T16:04:51.684Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/c3/c77e706b7215ca32e928d47535cf13dbc3d25f096f84ddf8fbc06693e229/librt-0.9.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:194fc1a32e1e21fe809d38b5faea66cc65eaa00217c8901fbdb99866938adbdb", size = 219865, upload-time = "2026-04-09T16:04:52.949Z" },
+    { url = "https://files.pythonhosted.org/packages/52/d1/32b0c1a0eb8461c70c11656c46a29f760b7c7edf3c36d6f102470c17170f/librt-0.9.0-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:8c6bc1384d9738781cfd41d09ad7f6e8af13cfea2c75ece6bd6d2566cdea2076", size = 218451, upload-time = "2026-04-09T16:04:54.174Z" },
+    { url = "https://files.pythonhosted.org/packages/74/d1/adfd0f9c44761b1d49b1bec66173389834c33ee2bd3c7fd2e2367f1942d4/librt-0.9.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:15cb151e52a044f06e54ac7f7b47adbfc89b5c8e2b63e1175a9d587c43e8942a", size = 241300, upload-time = "2026-04-09T16:04:55.452Z" },
+    { url = "https://files.pythonhosted.org/packages/09/b0/9074b64407712f0003c27f5b1d7655d1438979155f049720e8a1abd9b1a1/librt-0.9.0-cp311-cp311-win32.whl", hash = "sha256:f100bfe2acf8a3689af9d0cc660d89f17286c9c795f9f18f7b62dd1a6b247ae6", size = 55668, upload-time = "2026-04-09T16:04:56.689Z" },
+    { url = "https://files.pythonhosted.org/packages/24/19/40b77b77ce80b9389fb03971431b09b6b913911c38d412059e0b3e2a9ef2/librt-0.9.0-cp311-cp311-win_amd64.whl", hash = "sha256:0b73e4266307e51c95e09c0750b7ec383c561d2e97d58e473f6f6a209952fbb8", size = 62976, upload-time = "2026-04-09T16:04:57.733Z" },
+    { url = "https://files.pythonhosted.org/packages/70/9d/9fa7a64041e29035cb8c575af5f0e3840be1b97b4c4d9061e0713f171849/librt-0.9.0-cp311-cp311-win_arm64.whl", hash = "sha256:bc5518873822d2faa8ebdd2c1a4d7c8ef47b01a058495ab7924cb65bdbf5fc9a", size = 53502, upload-time = "2026-04-09T16:04:58.806Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/90/89ddba8e1c20b0922783cd93ed8e64f34dc05ab59c38a9c7e313632e20ff/librt-0.9.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:9b3e3bc363f71bda1639a4ee593cb78f7fbfeacc73411ec0d4c92f00730010a4", size = 68332, upload-time = "2026-04-09T16:05:00.09Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/40/7aa4da1fb08bdeeb540cb07bfc8207cb32c5c41642f2594dbd0098a0662d/librt-0.9.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:0a09c2f5869649101738653a9b7ab70cf045a1105ac66cbb8f4055e61df78f2d", size = 70581, upload-time = "2026-04-09T16:05:01.213Z" },
+    { url = "https://files.pythonhosted.org/packages/48/ac/73a2187e1031041e93b7e3a25aae37aa6f13b838c550f7e0f06f66766212/librt-0.9.0-cp312-cp312-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:5ca8e133d799c948db2ab1afc081c333a825b5540475164726dcbf73537e5c2f", size = 203984, upload-time = "2026-04-09T16:05:02.542Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/3d/23460d571e9cbddb405b017681df04c142fb1b04cbfce77c54b08e28b108/librt-0.9.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:603138ee838ee1583f1b960b62d5d0007845c5c423feb68e44648b1359014e27", size = 215762, upload-time = "2026-04-09T16:05:04.127Z" },
+    { url = "https://files.pythonhosted.org/packages/de/1e/42dc7f8ab63e65b20640d058e63e97fd3e482c1edbda3570d813b4d0b927/librt-0.9.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f4003f70c56a5addd6aa0897f200dd59afd3bf7bcd5b3cce46dd21f925743bc2", size = 230288, upload-time = "2026-04-09T16:05:05.883Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/08/ca812b6d8259ad9ece703397f8ad5c03af5b5fedfce64279693d3ce4087c/librt-0.9.0-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:78042f6facfd98ecb25e9829c7e37cce23363d9d7c83bc5f72702c5059eb082b", size = 224103, upload-time = "2026-04-09T16:05:07.148Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/3f/620490fb2fa66ffd44e7f900254bc110ebec8dac6c1b7514d64662570e6f/librt-0.9.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:a361c9434a64d70a7dbb771d1de302c0cc9f13c0bffe1cf7e642152814b35265", size = 232122, upload-time = "2026-04-09T16:05:08.386Z" },
+    { url = "https://files.pythonhosted.org/packages/e9/83/12864700a1b6a8be458cf5d05db209b0d8e94ae281e7ec261dbe616597b4/librt-0.9.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:dd2c7e082b0b92e1baa4da28163a808672485617bc855cc22a2fd06978fa9084", size = 225045, upload-time = "2026-04-09T16:05:09.707Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/1b/845d339c29dc7dbc87a2e992a1ba8d28d25d0e0372f9a0a2ecebde298186/librt-0.9.0-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:7e6274fd33fc5b2a14d41c9119629d3ff395849d8bcbc80cf637d9e8d2034da8", size = 227372, upload-time = "2026-04-09T16:05:10.942Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/fe/277985610269d926a64c606f761d58d3db67b956dbbf40024921e95e7fcb/librt-0.9.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:5093043afb226ecfa1400120d1ebd4442b4f99977783e4f4f7248879009b227f", size = 248224, upload-time = "2026-04-09T16:05:12.254Z" },
+    { url = "https://files.pythonhosted.org/packages/92/1b/ee486d244b8de6b8b5dbaefabe6bfdd4a72e08f6353edf7d16d27114da8d/librt-0.9.0-cp312-cp312-win32.whl", hash = "sha256:9edcc35d1cae9fd5320171b1a838c7da8a5c968af31e82ecc3dff30b4be0957f", size = 55986, upload-time = "2026-04-09T16:05:13.529Z" },
+    { url = "https://files.pythonhosted.org/packages/89/7a/ba1737012308c17dc6d5516143b5dce9a2c7ba3474afd54e11f44a4d1ef3/librt-0.9.0-cp312-cp312-win_amd64.whl", hash = "sha256:3cc2917258e131ae5f958a4d872e07555b51cb7466a43433218061c74ef33745", size = 63260, upload-time = "2026-04-09T16:05:14.68Z" },
+    { url = "https://files.pythonhosted.org/packages/36/e4/01752c113da15127f18f7bf11142f5640038f062407a611c059d0036c6aa/librt-0.9.0-cp312-cp312-win_arm64.whl", hash = "sha256:90e6d5420fc8a300518d4d2288154ff45005e920425c22cbbfe8330f3f754bd9", size = 53694, upload-time = "2026-04-09T16:05:16.095Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/d7/1b3e26fffde1452d82f5666164858a81c26ebe808e7ae8c9c88628981540/librt-0.9.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:f29b68cd9714531672db62cc54f6e8ff981900f824d13fa0e00749189e13778e", size = 68367, upload-time = "2026-04-09T16:05:17.243Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/5b/c61b043ad2e091fbe1f2d35d14795e545d0b56b03edaa390fa1dcee3d160/librt-0.9.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:7d5c8a5929ac325729f6119802070b561f4db793dffc45e9ac750992a4ed4d22", size = 70595, upload-time = "2026-04-09T16:05:18.471Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/22/2448471196d8a73370aa2f23445455dc42712c21404081fcd7a03b9e0749/librt-0.9.0-cp313-cp313-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:756775d25ec8345b837ab52effee3ad2f3b2dfd6bbee3e3f029c517bd5d8f05a", size = 204354, upload-time = "2026-04-09T16:05:19.593Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/5e/39fc4b153c78cfd2c8a2dcb32700f2d41d2312aa1050513183be4540930d/librt-0.9.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2b8f5d00b49818f4e2b1667db994488b045835e0ac16fe2f924f3871bd2b8ac5", size = 216238, upload-time = "2026-04-09T16:05:20.868Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/42/bc2d02d0fa7badfa63aa8d6dcd8793a9f7ef5a94396801684a51ed8d8287/librt-0.9.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c81aef782380f0f13ead670aae01825eb653b44b046aa0e5ebbb79f76ed4aa11", size = 230589, upload-time = "2026-04-09T16:05:22.305Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/7b/e2d95cc513866373692aa5edf98080d5602dd07cabfb9e5d2f70df2f25f7/librt-0.9.0-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:66b58fed90a545328e80d575467244de3741e088c1af928f0b489ebec3ef3858", size = 224610, upload-time = "2026-04-09T16:05:23.647Z" },
+    { url = "https://files.pythonhosted.org/packages/31/d5/6cec4607e998eaba57564d06a1295c21b0a0c8de76e4e74d699e627bd98c/librt-0.9.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:e78fb7419e07d98c2af4b8567b72b3eaf8cb05caad642e9963465569c8b2d87e", size = 232558, upload-time = "2026-04-09T16:05:25.025Z" },
+    { url = "https://files.pythonhosted.org/packages/95/8c/27f1d8d3aaf079d3eb26439bf0b32f1482340c3552e324f7db9dca858671/librt-0.9.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:2c3786f0f4490a5cd87f1ed6cefae833ad6b1060d52044ce0434a2e85893afd0", size = 225521, upload-time = "2026-04-09T16:05:26.311Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/d8/1e0d43b1c329b416017619469b3c3801a25a6a4ef4a1c68332aeaa6f72ca/librt-0.9.0-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:8494cfc61e03542f2d381e71804990b3931175a29b9278fdb4a5459948778dc2", size = 227789, upload-time = "2026-04-09T16:05:27.624Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/b4/d3d842e88610fcd4c8eec7067b0c23ef2d7d3bff31496eded6a83b0f99be/librt-0.9.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:07cf11f769831186eeac424376e6189f20ace4f7263e2134bdb9757340d84d4d", size = 248616, upload-time = "2026-04-09T16:05:29.181Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/28/527df8ad0d1eb6c8bdfa82fc190f1f7c4cca5a1b6d7b36aeabf95b52d74d/librt-0.9.0-cp313-cp313-win32.whl", hash = "sha256:850d6d03177e52700af605fd60db7f37dcb89782049a149674d1a9649c2138fd", size = 56039, upload-time = "2026-04-09T16:05:30.709Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/a7/413652ad0d92273ee5e30c000fc494b361171177c83e57c060ecd3c21538/librt-0.9.0-cp313-cp313-win_amd64.whl", hash = "sha256:a5af136bfba820d592f86c67affcef9b3ff4d4360ac3255e341e964489b48519", size = 63264, upload-time = "2026-04-09T16:05:31.881Z" },
+    { url = "https://files.pythonhosted.org/packages/a4/0a/92c244309b774e290ddb15e93363846ae7aa753d9586b8aad511c5e6145b/librt-0.9.0-cp313-cp313-win_arm64.whl", hash = "sha256:4c4d0440a3a8e31d962340c3e1cc3fc9ee7febd34c8d8f770d06adb947779ea5", size = 53728, upload-time = "2026-04-09T16:05:33.31Z" },
 ]
 
 [[package]]
@@ -4210,11 +4211,11 @@ wheels = [
 
 [[package]]
 name = "more-itertools"
-version = "11.0.1"
+version = "11.0.2"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/24/24/e0acc4bf54cba50c1d432c70a72a3df96db4a321b2c4c68432a60759044f/more_itertools-11.0.1.tar.gz", hash = "sha256:fefaf25b7ab08f0b45fa9f1892cae93b9fc0089ef034d39213bce15f1cc9e199", size = 144739, upload-time = "2026-04-02T16:17:45.061Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/a2/f7/139d22fef48ac78127d18e01d80cf1be40236ae489769d17f35c3d425293/more_itertools-11.0.2.tar.gz", hash = "sha256:392a9e1e362cbc106a2457d37cabf9b36e5e12efd4ebff1654630e76597df804", size = 144659, upload-time = "2026-04-09T15:01:33.297Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/d8/f4/5e52c7319b8087acef603ed6e50dc325c02eaa999355414830468611f13c/more_itertools-11.0.1-py3-none-any.whl", hash = "sha256:eaf287826069452a8f61026c597eae2428b2d1ba2859083abbf240b46842ce6d", size = 72182, upload-time = "2026-04-02T16:17:43.724Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/98/6af411189d9413534c3eb691182bff1f5c6d44ed2f93f2edfe52a1bbceb8/more_itertools-11.0.2-py3-none-any.whl", hash = "sha256:6e35b35f818b01f691643c6c611bc0902f2e92b46c18fffa77ae1e7c46e912e4", size = 71939, upload-time = "2026-04-09T15:01:32.21Z" },
 ]
 
 [[package]]
@@ -7382,14 +7383,14 @@ wheels = [
 
 [[package]]
 name = "s3transfer"
-version = "0.14.0"
+version = "0.16.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "botocore" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/62/74/8d69dcb7a9efe8baa2046891735e5dfe433ad558ae23d9e3c14c633d1d58/s3transfer-0.14.0.tar.gz", hash = "sha256:eff12264e7c8b4985074ccce27a3b38a485bb7f7422cc8046fee9be4983e4125", size = 151547, upload-time = "2025-09-09T19:23:31.089Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/05/04/74127fc843314818edfa81b5540e26dd537353b123a4edc563109d8f17dd/s3transfer-0.16.0.tar.gz", hash = "sha256:8e990f13268025792229cd52fa10cb7163744bf56e719e0b9cb925ab79abf920", size = 153827, upload-time = "2025-12-01T02:30:59.114Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/48/f0/ae7ca09223a81a1d890b2557186ea015f6e0502e9b8cb8e1813f1d8cfa4e/s3transfer-0.14.0-py3-none-any.whl", hash = "sha256:ea3b790c7077558ed1f02a3072fb3cb992bbbd253392f4b6e9e8976941c7d456", size = 85712, upload-time = "2025-09-09T19:23:30.041Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/51/727abb13f44c1fcf6d145979e1535a35794db0f6e450a0cb46aa24732fe2/s3transfer-0.16.0-py3-none-any.whl", hash = "sha256:18e25d66fed509e3868dc1572b3f427ff947dd2c56f844a5bf09481ad3f3b2fe", size = 86830, upload-time = "2025-12-01T02:30:57.729Z" },
 ]
 
 [[package]]
@@ -7564,7 +7565,7 @@ wheels = [
 
 [[package]]
 name = "scrapfly-sdk"
-version = "0.8.27"
+version = "0.8.28"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "backoff" },
@@ -7574,14 +7575,14 @@ dependencies = [
     { name = "requests" },
     { name = "urllib3" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/fb/49/c9c13113630ea38653b784f3511779e191152aa6afb44cf7e148d99ad345/scrapfly_sdk-0.8.27.tar.gz", hash = "sha256:affce316fecfabe444685779fc61b28a9e7a36344819701339637a96272831c6", size = 82753, upload-time = "2026-02-26T19:00:32.638Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/7b/3e/a881968b866ed77cb8a5013aeb100a5a3dd2b502e9a9f955615e15157ad0/scrapfly_sdk-0.8.28.tar.gz", hash = "sha256:051f734ae10fd9b136527f3dc3344abb68ed64822c108b1caff6dc8399c197e0", size = 104208, upload-time = "2026-04-09T16:18:51.793Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/70/9a/f9367c504710f0fc06654adef079b3e020318bf0c6beccb8291ecf26b9fe/scrapfly_sdk-0.8.27-py3-none-any.whl", hash = "sha256:c0cb76fd65e95a6221b3f4531af363f2dcd2dc2e5b18641be9554bb2f60e001c", size = 95229, upload-time = "2026-02-26T19:00:31.227Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/c6/97a5fbc9ff952c45783303add4c4e431b7a34a020f6dc3adb8f878af0c2a/scrapfly_sdk-0.8.28-py3-none-any.whl", hash = "sha256:116198df90cdbea224d6b0c92d4d74c9ee585fa63c1c5ec9f021b5fc9638fe3f", size = 117920, upload-time = "2026-04-09T16:18:50.356Z" },
 ]
 
 [[package]]
 name = "selenium"
-version = "4.41.0"
+version = "4.42.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "certifi" },
@@ -7591,9 +7592,9 @@ dependencies = [
     { name = "urllib3" },
     { name = "websocket-client" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/04/7c/133d00d6d013a17d3f39199f27f1a780ec2e95d7b9aa997dc1b8ac2e62a7/selenium-4.41.0.tar.gz", hash = "sha256:003e971f805231ad63e671783a2b91a299355d10cefb9de964c36ff3819115aa", size = 937872, upload-time = "2026-02-20T03:42:06.216Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/33/46/fb93d37749ecf13853739c31c70bd95704310a7defbc57e7101dc4ab2513/selenium-4.42.0.tar.gz", hash = "sha256:4c8ebd84ff96505db4277223648f12e2799e92e13169bc69633a6b24eb066c72", size = 956304, upload-time = "2026-04-09T08:31:20.268Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a8/d6/e4160989ef6b272779af6f3e5c43c3ba9be6687bdc21c68c3fb220e555b3/selenium-4.41.0-py3-none-any.whl", hash = "sha256:b8ccde8d2e7642221ca64af184a92c19eee6accf2e27f20f30472f5efae18eb1", size = 9532858, upload-time = "2026-02-20T03:42:03.218Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/47/9f094f1cffdb54b01da75b45cc29673869458a504b30002797c0c47ac985/selenium-4.42.0-py3-none-any.whl", hash = "sha256:bb29eababf54fa479c95d5fa3fba73889db5d532f3a76addc5b526bbff14fca7", size = 9559171, upload-time = "2026-04-09T08:31:17.38Z" },
 ]
 
 [[package]]
@@ -8254,7 +8255,7 @@ wheels = [
 
 [[package]]
 name = "transformers"
-version = "5.5.0"
+version = "5.5.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "huggingface-hub" },
@@ -8268,9 +8269,9 @@ dependencies = [
     { name = "tqdm" },
     { name = "typer" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/ff/9d/fb46e729b461985f41a5740167688b924a4019141e5c164bea77548d3d9e/transformers-5.5.0.tar.gz", hash = "sha256:c8db656cf51c600cd8c75f06b20ef85c72e8b8ff9abc880c5d3e8bc70e0ddcbd", size = 8237745, upload-time = "2026-04-02T16:13:08.113Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/af/35/cd5b0d1288e65d2c12db4ce84c1ec1074f7ee9bced040de6c9d69e70d620/transformers-5.5.3.tar.gz", hash = "sha256:3f60128e840b40d352655903552e1eed4f94ed49369a4d43e1bc067bd32d3f50", size = 8226047, upload-time = "2026-04-09T15:52:56.231Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/e7/28/35f7411ff80a3640c1f4fc907dcbb6a65061ebb82f66950e38bfc9f7f740/transformers-5.5.0-py3-none-any.whl", hash = "sha256:821a9ff0961abbb29eb1eb686d78df1c85929fdf213a3fe49dc6bd94f9efa944", size = 10245591, upload-time = "2026-04-02T16:13:03.462Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/0b/f8524551ab2d896dfaca74ddb70a4453d515bbf4ab5451c100c7788ae155/transformers-5.5.3-py3-none-any.whl", hash = "sha256:e48f3ec31dd96505e96e66b63a1e43e1ad7a65749e108d9227caaf51051cdb02", size = 10236257, upload-time = "2026-04-09T15:52:52.866Z" },
 ]
 
 [[package]]
@@ -8626,7 +8627,8 @@ all-docs = [
     { name = "pypdf" },
     { name = "python-docx" },
     { name = "python-pptx" },
-    { name = "unstructured-inference" },
+    { name = "unstructured-inference", version = "1.2.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.12'" },
+    { name = "unstructured-inference", version = "1.6.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
     { name = "unstructured-pytesseract" },
     { name = "xlrd" },
 ]
@@ -8649,7 +8651,8 @@ local-inference = [
     { name = "pypdf" },
     { name = "python-docx" },
     { name = "python-pptx" },
-    { name = "unstructured-inference" },
+    { name = "unstructured-inference", version = "1.2.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.12'" },
+    { name = "unstructured-inference", version = "1.6.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
     { name = "unstructured-pytesseract" },
     { name = "xlrd" },
 ]
@@ -8677,31 +8680,67 @@ wheels = [
 name = "unstructured-inference"
 version = "1.2.0"
 source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version == '3.11.*' and platform_machine != 's390x'",
+    "python_full_version == '3.11.*' and platform_machine == 's390x'",
+    "python_full_version < '3.11' and platform_machine != 's390x'",
+    "python_full_version < '3.11' and platform_machine == 's390x'",
+]
 dependencies = [
-    { name = "accelerate" },
-    { name = "huggingface-hub" },
-    { name = "matplotlib" },
+    { name = "accelerate", marker = "python_full_version < '3.12'" },
+    { name = "huggingface-hub", marker = "python_full_version < '3.12'" },
+    { name = "matplotlib", marker = "python_full_version < '3.12'" },
     { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "numpy", version = "2.4.4", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
-    { name = "onnx" },
+    { name = "numpy", version = "2.4.4", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version == '3.11.*'" },
+    { name = "onnx", marker = "python_full_version < '3.12'" },
     { name = "onnxruntime", marker = "python_full_version < '3.11'" },
-    { name = "opencv-python" },
-    { name = "pandas" },
-    { name = "pdfminer-six" },
-    { name = "pypdfium2" },
-    { name = "python-multipart" },
-    { name = "rapidfuzz" },
+    { name = "opencv-python", marker = "python_full_version < '3.12'" },
+    { name = "pandas", marker = "python_full_version < '3.12'" },
+    { name = "pdfminer-six", marker = "python_full_version < '3.12'" },
+    { name = "pypdfium2", marker = "python_full_version < '3.12'" },
+    { name = "python-multipart", marker = "python_full_version < '3.12'" },
+    { name = "rapidfuzz", marker = "python_full_version < '3.12'" },
     { name = "scipy", version = "1.15.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
-    { name = "scipy", version = "1.17.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
-    { name = "timm" },
-    { name = "torch" },
-    { name = "transformers" },
+    { name = "scipy", version = "1.17.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version == '3.11.*'" },
+    { name = "timm", marker = "python_full_version < '3.12'" },
+    { name = "torch", marker = "python_full_version < '3.12'" },
+    { name = "transformers", marker = "python_full_version < '3.12'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/ce/10/8f3bccfa9f1e0101a402ae1f529e07876541c6b18004747f0e793ed41f9e/unstructured_inference-1.2.0.tar.gz", hash = "sha256:19ca28512f3649c70a759cf2a4e98663e942a1b83c1acdb9506b0445f4862f23", size = 45732, upload-time = "2026-01-30T20:57:58.019Z" }
 wheels = [
     { url = "https://files.pythonhosted.org/packages/2d/3b/349cd091b590a6f1dbfebcb5fee0ea7b0b6ef6520df58794c9582567a24f/unstructured_inference-1.2.0-py3-none-any.whl", hash = "sha256:60a1635aa8e97a9e7daed1a129836f51c26588e0d2062c9cc6a5a17e6d40cb6a", size = 49443, upload-time = "2026-01-30T20:57:56.617Z" },
 ]
 
+[[package]]
+name = "unstructured-inference"
+version = "1.6.6"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.13' and platform_machine != 's390x'",
+    "python_full_version >= '3.13' and platform_machine == 's390x'",
+    "python_full_version == '3.12.*' and platform_machine != 's390x'",
+    "python_full_version == '3.12.*' and platform_machine == 's390x'",
+]
+dependencies = [
+    { name = "accelerate", marker = "python_full_version >= '3.12'" },
+    { name = "huggingface-hub", marker = "python_full_version >= '3.12'" },
+    { name = "matplotlib", marker = "python_full_version >= '3.12'" },
+    { name = "numpy", version = "2.4.4", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
+    { name = "onnx", marker = "python_full_version >= '3.12'" },
+    { name = "opencv-python", marker = "python_full_version >= '3.12'" },
+    { name = "pandas", marker = "python_full_version >= '3.12'" },
+    { name = "pypdfium2", marker = "python_full_version >= '3.12'" },
+    { name = "rapidfuzz", marker = "python_full_version >= '3.12'" },
+    { name = "scipy", version = "1.17.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
+    { name = "timm", marker = "python_full_version >= '3.12'" },
+    { name = "torch", marker = "python_full_version >= '3.12'" },
+    { name = "transformers", marker = "python_full_version >= '3.12'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d3/e3/6c98caf4965e07eb0153dc2b4457ec6fb1cfef336411add4acd3b28c697c/unstructured_inference-1.6.6.tar.gz", hash = "sha256:f14745daef4c37f785d4edb6c3d3834c7414d9d5abd47ca0e377ca60c624d225", size = 47024, upload-time = "2026-04-09T19:58:52.292Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/5b/bd4aa4d16446fbc79bea07b22c19c8f8b578c8f1dd73745d152511c17a5a/unstructured_inference-1.6.6-py3-none-any.whl", hash = "sha256:ac472f341407b2ea14d1b63074080af840b9badeefdcd90ea38feb22b4928e5a", size = 54286, upload-time = "2026-04-09T19:58:50.858Z" },
+]
+
 [[package]]
 name = "unstructured-pytesseract"
 version = "0.3.15"
@@ -8862,7 +8901,7 @@ wheels = [
 
 [[package]]
 name = "virtualenv"
-version = "21.2.0"
+version = "21.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "distlib" },
@@ -8871,9 +8910,9 @@ dependencies = [
     { name = "python-discovery" },
     { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/aa/92/58199fe10049f9703c2666e809c4f686c54ef0a68b0f6afccf518c0b1eb9/virtualenv-21.2.0.tar.gz", hash = "sha256:1720dc3a62ef5b443092e3f499228599045d7fea4c79199770499df8becf9098", size = 5840618, upload-time = "2026-03-09T17:24:38.013Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/97/c5/aff062c66b42e2183201a7ace10c6b2e959a9a16525c8e8ca8e59410d27a/virtualenv-21.2.1.tar.gz", hash = "sha256:b66ffe81301766c0d5e2208fc3576652c59d44e7b731fc5f5ed701c9b537fa78", size = 5844770, upload-time = "2026-04-09T18:47:11.482Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/c6/59/7d02447a55b2e55755011a647479041bc92a82e143f96a8195cb33bd0a1c/virtualenv-21.2.0-py3-none-any.whl", hash = "sha256:1bd755b504931164a5a496d217c014d098426cddc79363ad66ac78125f9d908f", size = 5825084, upload-time = "2026-03-09T17:24:35.378Z" },
+    { url = "https://files.pythonhosted.org/packages/20/0e/f083a76cb590e60dff3868779558eefefb8dfb7c9ed020babc7aa014ccbf/virtualenv-21.2.1-py3-none-any.whl", hash = "sha256:bd16b49c53562b28cf1a3ad2f36edb805ad71301dee70ddc449e5c88a9f919a2", size = 5828326, upload-time = "2026-04-09T18:47:09.331Z" },
 ]
 
 [[package]]

From 1293dee241227e698ceb7c79094917629ad8fd10 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Fri, 10 Apr 2026 21:24:49 +0800
Subject: [PATCH 25/70] feat: checkpoint TUI with tree view, fork support,
 editable inputs/outputs

- Rewrite TUI with Tree widget showing branch/fork lineage
- Add Resume and Fork buttons in detail panel with Collapsible entities
- Show branch and parent_id in detail panel and CLI info output
- Auto-detect .checkpoints.db when default dir missing
- Append .db to location for SqliteProvider when no extension set
- Fix RuntimeState.from_checkpoint not setting provider/location
- Fork now writes initial checkpoint on new branch
- Add from_checkpoint, fork, and CLI docs to checkpointing.mdx
---
 docs/en/concepts/checkpointing.mdx            |  82 ++-
 docs/images/checkpointing.png                 | Bin 0 -> 322143 bytes
 lib/crewai/src/crewai/cli/checkpoint_cli.py   |  67 +-
 lib/crewai/src/crewai/cli/checkpoint_tui.py   | 693 ++++++++++++------
 lib/crewai/src/crewai/cli/cli.py              |  11 +-
 lib/crewai/src/crewai/crew.py                 |   7 +
 .../src/crewai/state/checkpoint_config.py     |   3 +
 .../src/crewai/state/checkpoint_listener.py   |  12 +-
 lib/crewai/src/crewai/state/runtime.py        |  14 +-
 lib/crewai/src/crewai/task.py                 |   2 +
 lib/crewai/tests/test_checkpoint.py           |   3 +-
 11 files changed, 652 insertions(+), 242 deletions(-)
 create mode 100644 docs/images/checkpointing.png

diff --git a/docs/en/concepts/checkpointing.mdx b/docs/en/concepts/checkpointing.mdx
index 21ed13905..d6430eb6f 100644
--- a/docs/en/concepts/checkpointing.mdx
+++ b/docs/en/concepts/checkpointing.mdx
@@ -54,6 +54,7 @@ crew = Crew(
 | `on_events` | `list[str]` | `["task_completed"]` | Event types that trigger a checkpoint |
 | `provider` | `BaseProvider` | `JsonProvider()` | Storage backend |
 | `max_checkpoints` | `int \| None` | `None` | Max checkpoints to keep. Oldest are pruned after each write. Pruning is handled by the provider. |
+| `restore_from` | `Path \| str \| None` | `None` | Path to a checkpoint to restore from. Used when passing config via a kickoff method's `from_checkpoint` parameter. |
 
 ### Inheritance and Opt-Out
 
@@ -79,13 +80,42 @@ crew = Crew(
 
 ## Resuming from a Checkpoint
 
+Pass a `CheckpointConfig` with `restore_from` to any kickoff method. The crew restores from that checkpoint, skips completed tasks, and resumes.
+
 ```python
-# Restore and resume
-crew = Crew.from_checkpoint("./my_checkpoints/20260407T120000_abc123.json")
-result = crew.kickoff()  # picks up from last completed task
+from crewai import Crew, CheckpointConfig
+
+crew = Crew(agents=[...], tasks=[...])
+result = crew.kickoff(
+    from_checkpoint=CheckpointConfig(
+        restore_from="./my_checkpoints/20260407T120000_abc123.json",
+    ),
+)
 ```
 
-The restored crew skips already-completed tasks and resumes from the first incomplete one.
+Remaining `CheckpointConfig` fields apply to the new run, so checkpointing continues after the restore.
+
+You can also use the classmethod directly:
+
+```python
+config = CheckpointConfig(restore_from="./my_checkpoints/20260407T120000_abc123.json")
+crew = Crew.from_checkpoint(config)
+result = crew.kickoff()
+```
+
+## Forking from a Checkpoint
+
+`fork()` restores a checkpoint and starts a new execution branch. Useful for exploring alternative paths from the same point.
+
+```python
+from crewai import Crew, CheckpointConfig
+
+config = CheckpointConfig(restore_from="./my_checkpoints/20260407T120000_abc123.json")
+crew = Crew.fork(config, branch="experiment-a")
+result = crew.kickoff(inputs={"strategy": "aggressive"})
+```
+
+Each fork gets a unique lineage ID so checkpoints from different branches don't collide. The `branch` label is optional and auto-generated if omitted.
 
 ## Works on Crew, Flow, and Agent
 
@@ -125,7 +155,8 @@ flow = MyFlow(
 result = flow.kickoff()
 
 # Resume
-flow = MyFlow.from_checkpoint("./flow_cp/20260407T120000_abc123.json")
+config = CheckpointConfig(restore_from="./flow_cp/20260407T120000_abc123.json")
+flow = MyFlow.from_checkpoint(config)
 result = flow.kickoff()
 ```
 
@@ -231,3 +262,44 @@ async def on_llm_done_async(source, event, state):
 The `state` argument is the `RuntimeState` passed automatically by the event bus when your handler accepts 3 parameters. You can register handlers on any event type listed in the [Event Listeners](/en/concepts/event-listener) documentation.
 
 Checkpointing is best-effort: if a checkpoint write fails, the error is logged but execution continues uninterrupted.
+
+## CLI
+
+The `crewai checkpoint` command gives you a TUI for browsing, inspecting, resuming, and forking checkpoints. It auto-detects whether your checkpoints are JSON files or a SQLite database.
+
+```bash
+# Launch the TUI — auto-detects .checkpoints/ or .checkpoints.db
+crewai checkpoint
+
+# Point at a specific location
+crewai checkpoint --location ./my_checkpoints
+crewai checkpoint --location ./.checkpoints.db
+```
+
+<Frame>
+  <img src="/images/checkpointing.png" alt="Checkpoint TUI" />
+</Frame>
+
+The left panel is a tree view. Checkpoints are grouped by branch, and forks nest under the checkpoint they diverged from. Select a checkpoint to see its metadata, entity state, and task progress in the detail panel. Hit **Resume** to pick up where it left off, or **Fork** to start a new branch from that point.
+
+### Editing inputs and task outputs
+
+When a checkpoint is selected, the detail panel shows:
+
+- **Inputs** — if the original kickoff had inputs (e.g. `{topic}`), they appear as editable fields pre-filled with the original values. Change them before resuming or forking.
+- **Task outputs** — completed tasks show their output in editable text areas. Edit a task's output to change the context that downstream tasks receive. When you modify a task output and hit Fork, all subsequent tasks are invalidated and re-run with the new context.
+
+This is useful for "what if" exploration — fork from a checkpoint, tweak a task's result, and see how it changes downstream behavior.
+
+### Subcommands
+
+```bash
+# List all checkpoints
+crewai checkpoint list ./my_checkpoints
+
+# Inspect a specific checkpoint
+crewai checkpoint info ./my_checkpoints/20260407T120000_abc123.json
+
+# Inspect latest in a SQLite database
+crewai checkpoint info ./.checkpoints.db
+```
diff --git a/docs/images/checkpointing.png b/docs/images/checkpointing.png
new file mode 100644
index 0000000000000000000000000000000000000000..de1f4776a6ce346c5a59991050b17b495267861e
GIT binary patch
literal 322143
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%0DJ?mw30|Np|nUS+^P9NV4wdVhb}ACp#G
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

literal 0
HcmV?d00001

diff --git a/lib/crewai/src/crewai/cli/checkpoint_cli.py b/lib/crewai/src/crewai/cli/checkpoint_cli.py
index c61500b20..fa6e003aa 100644
--- a/lib/crewai/src/crewai/cli/checkpoint_cli.py
+++ b/lib/crewai/src/crewai/cli/checkpoint_cli.py
@@ -6,12 +6,16 @@ from datetime import datetime
 import glob
 import json
 import os
+import re
 import sqlite3
 from typing import Any
 
 import click
 
 
+_PLACEHOLDER_RE = re.compile(r"\{([A-Za-z_][A-Za-z0-9_\-]*)}")
+
+
 _SQLITE_MAGIC = b"SQLite format 3\x00"
 
 _SELECT_ALL = """
@@ -34,6 +38,25 @@ LIMIT 1
 """
 
 
+_DEFAULT_DIR = "./.checkpoints"
+_DEFAULT_DB = "./.checkpoints.db"
+
+
+def _detect_location(location: str) -> str:
+    """Resolve the default checkpoint location.
+
+    When the caller passes the default directory path, check whether a
+    SQLite database exists at the conventional ``.db`` path and prefer it.
+    """
+    if (
+        location == _DEFAULT_DIR
+        and not os.path.exists(_DEFAULT_DIR)
+        and os.path.exists(_DEFAULT_DB)
+    ):
+        return _DEFAULT_DB
+    return location
+
+
 def _is_sqlite(path: str) -> bool:
     """Check if a file is a SQLite database by reading its magic bytes."""
     if not os.path.isfile(path):
@@ -52,13 +75,7 @@ def _parse_checkpoint_json(raw: str, source: str) -> dict[str, Any]:
     nodes = data.get("event_record", {}).get("nodes", {})
     event_count = len(nodes)
 
-    trigger_event = None
-    if nodes:
-        last_node = max(
-            nodes.values(),
-            key=lambda n: n.get("event", {}).get("emission_sequence") or 0,
-        )
-        trigger_event = last_node.get("event", {}).get("type")
+    trigger_event = data.get("trigger")
 
     parsed_entities: list[dict[str, Any]] = []
     for entity in entities:
@@ -76,16 +93,47 @@ def _parse_checkpoint_json(raw: str, source: str) -> dict[str, Any]:
                 {
                     "description": t.get("description", ""),
                     "completed": t.get("output") is not None,
+                    "output": (t.get("output") or {}).get("raw", ""),
                 }
                 for t in tasks
             ]
         parsed_entities.append(info)
 
+    inputs: dict[str, Any] = {}
+    for entity in entities:
+        cp_inputs = entity.get("checkpoint_inputs")
+        if isinstance(cp_inputs, dict) and cp_inputs:
+            inputs = dict(cp_inputs)
+            break
+
+    for entity in entities:
+        for task in entity.get("tasks", []):
+            for field in (
+                "checkpoint_original_description",
+                "checkpoint_original_expected_output",
+            ):
+                text = task.get(field) or ""
+                for match in _PLACEHOLDER_RE.findall(text):
+                    if match not in inputs:
+                        inputs[match] = ""
+        for agent in entity.get("agents", []):
+            for field in ("role", "goal", "backstory"):
+                text = agent.get(field) or ""
+                for match in _PLACEHOLDER_RE.findall(text):
+                    if match not in inputs:
+                        inputs[match] = ""
+
+    branch = data.get("branch", "main")
+    parent_id = data.get("parent_id")
+
     return {
         "source": source,
         "event_count": event_count,
         "trigger": trigger_event,
         "entities": parsed_entities,
+        "branch": branch,
+        "parent_id": parent_id,
+        "inputs": inputs,
     }
 
 
@@ -189,6 +237,7 @@ def _list_sqlite(db_path: str) -> list[dict[str, Any]]:
                     "entities": [],
                     "source": checkpoint_id,
                 }
+            meta["db"] = db_path
             results.append(meta)
     return results
 
@@ -311,6 +360,10 @@ def _print_info(meta: dict[str, Any]) -> None:
     trigger = meta.get("trigger")
     if trigger:
         click.echo(f"Trigger: {trigger}")
+    click.echo(f"Branch:  {meta.get('branch', 'main')}")
+    parent_id = meta.get("parent_id")
+    if parent_id:
+        click.echo(f"Parent:  {parent_id}")
 
     for ent in meta.get("entities", []):
         eid = str(ent.get("id", ""))[:8]
diff --git a/lib/crewai/src/crewai/cli/checkpoint_tui.py b/lib/crewai/src/crewai/cli/checkpoint_tui.py
index c58ed2ea6..e0d10f813 100644
--- a/lib/crewai/src/crewai/cli/checkpoint_tui.py
+++ b/lib/crewai/src/crewai/cli/checkpoint_tui.py
@@ -2,17 +2,23 @@
 
 from __future__ import annotations
 
+from collections import defaultdict
 from typing import Any, ClassVar
 
 from textual.app import App, ComposeResult
 from textual.binding import Binding
-from textual.containers import Horizontal, Vertical
-from textual.screen import ModalScreen
-from textual.widgets import Button, Footer, Header, OptionList, Static
-from textual.widgets.option_list import Option
+from textual.containers import Horizontal, Vertical, VerticalScroll
+from textual.widgets import (
+    Button,
+    Footer,
+    Header,
+    Input,
+    Static,
+    TextArea,
+    Tree,
+)
 
 from crewai.cli.checkpoint_cli import (
-    _entity_summary,
     _format_size,
     _is_sqlite,
     _list_json,
@@ -34,151 +40,54 @@ def _load_entries(location: str) -> list[dict[str, Any]]:
     return _list_json(location)
 
 
-def _format_list_label(entry: dict[str, Any]) -> str:
-    """Format a checkpoint entry for the list panel."""
-    name = entry.get("name", "")
-    ts = entry.get("ts") or ""
-    trigger = entry.get("trigger") or ""
-    summary = _entity_summary(entry.get("entities", []))
-
-    line1 = f"[bold]{name}[/]"
-    parts = []
-    if ts:
-        parts.append(f"[dim]{ts}[/]")
-    if "size" in entry:
-        parts.append(f"[dim]{_format_size(entry['size'])}[/]")
-    if trigger:
-        parts.append(f"[{_PRIMARY}]{trigger}[/]")
-    line2 = "  ".join(parts)
-    line3 = f"  [{_DIM}]{summary}[/]"
-
-    return f"{line1}\n{line2}\n{line3}"
+def _short_id(name: str) -> str:
+    """Shorten a checkpoint name for tree display."""
+    if len(name) > 30:
+        return name[:27] + "..."
+    return name
 
 
-def _format_detail(entry: dict[str, Any]) -> str:
-    """Format checkpoint details for the right panel."""
+def _entry_id(entry: dict[str, Any]) -> str:
+    """Normalize an entry's name into its checkpoint ID.
+
+    JSON filenames are ``{ts}_{uuid}_p-{parent}.json``; SQLite IDs
+    are already ``{ts}_{uuid}``. This strips the JSON suffix so
+    fork-parent lookups work in both providers.
+    """
+    name = str(entry.get("name", ""))
+    if name.endswith(".json"):
+        name = name[: -len(".json")]
+    idx = name.find("_p-")
+    if idx != -1:
+        name = name[:idx]
+    return name
+
+
+def _build_entity_header(ent: dict[str, Any]) -> str:
+    """Build rich text header for an entity (progress bar only)."""
     lines: list[str] = []
-
-    # Header
-    name = entry.get("name", "")
-    lines.append(f"[bold {_PRIMARY}]{name}[/]")
-    lines.append(f"[{_DIM}]{'─' * 50}[/]")
-    lines.append("")
-
-    # Metadata table
-    ts = entry.get("ts") or "unknown"
-    trigger = entry.get("trigger") or ""
-    lines.append(f"  [bold]Time[/]       {ts}")
-    if "size" in entry:
-        lines.append(f"  [bold]Size[/]       {_format_size(entry['size'])}")
-    lines.append(f"  [bold]Events[/]     {entry.get('event_count', 0)}")
-    if trigger:
-        lines.append(f"  [bold]Trigger[/]    [{_PRIMARY}]{trigger}[/]")
-    if "path" in entry:
-        lines.append(f"  [bold]Path[/]       [{_DIM}]{entry['path']}[/]")
-    if "db" in entry:
-        lines.append(f"  [bold]Database[/]   [{_DIM}]{entry['db']}[/]")
-
-    # Entities
-    for ent in entry.get("entities", []):
-        eid = str(ent.get("id", ""))[:8]
-        etype = ent.get("type", "unknown")
-        ename = ent.get("name", "unnamed")
-
-        lines.append("")
-        lines.append(f"  [{_DIM}]{'─' * 50}[/]")
-        lines.append(f"  [bold {_SECONDARY}]{etype}[/]: {ename} [{_DIM}]{eid}[/]")
-
-        tasks = ent.get("tasks")
-        if isinstance(tasks, list):
-            completed = ent.get("tasks_completed", 0)
-            total = ent.get("tasks_total", 0)
-            pct = int(completed / total * 100) if total else 0
-            bar_len = 20
-            filled = int(bar_len * completed / total) if total else 0
-            bar = f"[{_PRIMARY}]{'█' * filled}[/][{_DIM}]{'░' * (bar_len - filled)}[/]"
-
-            lines.append(f"  {bar}  {completed}/{total} tasks ({pct}%)")
-            lines.append("")
-
-            for i, task in enumerate(tasks):
-                if task.get("completed"):
-                    icon = "[green]✓[/]"
-                else:
-                    icon = "[yellow]○[/]"
-                desc = str(task.get("description", ""))
-                if len(desc) > 55:
-                    desc = desc[:52] + "..."
-                lines.append(f"    {icon}  {i + 1}. {desc}")
-
+    tasks = ent.get("tasks")
+    if isinstance(tasks, list):
+        completed = ent.get("tasks_completed", 0)
+        total = ent.get("tasks_total", 0)
+        pct = int(completed / total * 100) if total else 0
+        bar_len = 20
+        filled = int(bar_len * completed / total) if total else 0
+        bar = f"[{_PRIMARY}]{'█' * filled}[/][{_DIM}]{'░' * (bar_len - filled)}[/]"
+        lines.append(f"{bar}  {completed}/{total} tasks ({pct}%)")
     return "\n".join(lines)
 
 
-class ConfirmResumeScreen(ModalScreen[bool]):
-    """Modal confirmation before resuming from a checkpoint."""
-
-    CSS = f"""
-    ConfirmResumeScreen {{
-        align: center middle;
-    }}
-    #confirm-dialog {{
-        width: 60;
-        height: auto;
-        padding: 1 2;
-        background: {_BG_PANEL};
-        border: round {_PRIMARY};
-    }}
-    #confirm-label {{
-        width: 100%;
-        content-align: center middle;
-        margin-bottom: 1;
-    }}
-    #confirm-name {{
-        width: 100%;
-        content-align: center middle;
-        color: {_PRIMARY};
-        text-style: bold;
-        margin-bottom: 1;
-    }}
-    #confirm-buttons {{
-        width: 100%;
-        height: 3;
-        layout: horizontal;
-        align: center middle;
-    }}
-    Button {{
-        margin: 0 2;
-        min-width: 12;
-    }}
-    """
-
-    def __init__(self, checkpoint_name: str) -> None:
-        super().__init__()
-        self._checkpoint_name = checkpoint_name
-
-    def compose(self) -> ComposeResult:
-        with Vertical(id="confirm-dialog"):
-            yield Static("Resume from this checkpoint?", id="confirm-label")
-            yield Static(self._checkpoint_name, id="confirm-name")
-            with Horizontal(id="confirm-buttons"):
-                yield Button("Resume", variant="success", id="btn-yes")
-                yield Button("Cancel", variant="default", id="btn-no")
-
-    def on_button_pressed(self, event: Button.Pressed) -> None:
-        self.dismiss(event.button.id == "btn-yes")
-
-    def on_key(self, event: Any) -> None:
-        if event.key == "y":
-            self.dismiss(True)
-        elif event.key in ("n", "escape"):
-            self.dismiss(False)
+# Return type: (location, action, inputs, task_output_overrides)
+_TuiResult = tuple[str, str, dict[str, Any] | None, dict[int, str] | None] | None
 
 
-class CheckpointTUI(App[str | None]):
+class CheckpointTUI(App[_TuiResult]):
     """TUI to browse and inspect checkpoints.
 
-    Returns the checkpoint location string to resume from, or None if
-    the user quit without selecting.
+    Returns ``(location, action, inputs)`` where action is ``"resume"`` or
+    ``"fork"`` and inputs is a parsed dict or ``None``,
+    or ``None`` if the user quit without selecting.
     """
 
     TITLE = "CrewAI Checkpoints"
@@ -199,145 +108,431 @@ class CheckpointTUI(App[str | None]):
         background: {_PRIMARY};
         color: {_TERTIARY};
     }}
-    Horizontal {{
+    #main-layout {{
         height: 1fr;
     }}
-    #cp-list {{
-        width: 38%;
+    #tree-panel {{
+        width: 45%;
         background: {_BG_PANEL};
         border: round {_SECONDARY};
         padding: 0 1;
         scrollbar-color: {_PRIMARY};
     }}
-    #cp-list:focus {{
+    #tree-panel:focus-within {{
         border: round {_PRIMARY};
     }}
-    #cp-list > .option-list--option-highlighted {{
-        background: {_SECONDARY};
-        color: {_TERTIARY};
-        text-style: none;
-    }}
-    #cp-list > .option-list--option-highlighted * {{
-        color: {_TERTIARY};
-    }}
     #detail-container {{
-        width: 62%;
-        padding: 0 1;
+        width: 55%;
+        height: 1fr;
     }}
-    #detail {{
+    #detail-scroll {{
         height: 1fr;
         background: {_BG_PANEL};
         border: round {_SECONDARY};
         padding: 1 2;
-        overflow-y: auto;
         scrollbar-color: {_PRIMARY};
     }}
-    #detail:focus {{
+    #detail-scroll:focus-within {{
         border: round {_PRIMARY};
     }}
+    #detail-header {{
+        margin-bottom: 1;
+    }}
     #status {{
         height: 1;
         padding: 0 2;
         color: {_DIM};
     }}
+    #inputs-section {{
+        display: none;
+        height: auto;
+        max-height: 8;
+        padding: 0 1;
+    }}
+    #inputs-section.visible {{
+        display: block;
+    }}
+    #inputs-label {{
+        height: 1;
+        color: {_DIM};
+        padding: 0 1;
+    }}
+    .input-row {{
+        height: 3;
+        padding: 0 1;
+    }}
+    .input-row Static {{
+        width: auto;
+        min-width: 12;
+        padding: 1 1 0 0;
+        color: {_TERTIARY};
+    }}
+    .input-row Input {{
+        width: 1fr;
+    }}
+    #no-inputs-label {{
+        height: 1;
+        color: {_DIM};
+        padding: 0 1;
+    }}
+    #action-buttons {{
+        height: 3;
+        align: right middle;
+        padding: 0 1;
+        display: none;
+    }}
+    #action-buttons.visible {{
+        display: block;
+    }}
+    #action-buttons Button {{
+        margin: 0 0 0 1;
+        min-width: 10;
+    }}
+    #btn-resume {{
+        background: {_SECONDARY};
+        color: {_TERTIARY};
+    }}
+    #btn-resume:hover {{
+        background: {_PRIMARY};
+    }}
+    #btn-fork {{
+        background: {_PRIMARY};
+        color: {_TERTIARY};
+    }}
+    #btn-fork:hover {{
+        background: {_SECONDARY};
+    }}
+    .entity-title {{
+        padding: 1 1 0 1;
+    }}
+    .entity-detail {{
+        padding: 0 1;
+    }}
+    .task-output-editor {{
+        height: auto;
+        max-height: 10;
+        margin: 0 1 1 1;
+        border: round {_DIM};
+    }}
+    .task-output-editor:focus {{
+        border: round {_PRIMARY};
+    }}
+    .task-label {{
+        padding: 0 1;
+    }}
+    Tree {{
+        background: {_BG_PANEL};
+    }}
+    Tree > .tree--cursor {{
+        background: {_SECONDARY};
+        color: {_TERTIARY};
+    }}
     """
 
     BINDINGS: ClassVar[list[Binding | tuple[str, str] | tuple[str, str, str]]] = [
         ("q", "quit", "Quit"),
         ("r", "refresh", "Refresh"),
-        ("j", "cursor_down", "Down"),
-        ("k", "cursor_up", "Up"),
     ]
 
     def __init__(self, location: str = "./.checkpoints") -> None:
         super().__init__()
         self._location = location
         self._entries: list[dict[str, Any]] = []
-        self._selected_idx: int = 0
-        self._pending_location: str = ""
+        self._selected_entry: dict[str, Any] | None = None
+        self._input_keys: list[str] = []
+        self._task_output_ids: list[tuple[int, str, str]] = []
 
     def compose(self) -> ComposeResult:
         yield Header(show_clock=False)
-        with Horizontal():
-            yield OptionList(id="cp-list")
+        with Horizontal(id="main-layout"):
+            tree: Tree[dict[str, Any]] = Tree("Checkpoints", id="tree-panel")
+            tree.show_root = True
+            tree.guide_depth = 3
+            yield tree
             with Vertical(id="detail-container"):
                 yield Static("", id="status")
-                yield Static(
-                    f"\n  [{_DIM}]Select a checkpoint from the list[/]",  # noqa: S608
-                    id="detail",
-                )
+                with VerticalScroll(id="detail-scroll"):
+                    yield Static(
+                        f"[{_DIM}]Select a checkpoint from the tree[/]",  # noqa: S608
+                        id="detail-header",
+                    )
+                with Vertical(id="inputs-section"):
+                    yield Static("Inputs", id="inputs-label")
+                with Horizontal(id="action-buttons"):
+                    yield Button("Resume", id="btn-resume")
+                    yield Button("Fork", id="btn-fork")
         yield Footer()
 
     async def on_mount(self) -> None:
-        self.query_one("#cp-list", OptionList).border_title = "Checkpoints"
-        self.query_one("#detail", Static).border_title = "Detail"
-        self._refresh_list()
+        self._refresh_tree()
+        self.query_one("#tree-panel", Tree).root.expand()
 
-    def _refresh_list(self) -> None:
+    def _refresh_tree(self) -> None:
         self._entries = _load_entries(self._location)
-        option_list = self.query_one("#cp-list", OptionList)
-        option_list.clear_options()
+        self._selected_entry = None
+
+        tree = self.query_one("#tree-panel", Tree)
+        tree.clear()
 
         if not self._entries:
-            self.query_one("#detail", Static).update(
-                f"\n  [{_DIM}]No checkpoints in {self._location}[/]"
+            self.query_one("#detail-header", Static).update(
+                f"[{_DIM}]No checkpoints in {self._location}[/]"
             )
             self.query_one("#status", Static).update("")
             self.sub_title = self._location
             return
 
+        # Group by branch
+        branches: dict[str, list[dict[str, Any]]] = defaultdict(list)
         for entry in self._entries:
-            option_list.add_option(Option(_format_list_label(entry)))
+            branch = entry.get("branch", "main")
+            branches[branch].append(entry)
+
+        # Index checkpoint names to tree nodes so forks can attach
+        node_by_name: dict[str, Any] = {}
+
+        def _make_label(e: dict[str, Any]) -> str:
+            name = e.get("name", "")
+            ts = e.get("ts") or ""
+            trigger = e.get("trigger") or ""
+            parts = [f"[bold]{_short_id(name)}[/]"]
+            if ts:
+                time_part = ts.split(" ")[-1] if " " in ts else ts
+                parts.append(f"[{_DIM}]{time_part}[/]")
+            if trigger:
+                parts.append(f"[{_PRIMARY}]{trigger}[/]")
+            return "  ".join(parts)
+
+        fork_parents: set[str] = set()
+        for branch_name, entries in branches.items():
+            if branch_name == "main" or not entries:
+                continue
+            oldest = min(entries, key=lambda e: str(e.get("name", "")))
+            first_parent = oldest.get("parent_id")
+            if first_parent:
+                fork_parents.add(str(first_parent))
+
+        def _add_checkpoint(parent_node: Any, e: dict[str, Any]) -> None:
+            """Add a checkpoint node — expandable only if a fork attaches to it."""
+            cp_id = _entry_id(e)
+            if cp_id in fork_parents:
+                node = parent_node.add(
+                    _make_label(e), data=e, expand=False, allow_expand=True
+                )
+            else:
+                node = parent_node.add_leaf(_make_label(e), data=e)
+            node_by_name[cp_id] = node
+
+        if "main" in branches:
+            for entry in reversed(branches["main"]):
+                _add_checkpoint(tree.root, entry)
+
+        fork_branches = [
+            (name, sorted(entries, key=lambda e: str(e.get("name", ""))))
+            for name, entries in branches.items()
+            if name != "main"
+        ]
+        remaining = fork_branches
+        max_passes = len(remaining) + 1
+        while remaining and max_passes > 0:
+            max_passes -= 1
+            deferred = []
+            made_progress = False
+            for branch_name, entries in remaining:
+                first_parent = entries[0].get("parent_id") if entries else None
+                if first_parent and str(first_parent) not in node_by_name:
+                    deferred.append((branch_name, entries))
+                    continue
+                attach_to: Any = tree.root
+                if first_parent:
+                    attach_to = node_by_name.get(str(first_parent), tree.root)
+                branch_label = (
+                    f"[bold {_SECONDARY}]{branch_name}[/]  [{_DIM}]({len(entries)})[/]"
+                )
+                branch_node = attach_to.add(branch_label, expand=False)
+                for entry in entries:
+                    _add_checkpoint(branch_node, entry)
+                made_progress = True
+            remaining = deferred
+            if not made_progress:
+                break
+
+        for branch_name, entries in remaining:
+            branch_label = (
+                f"[bold {_SECONDARY}]{branch_name}[/]  "
+                f"[{_DIM}]({len(entries)})[/]  [{_DIM}](orphaned)[/]"
+            )
+            branch_node = tree.root.add(branch_label, expand=False)
+            for entry in entries:
+                _add_checkpoint(branch_node, entry)
 
         count = len(self._entries)
         storage = "SQLite" if _is_sqlite(self._location) else "JSON"
-        self.sub_title = f"{self._location}"
+        self.sub_title = self._location
         self.query_one("#status", Static).update(f" {count} checkpoint(s) | {storage}")
 
-    async def on_option_list_option_highlighted(
-        self,
-        event: OptionList.OptionHighlighted,
-    ) -> None:
-        idx = event.option_index
-        if idx is None:
-            return
-        if idx < len(self._entries):
-            self._selected_idx = idx
-            entry = self._entries[idx]
-            self.query_one("#detail", Static).update(_format_detail(entry))
+    async def _show_detail(self, entry: dict[str, Any]) -> None:
+        """Update the detail panel for a checkpoint entry."""
+        self._selected_entry = entry
+        self.query_one("#action-buttons").add_class("visible")
 
-    def action_cursor_down(self) -> None:
-        self.query_one("#cp-list", OptionList).action_cursor_down()
+        detail_scroll = self.query_one("#detail-scroll", VerticalScroll)
 
-    def action_cursor_up(self) -> None:
-        self.query_one("#cp-list", OptionList).action_cursor_up()
+        # Remove all dynamic children except the header — await so IDs are freed
+        to_remove = [c for c in detail_scroll.children if c.id != "detail-header"]
+        for child in to_remove:
+            await child.remove()
 
-    async def on_option_list_option_selected(
-        self,
-        event: OptionList.OptionSelected,
-    ) -> None:
-        idx = event.option_index
-        if idx is None or idx >= len(self._entries):
-            return
-        entry = self._entries[idx]
+        # Header
+        name = entry.get("name", "")
+        ts = entry.get("ts") or "unknown"
+        trigger = entry.get("trigger") or ""
+        branch = entry.get("branch", "main")
+        parent_id = entry.get("parent_id")
+
+        header_lines = [
+            f"[bold {_PRIMARY}]{name}[/]",
+            f"[{_DIM}]{'─' * 50}[/]",
+            "",
+            f"  [bold]Time[/]       {ts}",
+        ]
+        if "size" in entry:
+            header_lines.append(f"  [bold]Size[/]       {_format_size(entry['size'])}")
+        header_lines.append(f"  [bold]Events[/]     {entry.get('event_count', 0)}")
+        if trigger:
+            header_lines.append(f"  [bold]Trigger[/]    [{_PRIMARY}]{trigger}[/]")
+        header_lines.append(f"  [bold]Branch[/]     [{_SECONDARY}]{branch}[/]")
+        if parent_id:
+            header_lines.append(f"  [bold]Parent[/]     [{_DIM}]{parent_id}[/]")
         if "path" in entry:
-            loc = entry["path"]
-        elif _is_sqlite(self._location):
-            loc = f"{self._location}#{entry['name']}"
-        else:
-            loc = entry.get("name", "")
-        self._pending_location = loc
-        name = entry.get("name", loc)
-        self.push_screen(ConfirmResumeScreen(name), self._on_confirm)
+            header_lines.append(f"  [bold]Path[/]       [{_DIM}]{entry['path']}[/]")
+        if "db" in entry:
+            header_lines.append(f"  [bold]Database[/]   [{_DIM}]{entry['db']}[/]")
 
-    def _on_confirm(self, confirmed: bool | None) -> None:
-        if confirmed:
-            self.exit(self._pending_location)
-        else:
-            self._pending_location = ""
+        self.query_one("#detail-header", Static).update("\n".join(header_lines))
+
+        # Entity details and editable task outputs — mounted flat for scrolling
+        self._task_output_ids = []
+        flat_task_idx = 0
+        for ent_idx, ent in enumerate(entry.get("entities", [])):
+            etype = ent.get("type", "unknown")
+            ename = ent.get("name", "unnamed")
+            completed = ent.get("tasks_completed")
+            total = ent.get("tasks_total")
+            entity_title = f"[bold {_SECONDARY}]{etype}: {ename}[/]"
+            if completed is not None and total is not None:
+                entity_title += f"  [{_DIM}]{completed}/{total} tasks[/]"
+            await detail_scroll.mount(Static(entity_title, classes="entity-title"))
+            await detail_scroll.mount(
+                Static(_build_entity_header(ent), classes="entity-detail")
+            )
+
+            tasks = ent.get("tasks", [])
+            for i, task in enumerate(tasks):
+                desc = str(task.get("description", ""))
+                if len(desc) > 55:
+                    desc = desc[:52] + "..."
+                if task.get("completed"):
+                    icon = "[green]✓[/]"
+                    await detail_scroll.mount(
+                        Static(f"  {icon}  {i + 1}. {desc}", classes="task-label")
+                    )
+                    output_text = task.get("output", "")
+                    editor_id = f"task-output-{ent_idx}-{i}"
+                    await detail_scroll.mount(
+                        TextArea(
+                            str(output_text),
+                            classes="task-output-editor",
+                            id=editor_id,
+                        )
+                    )
+                    self._task_output_ids.append(
+                        (flat_task_idx, editor_id, str(output_text))
+                    )
+                else:
+                    icon = "[yellow]○[/]"
+                    await detail_scroll.mount(
+                        Static(f"  {icon}  {i + 1}. {desc}", classes="task-label")
+                    )
+                flat_task_idx += 1
+
+        # Build input fields
+        await self._build_input_fields(entry.get("inputs", {}))
+
+    async def _build_input_fields(self, inputs: dict[str, Any]) -> None:
+        """Rebuild the inputs section with one field per input key."""
+        section = self.query_one("#inputs-section")
+
+        # Remove old dynamic children — await so IDs are freed
+        for widget in list(section.query(".input-row, .no-inputs")):
+            await widget.remove()
+
+        self._input_keys = []
+
+        if not inputs:
+            await section.mount(Static(f"[{_DIM}]No inputs[/]", classes="no-inputs"))
+            section.add_class("visible")
+            return
+
+        for key, value in inputs.items():
+            self._input_keys.append(key)
+            row = Horizontal(classes="input-row")
+            row.compose_add_child(Static(f"[bold]{key}[/]"))
+            row.compose_add_child(
+                Input(value=str(value), placeholder=key, id=f"input-{key}")
+            )
+            await section.mount(row)
+
+        section.add_class("visible")
+
+    def _collect_inputs(self) -> dict[str, Any] | None:
+        """Collect current values from input fields."""
+        if not self._input_keys:
+            return None
+        result: dict[str, Any] = {}
+        for key in self._input_keys:
+            widget = self.query_one(f"#input-{key}", Input)
+            result[key] = widget.value
+        return result
+
+    def _collect_task_overrides(self) -> dict[int, str] | None:
+        """Collect edited task outputs. Returns only changed values."""
+        if not self._task_output_ids or self._selected_entry is None:
+            return None
+        overrides: dict[int, str] = {}
+        for task_idx, editor_id, original in self._task_output_ids:
+            editor = self.query_one(f"#{editor_id}", TextArea)
+            if editor.text != original:
+                overrides[task_idx] = editor.text
+        return overrides or None
+
+    def _resolve_location(self, entry: dict[str, Any]) -> str:
+        """Get the restore location string for a checkpoint entry."""
+        if "path" in entry:
+            return str(entry["path"])
+        if _is_sqlite(self._location):
+            return f"{self._location}#{entry['name']}"
+        return str(entry.get("name", ""))
+
+    async def on_tree_node_highlighted(
+        self, event: Tree.NodeHighlighted[dict[str, Any]]
+    ) -> None:
+        if event.node.data is not None:
+            await self._show_detail(event.node.data)
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        if self._selected_entry is None:
+            return
+        inputs = self._collect_inputs()
+        overrides = self._collect_task_overrides()
+        loc = self._resolve_location(self._selected_entry)
+        if event.button.id == "btn-resume":
+            self.exit((loc, "resume", inputs, overrides))
+        elif event.button.id == "btn-fork":
+            self.exit((loc, "fork", inputs, overrides))
 
     def action_refresh(self) -> None:
-        self._refresh_list()
+        self._refresh_tree()
 
 
 async def _run_checkpoint_tui_async(location: str) -> None:
@@ -345,18 +540,78 @@ async def _run_checkpoint_tui_async(location: str) -> None:
     import click
 
     app = CheckpointTUI(location=location)
-    selected = await app.run_async()
+    selection = await app.run_async()
 
-    if selected is None:
+    if selection is None:
         return
 
-    click.echo(f"\nResuming from: {selected}\n")
+    selected, action, inputs, task_overrides = selection
 
     from crewai.crew import Crew
     from crewai.state.checkpoint_config import CheckpointConfig
 
-    crew = Crew.from_checkpoint(CheckpointConfig(restore_from=selected))
-    result = await crew.akickoff()
+    config = CheckpointConfig(restore_from=selected)
+
+    if action == "fork":
+        click.echo(f"\nForking from: {selected}\n")
+        crew = Crew.fork(config)
+    else:
+        click.echo(f"\nResuming from: {selected}\n")
+        crew = Crew.from_checkpoint(config)
+
+    if task_overrides:
+        click.echo("Modifications:")
+        overridden_agents: set[int] = set()
+        for task_idx, new_output in task_overrides.items():
+            if task_idx < len(crew.tasks) and crew.tasks[task_idx].output is not None:
+                desc = crew.tasks[task_idx].description or f"Task {task_idx + 1}"
+                if len(desc) > 60:
+                    desc = desc[:57] + "..."
+                crew.tasks[task_idx].output.raw = new_output  # type: ignore[union-attr]
+                preview = new_output.replace("\n", " ")
+                if len(preview) > 80:
+                    preview = preview[:77] + "..."
+                click.echo(f"  Task {task_idx + 1}: {desc}")
+                click.echo(f"    -> {preview}")
+                agent = crew.tasks[task_idx].agent
+                if agent and agent.agent_executor:
+                    nth = sum(1 for t in crew.tasks[:task_idx] if t.agent is agent)
+                    messages = agent.agent_executor.messages
+                    system_positions = [
+                        i for i, m in enumerate(messages) if m.get("role") == "system"
+                    ]
+                    if nth < len(system_positions):
+                        seg_start = system_positions[nth]
+                        seg_end = (
+                            system_positions[nth + 1]
+                            if nth + 1 < len(system_positions)
+                            else len(messages)
+                        )
+                        for j in range(seg_end - 1, seg_start, -1):
+                            if messages[j].get("role") == "assistant":
+                                messages[j]["content"] = new_output
+                                break
+                    overridden_agents.add(id(agent))
+
+        earliest = min(task_overrides)
+        for offset, subsequent in enumerate(
+            crew.tasks[earliest + 1 :], start=earliest + 1
+        ):
+            if subsequent.output and offset not in task_overrides:
+                subsequent.output = None
+            if subsequent.agent and subsequent.agent.agent_executor:
+                subsequent.agent.agent_executor._resuming = False
+                if id(subsequent.agent) not in overridden_agents:
+                    subsequent.agent.agent_executor.messages = []
+        click.echo()
+
+    if inputs:
+        click.echo("Inputs:")
+        for k, v in inputs.items():
+            click.echo(f"  {k}: {v}")
+        click.echo()
+
+    result = await crew.akickoff(inputs=inputs)
     click.echo(f"\nResult: {getattr(result, 'raw', result)}")
 
 
diff --git a/lib/crewai/src/crewai/cli/cli.py b/lib/crewai/src/crewai/cli/cli.py
index 20a65dbe1..03bdcd502 100644
--- a/lib/crewai/src/crewai/cli/cli.py
+++ b/lib/crewai/src/crewai/cli/cli.py
@@ -793,6 +793,9 @@ def traces_status() -> None:
 @click.pass_context
 def checkpoint(ctx: click.Context, location: str) -> None:
     """Browse and inspect checkpoints. Launches a TUI when called without a subcommand."""
+    from crewai.cli.checkpoint_cli import _detect_location
+
+    location = _detect_location(location)
     ctx.ensure_object(dict)
     ctx.obj["location"] = location
     if ctx.invoked_subcommand is None:
@@ -805,18 +808,18 @@ def checkpoint(ctx: click.Context, location: str) -> None:
 @click.argument("location", default="./.checkpoints")
 def checkpoint_list(location: str) -> None:
     """List checkpoints in a directory."""
-    from crewai.cli.checkpoint_cli import list_checkpoints
+    from crewai.cli.checkpoint_cli import _detect_location, list_checkpoints
 
-    list_checkpoints(location)
+    list_checkpoints(_detect_location(location))
 
 
 @checkpoint.command("info")
 @click.argument("path", default="./.checkpoints")
 def checkpoint_info(path: str) -> None:
     """Show details of a checkpoint. Pass a file or directory for latest."""
-    from crewai.cli.checkpoint_cli import info_checkpoint
+    from crewai.cli.checkpoint_cli import _detect_location, info_checkpoint
 
-    info_checkpoint(path)
+    info_checkpoint(_detect_location(path))
 
 
 if __name__ == "__main__":
diff --git a/lib/crewai/src/crewai/crew.py b/lib/crewai/src/crewai/crew.py
index 111babbf3..de9a8f73d 100644
--- a/lib/crewai/src/crewai/crew.py
+++ b/lib/crewai/src/crewai/crew.py
@@ -436,6 +436,13 @@ class Crew(FlowTrackable, BaseModel):
                         if agent.agent_executor is not None and task.output is None:
                             agent.agent_executor.task = task
                         break
+        for task in self.tasks:
+            if task.checkpoint_original_description is not None:
+                task._original_description = task.checkpoint_original_description
+            if task.checkpoint_original_expected_output is not None:
+                task._original_expected_output = (
+                    task.checkpoint_original_expected_output
+                )
         if self.checkpoint_inputs is not None:
             self._inputs = self.checkpoint_inputs
         if self.checkpoint_kickoff_event_id is not None:
diff --git a/lib/crewai/src/crewai/state/checkpoint_config.py b/lib/crewai/src/crewai/state/checkpoint_config.py
index bd24ef8eb..e03964c05 100644
--- a/lib/crewai/src/crewai/state/checkpoint_config.py
+++ b/lib/crewai/src/crewai/state/checkpoint_config.py
@@ -213,6 +213,9 @@ class CheckpointConfig(BaseModel):
     def _register_handlers(self) -> CheckpointConfig:
         from crewai.state.checkpoint_listener import _ensure_handlers_registered
 
+        if isinstance(self.provider, SqliteProvider) and not Path(self.location).suffix:
+            self.location = f"{self.location}.db"
+
         _ensure_handlers_registered()
         return self
 
diff --git a/lib/crewai/src/crewai/state/checkpoint_listener.py b/lib/crewai/src/crewai/state/checkpoint_listener.py
index c2ac728a8..2408e88e3 100644
--- a/lib/crewai/src/crewai/state/checkpoint_listener.py
+++ b/lib/crewai/src/crewai/state/checkpoint_listener.py
@@ -7,6 +7,7 @@ avoids per-event overhead when no entity uses checkpointing.
 
 from __future__ import annotations
 
+import json
 import logging
 import threading
 from typing import Any
@@ -102,10 +103,15 @@ def _find_checkpoint(source: Any) -> CheckpointConfig | None:
     return None
 
 
-def _do_checkpoint(state: RuntimeState, cfg: CheckpointConfig) -> None:
+def _do_checkpoint(
+    state: RuntimeState, cfg: CheckpointConfig, event: BaseEvent | None = None
+) -> None:
     """Write a checkpoint and prune old ones if configured."""
     _prepare_entities(state.root)
-    data = state.model_dump_json()
+    payload = state.model_dump(mode="json")
+    if event is not None:
+        payload["trigger"] = event.type
+    data = json.dumps(payload)
     location = cfg.provider.checkpoint(
         data,
         cfg.location,
@@ -134,7 +140,7 @@ def _on_any_event(source: Any, event: BaseEvent, state: Any) -> None:
     if cfg is None:
         return
     try:
-        _do_checkpoint(state, cfg)
+        _do_checkpoint(state, cfg, event)
     except Exception:
         logger.warning("Auto-checkpoint failed for event %s", event.type, exc_info=True)
 
diff --git a/lib/crewai/src/crewai/state/runtime.py b/lib/crewai/src/crewai/state/runtime.py
index 3f32457bb..daae0620e 100644
--- a/lib/crewai/src/crewai/state/runtime.py
+++ b/lib/crewai/src/crewai/state/runtime.py
@@ -66,6 +66,9 @@ def _sync_checkpoint_fields(entity: object) -> None:
         entity.checkpoint_inputs = entity._inputs
         entity.checkpoint_train = entity._train
         entity.checkpoint_kickoff_event_id = entity._kickoff_event_id
+        for task in entity.tasks:
+            task.checkpoint_original_description = task._original_description
+            task.checkpoint_original_expected_output = task._original_expected_output
 
 
 def _migrate(data: dict[str, Any]) -> dict[str, Any]:
@@ -121,7 +124,7 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
             "parent_id": self._parent_id,
             "branch": self._branch,
             "entities": [e.model_dump(mode="json") for e in self.root],
-            "event_record": self._event_record.model_dump(),
+            "event_record": self._event_record.model_dump(mode="json"),
         }
 
     @model_validator(mode="wrap")
@@ -194,7 +197,10 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
         return result
 
     def fork(self, branch: str | None = None) -> None:
-        """Mark this state as a fork for subsequent checkpoints.
+        """Create a new execution branch and write an initial checkpoint.
+
+        If this state was restored from a checkpoint, an initial checkpoint
+        is written on the new branch so the fork point is recorded.
 
         Args:
             branch: Branch label. Auto-generated from the current checkpoint
@@ -204,7 +210,7 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
         if branch:
             self._branch = branch
         elif self._checkpoint_id:
-            self._branch = f"fork/{self._checkpoint_id}"
+            self._branch = f"fork/{self._checkpoint_id}_{uuid.uuid4().hex[:6]}"
         else:
             self._branch = f"fork/{uuid.uuid4().hex[:8]}"
 
@@ -227,6 +233,7 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
         provider = detect_provider(location)
         raw = provider.from_checkpoint(location)
         state = cls.model_validate_json(raw, **kwargs)
+        state._provider = provider
         checkpoint_id = provider.extract_id(location)
         state._checkpoint_id = checkpoint_id
         state._parent_id = checkpoint_id
@@ -253,6 +260,7 @@ class RuntimeState(RootModel):  # type: ignore[type-arg]
         provider = detect_provider(location)
         raw = await provider.afrom_checkpoint(location)
         state = cls.model_validate_json(raw, **kwargs)
+        state._provider = provider
         checkpoint_id = provider.extract_id(location)
         state._checkpoint_id = checkpoint_id
         state._parent_id = checkpoint_id
diff --git a/lib/crewai/src/crewai/task.py b/lib/crewai/src/crewai/task.py
index 4224828e3..0a159cb0e 100644
--- a/lib/crewai/src/crewai/task.py
+++ b/lib/crewai/src/crewai/task.py
@@ -230,6 +230,8 @@ class Task(BaseModel):
     _original_description: str | None = PrivateAttr(default=None)
     _original_expected_output: str | None = PrivateAttr(default=None)
     _original_output_file: str | None = PrivateAttr(default=None)
+    checkpoint_original_description: str | None = Field(default=None, exclude=False)
+    checkpoint_original_expected_output: str | None = Field(default=None, exclude=False)
     _thread: threading.Thread | None = PrivateAttr(default=None)
     model_config = {"arbitrary_types_allowed": True}
 
diff --git a/lib/crewai/tests/test_checkpoint.py b/lib/crewai/tests/test_checkpoint.py
index 1f1541790..f645541a4 100644
--- a/lib/crewai/tests/test_checkpoint.py
+++ b/lib/crewai/tests/test_checkpoint.py
@@ -296,7 +296,8 @@ class TestRuntimeStateLineage:
         state = self._make_state()
         state._checkpoint_id = "20260409T120000_abc12345"
         state.fork()
-        assert state._branch == "fork/20260409T120000_abc12345"
+        assert state._branch.startswith("fork/20260409T120000_abc12345_")
+        assert len(state._branch) == len("fork/20260409T120000_abc12345_") + 6
 
     def test_fork_no_checkpoint_id_unique(self) -> None:
         state = self._make_state()

From fe93333066d77ecfa01d3f2d56fb19a69a4b0b18 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Fri, 10 Apr 2026 21:51:51 +0800
Subject: [PATCH 26/70] feat: bump versions to 1.14.2a2

---
 lib/crewai-files/src/crewai_files/__init__.py           | 2 +-
 lib/crewai-tools/pyproject.toml                         | 2 +-
 lib/crewai-tools/src/crewai_tools/__init__.py           | 2 +-
 lib/crewai/pyproject.toml                               | 2 +-
 lib/crewai/src/crewai/__init__.py                       | 2 +-
 lib/crewai/src/crewai/cli/templates/crew/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/flow/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/tool/pyproject.toml | 2 +-
 lib/devtools/src/crewai_devtools/__init__.py            | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/lib/crewai-files/src/crewai_files/__init__.py b/lib/crewai-files/src/crewai_files/__init__.py
index a5372d385..824b6a5d2 100644
--- a/lib/crewai-files/src/crewai_files/__init__.py
+++ b/lib/crewai-files/src/crewai_files/__init__.py
@@ -152,4 +152,4 @@ __all__ = [
     "wrap_file_source",
 ]
 
-__version__ = "1.14.2a1"
+__version__ = "1.14.2a2"
diff --git a/lib/crewai-tools/pyproject.toml b/lib/crewai-tools/pyproject.toml
index 65c4fb112..2662344c0 100644
--- a/lib/crewai-tools/pyproject.toml
+++ b/lib/crewai-tools/pyproject.toml
@@ -10,7 +10,7 @@ requires-python = ">=3.10, <3.14"
 dependencies = [
     "pytube~=15.0.0",
     "requests~=2.32.5",
-    "crewai==1.14.2a1",
+    "crewai==1.14.2a2",
     "tiktoken~=0.8.0",
     "beautifulsoup4~=4.13.4",
     "python-docx~=1.2.0",
diff --git a/lib/crewai-tools/src/crewai_tools/__init__.py b/lib/crewai-tools/src/crewai_tools/__init__.py
index 2fd505221..9d26aea1d 100644
--- a/lib/crewai-tools/src/crewai_tools/__init__.py
+++ b/lib/crewai-tools/src/crewai_tools/__init__.py
@@ -305,4 +305,4 @@ __all__ = [
     "ZapierActionTools",
 ]
 
-__version__ = "1.14.2a1"
+__version__ = "1.14.2a2"
diff --git a/lib/crewai/pyproject.toml b/lib/crewai/pyproject.toml
index c9f072c90..d7f2a0651 100644
--- a/lib/crewai/pyproject.toml
+++ b/lib/crewai/pyproject.toml
@@ -55,7 +55,7 @@ Repository = "https://github.com/crewAIInc/crewAI"
 
 [project.optional-dependencies]
 tools = [
-    "crewai-tools==1.14.2a1",
+    "crewai-tools==1.14.2a2",
 ]
 embeddings = [
     "tiktoken~=0.8.0"
diff --git a/lib/crewai/src/crewai/__init__.py b/lib/crewai/src/crewai/__init__.py
index c5b941468..d680ca1a3 100644
--- a/lib/crewai/src/crewai/__init__.py
+++ b/lib/crewai/src/crewai/__init__.py
@@ -46,7 +46,7 @@ def _suppress_pydantic_deprecation_warnings() -> None:
 
 _suppress_pydantic_deprecation_warnings()
 
-__version__ = "1.14.2a1"
+__version__ = "1.14.2a2"
 _telemetry_submitted = False
 
 
diff --git a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
index 789088440..caaadafb8 100644
--- a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a1"
+    "crewai[tools]==1.14.2a2"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
index cdd22700f..6d3ab608b 100644
--- a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a1"
+    "crewai[tools]==1.14.2a2"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
index 8e1cb7c6e..0bb9ed6b4 100644
--- a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
@@ -5,7 +5,7 @@ description = "Power up your crews with {{folder_name}}"
 readme = "README.md"
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a1"
+    "crewai[tools]==1.14.2a2"
 ]
 
 [tool.crewai]
diff --git a/lib/devtools/src/crewai_devtools/__init__.py b/lib/devtools/src/crewai_devtools/__init__.py
index 36dec0c9d..18c3e995d 100644
--- a/lib/devtools/src/crewai_devtools/__init__.py
+++ b/lib/devtools/src/crewai_devtools/__init__.py
@@ -1,3 +1,3 @@
 """CrewAI development tools."""
 
-__version__ = "1.14.2a1"
+__version__ = "1.14.2a2"

From ea58f8d34dd6c4991a382d245fa38f6756f475c7 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Fri, 10 Apr 2026 21:58:55 +0800
Subject: [PATCH 27/70] docs: update changelog and version for v1.14.2a2

---
 docs/ar/changelog.mdx    | 27 +++++++++++++++++++++++++++
 docs/en/changelog.mdx    | 27 +++++++++++++++++++++++++++
 docs/ko/changelog.mdx    | 27 +++++++++++++++++++++++++++
 docs/pt-BR/changelog.mdx | 27 +++++++++++++++++++++++++++
 4 files changed, 108 insertions(+)

diff --git a/docs/ar/changelog.mdx b/docs/ar/changelog.mdx
index 177ac6142..73957dfd5 100644
--- a/docs/ar/changelog.mdx
+++ b/docs/ar/changelog.mdx
@@ -4,6 +4,33 @@ description: "تحديثات المنتج والتحسينات وإصلاحات
 icon: "clock"
 mode: "wide"
 ---
+<Update label="10 أبريل 2026">
+  ## v1.14.2a2
+
+  [عرض الإصدار على GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a2)
+
+  ## ما الذي تغير
+
+  ### الميزات
+  - إضافة واجهة مستخدم نصية لنقطة التحقق مع عرض شجري، ودعم التفرع، ومدخلات/مخرجات قابلة للتعديل
+  - إثراء تتبع رموز LLM مع رموز الاستدلال ورموز إنشاء التخزين المؤقت
+  - إضافة معلمة `from_checkpoint` إلى طرق الانطلاق
+  - تضمين `crewai_version` في نقاط التحقق مع إطار عمل الهجرة
+  - إضافة تفرع نقاط التحقق مع تتبع السلالة
+
+  ### إصلاحات الأخطاء
+  - إصلاح توجيه الوضع الصارم إلى مزودي Anthropic وBedrock
+  - تعزيز NL2SQLTool مع وضع القراءة فقط الافتراضي، والتحقق من الاستعلامات، والاستعلامات المعلمة
+
+  ### الوثائق
+  - تحديث سجل التغييرات والإصدار لـ v1.14.2a1
+
+  ## المساهمون
+
+  @alex-clawd, @github-actions[bot], @greysonlalonde, @lucasgomide
+
+</Update>
+
 <Update label="9 أبريل 2026">
   ## v1.14.2a1
 
diff --git a/docs/en/changelog.mdx b/docs/en/changelog.mdx
index b7a9b2645..b8e474d50 100644
--- a/docs/en/changelog.mdx
+++ b/docs/en/changelog.mdx
@@ -4,6 +4,33 @@ description: "Product updates, improvements, and bug fixes for CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="Apr 10, 2026">
+  ## v1.14.2a2
+
+  [View release on GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a2)
+
+  ## What's Changed
+
+  ### Features
+  - Add checkpoint TUI with tree view, fork support, and editable inputs/outputs
+  - Enrich LLM token tracking with reasoning tokens and cache creation tokens
+  - Add `from_checkpoint` parameter to kickoff methods
+  - Embed `crewai_version` in checkpoints with migration framework
+  - Add checkpoint forking with lineage tracking
+
+  ### Bug Fixes
+  - Fix strict mode forwarding to Anthropic and Bedrock providers
+  - Harden NL2SQLTool with read-only default, query validation, and parameterized queries
+
+  ### Documentation
+  - Update changelog and version for v1.14.2a1
+
+  ## Contributors
+
+  @alex-clawd, @github-actions[bot], @greysonlalonde, @lucasgomide
+
+</Update>
+
 <Update label="Apr 09, 2026">
   ## v1.14.2a1
 
diff --git a/docs/ko/changelog.mdx b/docs/ko/changelog.mdx
index f4e3ca546..ff9ea38ac 100644
--- a/docs/ko/changelog.mdx
+++ b/docs/ko/changelog.mdx
@@ -4,6 +4,33 @@ description: "CrewAI의 제품 업데이트, 개선 사항 및 버그 수정"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="2026년 4월 10일">
+  ## v1.14.2a2
+
+  [GitHub 릴리스 보기](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a2)
+
+  ## 변경 사항
+
+  ### 기능
+  - 트리 뷰, 포크 지원 및 편집 가능한 입력/출력을 갖춘 체크포인트 TUI 추가
+  - 추론 토큰 및 캐시 생성 토큰으로 LLM 토큰 추적 강화
+  - 킥오프 메서드에 `from_checkpoint` 매개변수 추가
+  - 마이그레이션 프레임워크와 함께 체크포인트에 `crewai_version` 포함
+  - 계보 추적이 가능한 체크포인트 포킹 추가
+
+  ### 버그 수정
+  - Anthropic 및 Bedrock 공급자로의 엄격 모드 포워딩 수정
+  - 읽기 전용 기본값, 쿼리 검증 및 매개변수화된 쿼리로 NL2SQLTool 강화
+
+  ### 문서
+  - v1.14.2a1에 대한 변경 로그 및 버전 업데이트
+
+  ## 기여자
+
+  @alex-clawd, @github-actions[bot], @greysonlalonde, @lucasgomide
+
+</Update>
+
 <Update label="2026년 4월 9일">
   ## v1.14.2a1
 
diff --git a/docs/pt-BR/changelog.mdx b/docs/pt-BR/changelog.mdx
index 45cc9943f..3eafc268a 100644
--- a/docs/pt-BR/changelog.mdx
+++ b/docs/pt-BR/changelog.mdx
@@ -4,6 +4,33 @@ description: "Atualizações de produto, melhorias e correções do CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="10 abr 2026">
+  ## v1.14.2a2
+
+  [Ver release no GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a2)
+
+  ## O que Mudou
+
+  ### Funcionalidades
+  - Adicionar TUI de ponto de verificação com visualização em árvore, suporte a bifurcações e entradas/saídas editáveis
+  - Enriquecer o rastreamento de tokens LLM com tokens de raciocínio e tokens de criação de cache
+  - Adicionar parâmetro `from_checkpoint` aos métodos de inicialização
+  - Incorporar `crewai_version` em pontos de verificação com o framework de migração
+  - Adicionar bifurcação de ponto de verificação com rastreamento de linhagem
+
+  ### Correções de Bugs
+  - Corrigir o encaminhamento em modo estrito para os provedores Anthropic e Bedrock
+  - Fortalecer NL2SQLTool com padrão somente leitura, validação de consultas e consultas parametrizadas
+
+  ### Documentação
+  - Atualizar changelog e versão para v1.14.2a1
+
+  ## Contributors
+
+  @alex-clawd, @github-actions[bot], @greysonlalonde, @lucasgomide
+
+</Update>
+
 <Update label="09 abr 2026">
   ## v1.14.2a1
 

From 7e1672447b4499574bad68e16261db2dc86ca523 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Sat, 11 Apr 2026 02:01:23 +0800
Subject: [PATCH 28/70] fix: deflake MemoryRecord embedding serialization test

Substring checks like `'0.1' not in json_str` collided with timestamps
such as `2026-04-10T13:00:50.140557` on CI. Round-trip through
`model_validate_json` to verify structurally that the embedding field
is absent from the serialized output.
---
 lib/crewai/tests/memory/test_unified_memory.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/lib/crewai/tests/memory/test_unified_memory.py b/lib/crewai/tests/memory/test_unified_memory.py
index 05bb977ac..be52e6db5 100644
--- a/lib/crewai/tests/memory/test_unified_memory.py
+++ b/lib/crewai/tests/memory/test_unified_memory.py
@@ -51,14 +51,13 @@ def test_memory_record_embedding_excluded_from_serialization() -> None:
     dumped = r.model_dump()
     assert "embedding" not in dumped
     assert dumped["content"] == "hello"
-
-    # model_dump_json excludes embedding
     json_str = r.model_dump_json()
-    assert "0.1" not in json_str
     assert "embedding" not in json_str
+    rehydrated = MemoryRecord.model_validate_json(json_str)
+    assert rehydrated.embedding is None
 
     # repr excludes embedding
-    assert "0.1" not in repr(r)
+    assert "embedding=" not in repr(r)
 
     # Direct attribute access still works for storage layer
     assert r.embedding is not None

From ace9617722063879ed11d8f3dc4a4c169d8299d3 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Sat, 11 Apr 2026 02:35:00 +0800
Subject: [PATCH 29/70] test: re-record hierarchical verbose manager cassette

---
 ...rarchical_verbose_false_manager_agent.yaml | 572 ++++++++++--------
 1 file changed, 303 insertions(+), 269 deletions(-)

diff --git a/lib/crewai/tests/cassettes/test_hierarchical_verbose_false_manager_agent.yaml b/lib/crewai/tests/cassettes/test_hierarchical_verbose_false_manager_agent.yaml
index 6bd4c405c..994e3b9e6 100644
--- a/lib/crewai/tests/cassettes/test_hierarchical_verbose_false_manager_agent.yaml
+++ b/lib/crewai/tests/cassettes/test_hierarchical_verbose_false_manager_agent.yaml
@@ -55,7 +55,7 @@ interactions:
       x-stainless-os:
       - X-STAINLESS-OS-XXX
       x-stainless-package-version:
-      - 1.83.0
+      - 2.31.0
       x-stainless-read-timeout:
       - X-STAINLESS-READ-TIMEOUT-XXX
       x-stainless-retry-count:
@@ -63,50 +63,51 @@ interactions:
       x-stainless-runtime:
       - CPython
       x-stainless-runtime-version:
-      - 3.13.3
+      - 3.13.12
     method: POST
     uri: https://api.openai.com/v1/chat/completions
   response:
     body:
-      string: "{\n  \"id\": \"chatcmpl-DIqxWpJbbFJoV8WlXhb9UYFbCmdPk\",\n  \"object\":
-        \"chat.completion\",\n  \"created\": 1773385850,\n  \"model\": \"gpt-4o-2024-08-06\",\n
+      string: "{\n  \"id\": \"chatcmpl-DTApYQx2LepfeRL1XcDKPgrhMFnQr\",\n  \"object\":
+        \"chat.completion\",\n  \"created\": 1775845516,\n  \"model\": \"gpt-4o-2024-08-06\",\n
         \ \"choices\": [\n    {\n      \"index\": 0,\n      \"message\": {\n        \"role\":
         \"assistant\",\n        \"content\": null,\n        \"tool_calls\": [\n          {\n
-        \           \"id\": \"call_G2i9RJGNXKVfnd8ZTaBG8Fwi\",\n            \"type\":
-        \"function\",\n            \"function\": {\n              \"name\": \"ask_question_to_coworker\",\n
-        \             \"arguments\": \"{\\\"question\\\": \\\"What are some trending
-        topics or ideas in various fields that could be explored for an article?\\\",
-        \\\"context\\\": \\\"We need to generate a list of 5 interesting ideas to
-        explore for an article. These ideas should be engaging and relevant to current
-        trends or captivating subjects.\\\", \\\"coworker\\\": \\\"Researcher\\\"}\"\n
-        \           }\n          },\n          {\n            \"id\": \"call_j4KH2SGZvNeioql0HcRQ9NTp\",\n
+        \           \"id\": \"call_BCh6lXsBTdixRuRh6OTBPoIJ\",\n            \"type\":
+        \"function\",\n            \"function\": {\n              \"name\": \"delegate_work_to_coworker\",\n
+        \             \"arguments\": \"{\\\"task\\\": \\\"Come up with a list of 5
+        interesting ideas to explore for an article.\\\", \\\"context\\\": \\\"We
+        need five intriguing ideas worth exploring for an article. Each idea should
+        have potential for in-depth exploration and appeal to a broad audience, possibly
+        touching on current trends, historical insights, future possibilities, or
+        human interest stories.\\\", \\\"coworker\\\": \\\"Researcher\\\"}\"\n            }\n
+        \         },\n          {\n            \"id\": \"call_rAQFeCrS4ogsqvIWRGAYFHGI\",\n
         \           \"type\": \"function\",\n            \"function\": {\n              \"name\":
-        \"ask_question_to_coworker\",\n              \"arguments\": \"{\\\"question\\\":
-        \\\"What unique angles or perspectives could we explore to make articles more
-        compelling and engaging?\\\", \\\"context\\\": \\\"Our task involves coming
-        up with 5 ideas for articles, each with an exciting paragraph highlight that
-        illustrates the promise and intrigue of the topic. We want them to be more
-        than generic concepts, shining for readers with fresh insights or engaging
-        twists.\\\", \\\"coworker\\\": \\\"Senior Writer\\\"}\"\n            }\n          }\n
-        \       ],\n        \"refusal\": null,\n        \"annotations\": []\n      },\n
-        \     \"logprobs\": null,\n      \"finish_reason\": \"tool_calls\"\n    }\n
-        \ ],\n  \"usage\": {\n    \"prompt_tokens\": 476,\n    \"completion_tokens\":
-        183,\n    \"total_tokens\": 659,\n    \"prompt_tokens_details\": {\n      \"cached_tokens\":
-        0,\n      \"audio_tokens\": 0\n    },\n    \"completion_tokens_details\":
+        \"delegate_work_to_coworker\",\n              \"arguments\": \"{\\\"task\\\":
+        \\\"Write one amazing paragraph highlight for each of 5 ideas that showcases
+        how good an article about this topic could be.\\\", \\\"context\\\": \\\"Upon
+        receiving five intriguing ideas from the Researcher, create a compelling paragraph
+        for each idea that highlights its potential as a fascinating article. These
+        paragraphs must capture the essence of the topic and explain why it would
+        captivate readers, incorporating possible themes and insights.\\\", \\\"coworker\\\":
+        \\\"Senior Writer\\\"}\"\n            }\n          }\n        ],\n        \"refusal\":
+        null,\n        \"annotations\": []\n      },\n      \"logprobs\": null,\n
+        \     \"finish_reason\": \"tool_calls\"\n    }\n  ],\n  \"usage\": {\n    \"prompt_tokens\":
+        476,\n    \"completion_tokens\": 201,\n    \"total_tokens\": 677,\n    \"prompt_tokens_details\":
+        {\n      \"cached_tokens\": 0,\n      \"audio_tokens\": 0\n    },\n    \"completion_tokens_details\":
         {\n      \"reasoning_tokens\": 0,\n      \"audio_tokens\": 0,\n      \"accepted_prediction_tokens\":
         0,\n      \"rejected_prediction_tokens\": 0\n    }\n  },\n  \"service_tier\":
-        \"default\",\n  \"system_fingerprint\": \"fp_b7c8e3f100\"\n}\n"
+        \"default\",\n  \"system_fingerprint\": \"fp_2ca5b70601\"\n}\n"
     headers:
       CF-Cache-Status:
       - DYNAMIC
       CF-Ray:
-      - 9db9389a3f9e424c-EWR
+      - 9ea3cb06ba66b301-TPE
       Connection:
       - keep-alive
       Content-Type:
       - application/json
       Date:
-      - Fri, 13 Mar 2026 07:10:53 GMT
+      - Fri, 10 Apr 2026 18:25:18 GMT
       Server:
       - cloudflare
       Strict-Transport-Security:
@@ -122,7 +123,7 @@ interactions:
       openai-organization:
       - OPENAI-ORG-XXX
       openai-processing-ms:
-      - '2402'
+      - '1981'
       openai-project:
       - OPENAI-PROJECT-XXX
       openai-version:
@@ -154,13 +155,14 @@ interactions:
       You work as a freelancer and is now working on doing research and analysis for
       a new customer.\nYour personal goal is: Make the best research and analysis
       on content about AI and AI agents"},{"role":"user","content":"\nCurrent Task:
-      What are some trending topics or ideas in various fields that could be explored
-      for an article?\n\nThis is the expected criteria for your final answer: Your
-      best answer to your coworker asking you this, accounting for the context shared.\nyou
-      MUST return the actual complete content as the final answer, not a summary.\n\nThis
-      is the context you''re working with:\nWe need to generate a list of 5 interesting
-      ideas to explore for an article. These ideas should be engaging and relevant
-      to current trends or captivating subjects.\n\nProvide your complete response:"}],"model":"gpt-4.1-mini"}'
+      Come up with a list of 5 interesting ideas to explore for an article.\n\nThis
+      is the expected criteria for your final answer: Your best answer to your coworker
+      asking you this, accounting for the context shared.\nyou MUST return the actual
+      complete content as the final answer, not a summary.\n\nThis is the context
+      you''re working with:\nWe need five intriguing ideas worth exploring for an
+      article. Each idea should have potential for in-depth exploration and appeal
+      to a broad audience, possibly touching on current trends, historical insights,
+      future possibilities, or human interest stories.\n\nProvide your complete response:"}],"model":"gpt-4.1-mini"}'
     headers:
       User-Agent:
       - X-USER-AGENT-XXX
@@ -173,7 +175,7 @@ interactions:
       connection:
       - keep-alive
       content-length:
-      - '978'
+      - '1046'
       content-type:
       - application/json
       host:
@@ -187,7 +189,7 @@ interactions:
       x-stainless-os:
       - X-STAINLESS-OS-XXX
       x-stainless-package-version:
-      - 1.83.0
+      - 2.31.0
       x-stainless-read-timeout:
       - X-STAINLESS-READ-TIMEOUT-XXX
       x-stainless-retry-count:
@@ -195,63 +197,69 @@ interactions:
       x-stainless-runtime:
       - CPython
       x-stainless-runtime-version:
-      - 3.13.3
+      - 3.13.12
     method: POST
     uri: https://api.openai.com/v1/chat/completions
   response:
     body:
-      string: "{\n  \"id\": \"chatcmpl-DIqxak88AexErt9PGFGHnWPIJLwNV\",\n  \"object\":
-        \"chat.completion\",\n  \"created\": 1773385854,\n  \"model\": \"gpt-4.1-mini-2025-04-14\",\n
+      string: "{\n  \"id\": \"chatcmpl-DTApalbfnYkqIc8slLS3DKwo9KXbc\",\n  \"object\":
+        \"chat.completion\",\n  \"created\": 1775845518,\n  \"model\": \"gpt-4.1-mini-2025-04-14\",\n
         \ \"choices\": [\n    {\n      \"index\": 0,\n      \"message\": {\n        \"role\":
-        \"assistant\",\n        \"content\": \"Here are five trending and engaging
-        topics across various fields that could be explored for an article:\\n\\n1.
-        **The Rise of Autonomous AI Agents and Their Impact on the Future of Work**
-        \ \\nExplore how autonomous AI agents\u2014systems capable of performing complex
-        tasks independently\u2014are transforming industries such as customer service,
-        software development, and logistics. Discuss implications for job automation,
-        human-AI collaboration, and ethical considerations surrounding decision-making
-        autonomy.\\n\\n2. **Generative AI Beyond Text: Innovations in Audio, Video,
-        and 3D Content Creation**  \\nDelve into advancements in generative AI models
-        that create not only text but also realistic audio, video content, virtual
-        environments, and 3D models. Highlight applications in gaming, entertainment,
-        education, and digital marketing, as well as challenges like misinformation
-        and deepfake detection.\\n\\n3. **AI-Driven Climate Modeling: Enhancing Predictive
-        Accuracy to Combat Climate Change**  \\nExamine how AI and machine learning
-        are improving climate models by analyzing vast datasets, uncovering patterns,
-        and simulating environmental scenarios. Discuss how these advances are aiding
-        policymakers in making informed decisions to address climate risks and sustainability
-        goals.\\n\\n4. **The Ethical Frontiers of AI in Healthcare: Balancing Innovation
-        with Patient Privacy**  \\nInvestigate ethical challenges posed by AI applications
-        in healthcare, including diagnosis, personalized treatment, and patient data
-        management. Focus on balancing rapid technological innovation with privacy,
-        bias mitigation, and regulatory frameworks to ensure equitable access and
-        trust.\\n\\n5. **Quantum Computing Meets AI: Exploring the Next Leap in Computational
-        Power**  \\nCover the intersection of quantum computing and artificial intelligence,
-        exploring how quantum algorithms could accelerate AI training processes and
-        solve problems beyond the reach of classical computers. Outline current research,
-        potential breakthroughs, and the timeline for real-world applications.\\n\\nEach
-        of these topics is timely, relevant, and has the potential to engage readers
-        interested in cutting-edge technology, societal impact, and future trends.
-        Let me know if you want me to help develop an outline or deeper research into
-        any of these areas!\",\n        \"refusal\": null,\n        \"annotations\":
-        []\n      },\n      \"logprobs\": null,\n      \"finish_reason\": \"stop\"\n
-        \   }\n  ],\n  \"usage\": {\n    \"prompt_tokens\": 178,\n    \"completion_tokens\":
-        402,\n    \"total_tokens\": 580,\n    \"prompt_tokens_details\": {\n      \"cached_tokens\":
+        \"assistant\",\n        \"content\": \"Certainly! Here are five intriguing
+        article ideas that offer rich potential for deep exploration and broad audience
+        appeal, especially aligned with current trends and human interest in AI and
+        technology:\\n\\n1. **The Evolution of AI Agents: From Rule-Based Bots to
+        Autonomous Decision Makers**  \\n   Explore the historical development of
+        AI agents, tracing the journey from simple scripted chatbots to advanced autonomous
+        systems capable of complex decision-making and learning. Dive into key technological
+        milestones, breakthroughs in machine learning, and current state-of-the-art
+        AI agents. Discuss implications for industries such as customer service, healthcare,
+        and autonomous vehicles, highlighting both opportunities and ethical concerns.\\n\\n2.
+        **AI in Daily Life: How Intelligent Agents Are Reshaping Human Routines**
+        \ \\n   Investigate the integration of AI agents in everyday life\u2014from
+        virtual assistants like Siri and Alexa to personalized recommendation systems
+        and smart home devices. Analyze how these AI tools influence productivity,
+        privacy, and social behavior. Include human interest elements through stories
+        of individuals or communities who have embraced or resisted these technologies.\\n\\n3.
+        **The Future of Work: AI Agents as Collaborative Colleagues**  \\n   Examine
+        how AI agents are transforming workplaces by acting as collaborators rather
+        than just tools. Cover applications in creative fields, data analysis, and
+        decision support, while addressing potential challenges such as job displacement,
+        new skill requirements, and the evolving definition of teamwork. Use expert
+        opinions and case studies to paint a nuanced future outlook.\\n\\n4. **Ethics
+        and Accountability in AI Agent Development**  \\n   Delve into the ethical
+        dilemmas posed by increasingly autonomous AI agents\u2014topics like bias
+        in algorithms, data privacy, and accountability for AI-driven decisions. Explore
+        measures being taken globally to regulate AI, frameworks for responsible AI
+        development, and the role of public awareness. Include historical context
+        about technology ethics to provide depth.\\n\\n5. **Human-AI Symbiosis: Stories
+        of Innovative Partnerships Shaping Our World**  \\n   Tell compelling human
+        interest stories about individuals or organizations pioneering collaborative
+        projects with AI agents that lead to breakthroughs in science, art, or social
+        good. Highlight how these partnerships transcend traditional human-machine
+        interaction and open new creative and problem-solving possibilities, inspiring
+        readers about the potential of human-AI synergy.\\n\\nThese ideas are designed
+        to be both engaging and informative, offering multiple angles\u2014technical,
+        historical, ethical, and personal\u2014to keep readers captivated while providing
+        substantial content for in-depth analysis.\",\n        \"refusal\": null,\n
+        \       \"annotations\": []\n      },\n      \"logprobs\": null,\n      \"finish_reason\":
+        \"stop\"\n    }\n  ],\n  \"usage\": {\n    \"prompt_tokens\": 189,\n    \"completion_tokens\":
+        472,\n    \"total_tokens\": 661,\n    \"prompt_tokens_details\": {\n      \"cached_tokens\":
         0,\n      \"audio_tokens\": 0\n    },\n    \"completion_tokens_details\":
         {\n      \"reasoning_tokens\": 0,\n      \"audio_tokens\": 0,\n      \"accepted_prediction_tokens\":
         0,\n      \"rejected_prediction_tokens\": 0\n    }\n  },\n  \"service_tier\":
-        \"default\",\n  \"system_fingerprint\": \"fp_e76a310957\"\n}\n"
+        \"default\",\n  \"system_fingerprint\": \"fp_fbf43a1ff3\"\n}\n"
     headers:
       CF-Cache-Status:
       - DYNAMIC
       CF-Ray:
-      - 9db938b0493c4b9f-EWR
+      - 9ea3cb1b5c943323-TPE
       Connection:
       - keep-alive
       Content-Type:
       - application/json
       Date:
-      - Fri, 13 Mar 2026 07:10:59 GMT
+      - Fri, 10 Apr 2026 18:25:25 GMT
       Server:
       - cloudflare
       Strict-Transport-Security:
@@ -267,7 +275,7 @@ interactions:
       openai-organization:
       - OPENAI-ORG-XXX
       openai-processing-ms:
-      - '5699'
+      - '6990'
       openai-project:
       - OPENAI-PROJECT-XXX
       openai-version:
@@ -298,15 +306,16 @@ interactions:
       a senior writer, specialized in technology, software engineering, AI and startups.
       You work as a freelancer and are now working on writing content for a new customer.\nYour
       personal goal is: Write the best content about AI and AI agents."},{"role":"user","content":"\nCurrent
-      Task: What unique angles or perspectives could we explore to make articles more
-      compelling and engaging?\n\nThis is the expected criteria for your final answer:
-      Your best answer to your coworker asking you this, accounting for the context
-      shared.\nyou MUST return the actual complete content as the final answer, not
-      a summary.\n\nThis is the context you''re working with:\nOur task involves coming
-      up with 5 ideas for articles, each with an exciting paragraph highlight that
-      illustrates the promise and intrigue of the topic. We want them to be more than
-      generic concepts, shining for readers with fresh insights or engaging twists.\n\nProvide
-      your complete response:"}],"model":"gpt-4.1-mini"}'
+      Task: Write one amazing paragraph highlight for each of 5 ideas that showcases
+      how good an article about this topic could be.\n\nThis is the expected criteria
+      for your final answer: Your best answer to your coworker asking you this, accounting
+      for the context shared.\nyou MUST return the actual complete content as the
+      final answer, not a summary.\n\nThis is the context you''re working with:\nUpon
+      receiving five intriguing ideas from the Researcher, create a compelling paragraph
+      for each idea that highlights its potential as a fascinating article. These
+      paragraphs must capture the essence of the topic and explain why it would captivate
+      readers, incorporating possible themes and insights.\n\nProvide your complete
+      response:"}],"model":"gpt-4.1-mini"}'
     headers:
       User-Agent:
       - X-USER-AGENT-XXX
@@ -319,7 +328,7 @@ interactions:
       connection:
       - keep-alive
       content-length:
-      - '1041'
+      - '1103'
       content-type:
       - application/json
       host:
@@ -333,7 +342,7 @@ interactions:
       x-stainless-os:
       - X-STAINLESS-OS-XXX
       x-stainless-package-version:
-      - 1.83.0
+      - 2.31.0
       x-stainless-read-timeout:
       - X-STAINLESS-READ-TIMEOUT-XXX
       x-stainless-retry-count:
@@ -341,78 +350,83 @@ interactions:
       x-stainless-runtime:
       - CPython
       x-stainless-runtime-version:
-      - 3.13.3
+      - 3.13.12
     method: POST
     uri: https://api.openai.com/v1/chat/completions
   response:
     body:
-      string: "{\n  \"id\": \"chatcmpl-DIqxZCl1kFIE7WXznIKow9QFNZ2QT\",\n  \"object\":
-        \"chat.completion\",\n  \"created\": 1773385853,\n  \"model\": \"gpt-4.1-mini-2025-04-14\",\n
+      string: "{\n  \"id\": \"chatcmpl-DTApbrh9Z4yFAKPHIR48ubdB1R5xK\",\n  \"object\":
+        \"chat.completion\",\n  \"created\": 1775845519,\n  \"model\": \"gpt-4.1-mini-2025-04-14\",\n
         \ \"choices\": [\n    {\n      \"index\": 0,\n      \"message\": {\n        \"role\":
-        \"assistant\",\n        \"content\": \"Absolutely! To create compelling and
-        engaging AI articles that stand out, we need to go beyond surface-level discussions
-        and deliver fresh perspectives that challenge assumptions and spark curiosity.
-        Here are five unique angles with their highlight paragraphs that could really
-        captivate our readers:\\n\\n1. **The Hidden Psychology of AI Agents: How They
-        Learn Human Biases and What That Means for Our Future**  \\n*Highlight:* AI
-        agents don\u2019t just process data\u2014they absorb the subtle nuances and
-        biases embedded in human language, behavior, and culture. This article dives
-        deep into the psychological parallels between AI learning mechanisms and human
-        cognitive biases, revealing surprising ways AI can both mirror and amplify
-        our prejudices. Understanding these dynamics is crucial for building trustworthy
-        AI systems and reshaping the future relationship between humans and machines.\\n\\n2.
-        **From Assistants to Autonomous Creators: The Rise of AI Agents as Artists,
-        Writers, and Innovators**  \\n*Highlight:* What do we lose and gain when AI
-        agents start producing original art, literature, and innovations? This piece
-        explores groundbreaking examples where AI isn\u2019t just a tool but a creative
-        partner that challenges our definition of authorship and genius. We\u2019ll
-        examine ethical dilemmas, collaborative workflows, and the exciting frontier
-        where human intuition meets algorithmic originality.\\n\\n3. **AI Agents in
-        the Wild: How Decentralized Autonomous Organizations Could Redefine Economy
-        and Governance**  \\n*Highlight:* Imagine AI agents operating autonomously
-        in decentralized networks, making real-time decisions that affect finances,
-        resource management, and governance without human intervention. This article
-        uncovers how DAOs powered by AI agents might spontaneously evolve new forms
-        of organization\u2014transparent, efficient, and resistant to traditional
-        corruption. We\u2019ll investigate early case studies and speculate on how
-        this might disrupt centuries-old societal structures.\\n\\n4. **Beyond Chatbots:
-        The Next Generation of AI Agents as Empathetic Digital Companions**  \\n*Highlight:*
-        Moving past scripted conversations, emerging AI agents simulate empathy and
-        emotional intelligence in ways that can transform mental health care, education,
-        and companionship. This article provides an insider look at the complex algorithms
-        and biofeedback mechanisms enabling AI to recognize, respond to, and foster
-        human emotions\u2014potentially filling gaps in underserved populations while
-        raising profound questions about authenticity and connection.\\n\\n5. **The
-        Environmental Toll of AI Agents: Unmasking the Ecological Cost of Intelligent
-        Automation**  \\n*Highlight:* While AI promises efficiency and innovation,
-        the environmental footprint of training and deploying millions of AI agents
-        is rarely discussed. This eye-opening article quantifies the energy demands
-        of current models, challenges the narrative of AI as an unequivocal green
-        solution, and explores emerging approaches pathing toward sustainable intelligent
-        automation\u2014an urgent conversation for an increasingly eco-conscious tech
-        landscape.\\n\\nEach of these angles opens a door to rich storytelling that
-        blends technical depth, ethical inquiry, and visionary implications\u2014perfect
-        for readers hungry for insight that\u2019s both sophisticated and accessible.
-        Let me know which ones resonate most, or if you want me to refine any into
-        full article outlines!\",\n        \"refusal\": null,\n        \"annotations\":
-        []\n      },\n      \"logprobs\": null,\n      \"finish_reason\": \"stop\"\n
-        \   }\n  ],\n  \"usage\": {\n    \"prompt_tokens\": 188,\n    \"completion_tokens\":
-        595,\n    \"total_tokens\": 783,\n    \"prompt_tokens_details\": {\n      \"cached_tokens\":
-        0,\n      \"audio_tokens\": 0\n    },\n    \"completion_tokens_details\":
+        \"assistant\",\n        \"content\": \"1. **The Rise of Autonomous AI Agents:
+        Revolutionizing Everyday Tasks**  \\nImagine a world where AI agents autonomously
+        manage your daily schedule, optimize your work routines, and even handle complex
+        decision-making with minimal human intervention. An article exploring the
+        rise of autonomous AI agents would captivate readers by diving into how advancements
+        in machine learning and natural language processing have matured these agents
+        from simple chatbots to intelligent collaborators. Themes could include practical
+        applications in industries like healthcare, finance, and personal productivity,
+        the challenges of trust and transparency, and a glimpse into the ethical questions
+        surrounding AI autonomy. This topic not only showcases cutting-edge technology
+        but also invites readers to envision the near future of human-AI synergy.\\n\\n2.
+        **Building Ethical AI Agents: Balancing Innovation with Responsibility**  \\nAs
+        AI agents become more powerful and independent, the imperative to embed ethical
+        frameworks within their design comes sharply into focus. An insightful article
+        on this theme would engage readers by unpacking the complexities of programming
+        morality, fairness, and accountability into AI systems that influence critical
+        decisions\u2014whether in hiring processes, law enforcement, or digital content
+        moderation. Exploring real-world case studies alongside philosophical and
+        regulatory perspectives, the piece could illuminate the delicate balance between
+        technological innovation and societal values, offering a nuanced discussion
+        that appeals to technologists, ethicists, and everyday users alike.\\n\\n3.
+        **AI Agents in Startups: Accelerating Growth and Disrupting Markets**  \\nStartups
+        are uniquely positioned to leverage AI agents as game-changers that turbocharge
+        growth, optimize workflows, and unlock new business models. This article could
+        enthrall readers by detailing how nimble companies integrate AI-driven agents
+        for customer engagement, market analysis, and personalized product recommendations\u2014outpacing
+        larger incumbents. It would also examine hurdles such as data privacy, scaling
+        complexities, and the human-AI collaboration dynamic, providing actionable
+        insights for entrepreneurs and investors. The story of AI agents fueling startup
+        innovation not only inspires but also outlines the practical pathways and
+        pitfalls on the frontier of modern entrepreneurship.\\n\\n4. **The Future
+        of Work with AI Agents: Redefining Roles and Skills**  \\nAI agents are redefining
+        professional landscapes by automating routine tasks and augmenting human creativity
+        and decision-making. An article on this topic could engage readers by painting
+        a vivid picture of the evolving workplace, where collaboration between humans
+        and AI agents becomes the norm. Delving into emerging roles, necessary skill
+        sets, and how education and training must adapt, the piece would offer a forward-thinking
+        analysis that resonates deeply with employees, managers, and policymakers.
+        Exploring themes of workforce transformation, productivity gains, and potential
+        socioeconomic impacts, it provides a comprehensive outlook on an AI-integrated
+        work environment.\\n\\n5. **From Reactive to Proactive: How Next-Gen AI Agents
+        Anticipate Needs**  \\nThe leap from reactive AI assistants to truly proactive
+        AI agents signifies one of the most thrilling advances in artificial intelligence.
+        An article centered on this evolution would captivate readers by illustrating
+        how these agents utilize predictive analytics, contextual understanding, and
+        continuous learning to anticipate user needs before they are expressed. By
+        showcasing pioneering applications in personalized healthcare management,
+        smart homes, and adaptive learning platforms, the article would highlight
+        the profound shift toward intuitive, anticipatory technology. This theme not
+        only excites with futuristic promise but also probes the technical and privacy
+        challenges that come with increased agency and foresight.\",\n        \"refusal\":
+        null,\n        \"annotations\": []\n      },\n      \"logprobs\": null,\n
+        \     \"finish_reason\": \"stop\"\n    }\n  ],\n  \"usage\": {\n    \"prompt_tokens\":
+        197,\n    \"completion_tokens\": 666,\n    \"total_tokens\": 863,\n    \"prompt_tokens_details\":
+        {\n      \"cached_tokens\": 0,\n      \"audio_tokens\": 0\n    },\n    \"completion_tokens_details\":
         {\n      \"reasoning_tokens\": 0,\n      \"audio_tokens\": 0,\n      \"accepted_prediction_tokens\":
         0,\n      \"rejected_prediction_tokens\": 0\n    }\n  },\n  \"service_tier\":
-        \"default\",\n  \"system_fingerprint\": \"fp_ae0f8c9a7b\"\n}\n"
+        \"default\",\n  \"system_fingerprint\": \"fp_d45f83c5fd\"\n}\n"
     headers:
       CF-Cache-Status:
       - DYNAMIC
       CF-Ray:
-      - 9db938b0489680d4-EWR
+      - 9ea3cb1cbfe2b312-TPE
       Connection:
       - keep-alive
       Content-Type:
       - application/json
       Date:
-      - Fri, 13 Mar 2026 07:11:02 GMT
+      - Fri, 10 Apr 2026 18:25:28 GMT
       Server:
       - cloudflare
       Strict-Transport-Security:
@@ -428,7 +442,7 @@ interactions:
       openai-organization:
       - OPENAI-ORG-XXX
       openai-processing-ms:
-      - '8310'
+      - '9479'
       openai-project:
       - OPENAI-PROJECT-XXX
       openai-version:
@@ -467,91 +481,105 @@ interactions:
       good an article about this topic could be. Return the list of ideas with their
       paragraph and your notes.\\n\\nThis is the expected criteria for your final
       answer: 5 bullet points with a paragraph for each idea.\\nyou MUST return the
-      actual complete content as the final answer, not a summary.\"},{\"role\":\"assistant\",\"content\":null,\"tool_calls\":[{\"id\":\"call_G2i9RJGNXKVfnd8ZTaBG8Fwi\",\"type\":\"function\",\"function\":{\"name\":\"ask_question_to_coworker\",\"arguments\":\"{\\\"question\\\":
-      \\\"What are some trending topics or ideas in various fields that could be explored
-      for an article?\\\", \\\"context\\\": \\\"We need to generate a list of 5 interesting
-      ideas to explore for an article. These ideas should be engaging and relevant
-      to current trends or captivating subjects.\\\", \\\"coworker\\\": \\\"Researcher\\\"}\"}},{\"id\":\"call_j4KH2SGZvNeioql0HcRQ9NTp\",\"type\":\"function\",\"function\":{\"name\":\"ask_question_to_coworker\",\"arguments\":\"{\\\"question\\\":
-      \\\"What unique angles or perspectives could we explore to make articles more
-      compelling and engaging?\\\", \\\"context\\\": \\\"Our task involves coming
-      up with 5 ideas for articles, each with an exciting paragraph highlight that
-      illustrates the promise and intrigue of the topic. We want them to be more than
-      generic concepts, shining for readers with fresh insights or engaging twists.\\\",
-      \\\"coworker\\\": \\\"Senior Writer\\\"}\"}}]},{\"role\":\"tool\",\"tool_call_id\":\"call_G2i9RJGNXKVfnd8ZTaBG8Fwi\",\"name\":\"ask_question_to_coworker\",\"content\":\"Here
-      are five trending and engaging topics across various fields that could be explored
-      for an article:\\n\\n1. **The Rise of Autonomous AI Agents and Their Impact
-      on the Future of Work**  \\nExplore how autonomous AI agents\u2014systems capable
-      of performing complex tasks independently\u2014are transforming industries such
-      as customer service, software development, and logistics. Discuss implications
-      for job automation, human-AI collaboration, and ethical considerations surrounding
-      decision-making autonomy.\\n\\n2. **Generative AI Beyond Text: Innovations in
-      Audio, Video, and 3D Content Creation**  \\nDelve into advancements in generative
-      AI models that create not only text but also realistic audio, video content,
-      virtual environments, and 3D models. Highlight applications in gaming, entertainment,
-      education, and digital marketing, as well as challenges like misinformation
-      and deepfake detection.\\n\\n3. **AI-Driven Climate Modeling: Enhancing Predictive
-      Accuracy to Combat Climate Change**  \\nExamine how AI and machine learning
-      are improving climate models by analyzing vast datasets, uncovering patterns,
-      and simulating environmental scenarios. Discuss how these advances are aiding
-      policymakers in making informed decisions to address climate risks and sustainability
-      goals.\\n\\n4. **The Ethical Frontiers of AI in Healthcare: Balancing Innovation
-      with Patient Privacy**  \\nInvestigate ethical challenges posed by AI applications
-      in healthcare, including diagnosis, personalized treatment, and patient data
-      management. Focus on balancing rapid technological innovation with privacy,
-      bias mitigation, and regulatory frameworks to ensure equitable access and trust.\\n\\n5.
-      **Quantum Computing Meets AI: Exploring the Next Leap in Computational Power**
-      \ \\nCover the intersection of quantum computing and artificial intelligence,
-      exploring how quantum algorithms could accelerate AI training processes and
-      solve problems beyond the reach of classical computers. Outline current research,
-      potential breakthroughs, and the timeline for real-world applications.\\n\\nEach
-      of these topics is timely, relevant, and has the potential to engage readers
-      interested in cutting-edge technology, societal impact, and future trends. Let
-      me know if you want me to help develop an outline or deeper research into any
-      of these areas!\"},{\"role\":\"tool\",\"tool_call_id\":\"call_j4KH2SGZvNeioql0HcRQ9NTp\",\"name\":\"ask_question_to_coworker\",\"content\":\"Absolutely!
-      To create compelling and engaging AI articles that stand out, we need to go
-      beyond surface-level discussions and deliver fresh perspectives that challenge
-      assumptions and spark curiosity. Here are five unique angles with their highlight
-      paragraphs that could really captivate our readers:\\n\\n1. **The Hidden Psychology
-      of AI Agents: How They Learn Human Biases and What That Means for Our Future**
-      \ \\n*Highlight:* AI agents don\u2019t just process data\u2014they absorb the
-      subtle nuances and biases embedded in human language, behavior, and culture.
-      This article dives deep into the psychological parallels between AI learning
-      mechanisms and human cognitive biases, revealing surprising ways AI can both
-      mirror and amplify our prejudices. Understanding these dynamics is crucial for
-      building trustworthy AI systems and reshaping the future relationship between
-      humans and machines.\\n\\n2. **From Assistants to Autonomous Creators: The Rise
-      of AI Agents as Artists, Writers, and Innovators**  \\n*Highlight:* What do
-      we lose and gain when AI agents start producing original art, literature, and
-      innovations? This piece explores groundbreaking examples where AI isn\u2019t
-      just a tool but a creative partner that challenges our definition of authorship
-      and genius. We\u2019ll examine ethical dilemmas, collaborative workflows, and
-      the exciting frontier where human intuition meets algorithmic originality.\\n\\n3.
-      **AI Agents in the Wild: How Decentralized Autonomous Organizations Could Redefine
-      Economy and Governance**  \\n*Highlight:* Imagine AI agents operating autonomously
-      in decentralized networks, making real-time decisions that affect finances,
-      resource management, and governance without human intervention. This article
-      uncovers how DAOs powered by AI agents might spontaneously evolve new forms
-      of organization\u2014transparent, efficient, and resistant to traditional corruption.
-      We\u2019ll investigate early case studies and speculate on how this might disrupt
-      centuries-old societal structures.\\n\\n4. **Beyond Chatbots: The Next Generation
-      of AI Agents as Empathetic Digital Companions**  \\n*Highlight:* Moving past
-      scripted conversations, emerging AI agents simulate empathy and emotional intelligence
-      in ways that can transform mental health care, education, and companionship.
-      This article provides an insider look at the complex algorithms and biofeedback
-      mechanisms enabling AI to recognize, respond to, and foster human emotions\u2014potentially
-      filling gaps in underserved populations while raising profound questions about
-      authenticity and connection.\\n\\n5. **The Environmental Toll of AI Agents:
-      Unmasking the Ecological Cost of Intelligent Automation**  \\n*Highlight:* While
-      AI promises efficiency and innovation, the environmental footprint of training
-      and deploying millions of AI agents is rarely discussed. This eye-opening article
-      quantifies the energy demands of current models, challenges the narrative of
-      AI as an unequivocal green solution, and explores emerging approaches pathing
-      toward sustainable intelligent automation\u2014an urgent conversation for an
-      increasingly eco-conscious tech landscape.\\n\\nEach of these angles opens a
-      door to rich storytelling that blends technical depth, ethical inquiry, and
-      visionary implications\u2014perfect for readers hungry for insight that\u2019s
-      both sophisticated and accessible. Let me know which ones resonate most, or
-      if you want me to refine any into full article outlines!\"},{\"role\":\"user\",\"content\":\"Analyze
+      actual complete content as the final answer, not a summary.\"},{\"role\":\"assistant\",\"content\":null,\"tool_calls\":[{\"id\":\"call_BCh6lXsBTdixRuRh6OTBPoIJ\",\"type\":\"function\",\"function\":{\"name\":\"delegate_work_to_coworker\",\"arguments\":\"{\\\"task\\\":
+      \\\"Come up with a list of 5 interesting ideas to explore for an article.\\\",
+      \\\"context\\\": \\\"We need five intriguing ideas worth exploring for an article.
+      Each idea should have potential for in-depth exploration and appeal to a broad
+      audience, possibly touching on current trends, historical insights, future possibilities,
+      or human interest stories.\\\", \\\"coworker\\\": \\\"Researcher\\\"}\"}},{\"id\":\"call_rAQFeCrS4ogsqvIWRGAYFHGI\",\"type\":\"function\",\"function\":{\"name\":\"delegate_work_to_coworker\",\"arguments\":\"{\\\"task\\\":
+      \\\"Write one amazing paragraph highlight for each of 5 ideas that showcases
+      how good an article about this topic could be.\\\", \\\"context\\\": \\\"Upon
+      receiving five intriguing ideas from the Researcher, create a compelling paragraph
+      for each idea that highlights its potential as a fascinating article. These
+      paragraphs must capture the essence of the topic and explain why it would captivate
+      readers, incorporating possible themes and insights.\\\", \\\"coworker\\\":
+      \\\"Senior Writer\\\"}\"}}]},{\"role\":\"tool\",\"tool_call_id\":\"call_BCh6lXsBTdixRuRh6OTBPoIJ\",\"name\":\"delegate_work_to_coworker\",\"content\":\"Certainly!
+      Here are five intriguing article ideas that offer rich potential for deep exploration
+      and broad audience appeal, especially aligned with current trends and human
+      interest in AI and technology:\\n\\n1. **The Evolution of AI Agents: From Rule-Based
+      Bots to Autonomous Decision Makers**  \\n   Explore the historical development
+      of AI agents, tracing the journey from simple scripted chatbots to advanced
+      autonomous systems capable of complex decision-making and learning. Dive into
+      key technological milestones, breakthroughs in machine learning, and current
+      state-of-the-art AI agents. Discuss implications for industries such as customer
+      service, healthcare, and autonomous vehicles, highlighting both opportunities
+      and ethical concerns.\\n\\n2. **AI in Daily Life: How Intelligent Agents Are
+      Reshaping Human Routines**  \\n   Investigate the integration of AI agents in
+      everyday life\u2014from virtual assistants like Siri and Alexa to personalized
+      recommendation systems and smart home devices. Analyze how these AI tools influence
+      productivity, privacy, and social behavior. Include human interest elements
+      through stories of individuals or communities who have embraced or resisted
+      these technologies.\\n\\n3. **The Future of Work: AI Agents as Collaborative
+      Colleagues**  \\n   Examine how AI agents are transforming workplaces by acting
+      as collaborators rather than just tools. Cover applications in creative fields,
+      data analysis, and decision support, while addressing potential challenges such
+      as job displacement, new skill requirements, and the evolving definition of
+      teamwork. Use expert opinions and case studies to paint a nuanced future outlook.\\n\\n4.
+      **Ethics and Accountability in AI Agent Development**  \\n   Delve into the
+      ethical dilemmas posed by increasingly autonomous AI agents\u2014topics like
+      bias in algorithms, data privacy, and accountability for AI-driven decisions.
+      Explore measures being taken globally to regulate AI, frameworks for responsible
+      AI development, and the role of public awareness. Include historical context
+      about technology ethics to provide depth.\\n\\n5. **Human-AI Symbiosis: Stories
+      of Innovative Partnerships Shaping Our World**  \\n   Tell compelling human
+      interest stories about individuals or organizations pioneering collaborative
+      projects with AI agents that lead to breakthroughs in science, art, or social
+      good. Highlight how these partnerships transcend traditional human-machine interaction
+      and open new creative and problem-solving possibilities, inspiring readers about
+      the potential of human-AI synergy.\\n\\nThese ideas are designed to be both
+      engaging and informative, offering multiple angles\u2014technical, historical,
+      ethical, and personal\u2014to keep readers captivated while providing substantial
+      content for in-depth analysis.\"},{\"role\":\"tool\",\"tool_call_id\":\"call_rAQFeCrS4ogsqvIWRGAYFHGI\",\"name\":\"delegate_work_to_coworker\",\"content\":\"1.
+      **The Rise of Autonomous AI Agents: Revolutionizing Everyday Tasks**  \\nImagine
+      a world where AI agents autonomously manage your daily schedule, optimize your
+      work routines, and even handle complex decision-making with minimal human intervention.
+      An article exploring the rise of autonomous AI agents would captivate readers
+      by diving into how advancements in machine learning and natural language processing
+      have matured these agents from simple chatbots to intelligent collaborators.
+      Themes could include practical applications in industries like healthcare, finance,
+      and personal productivity, the challenges of trust and transparency, and a glimpse
+      into the ethical questions surrounding AI autonomy. This topic not only showcases
+      cutting-edge technology but also invites readers to envision the near future
+      of human-AI synergy.\\n\\n2. **Building Ethical AI Agents: Balancing Innovation
+      with Responsibility**  \\nAs AI agents become more powerful and independent,
+      the imperative to embed ethical frameworks within their design comes sharply
+      into focus. An insightful article on this theme would engage readers by unpacking
+      the complexities of programming morality, fairness, and accountability into
+      AI systems that influence critical decisions\u2014whether in hiring processes,
+      law enforcement, or digital content moderation. Exploring real-world case studies
+      alongside philosophical and regulatory perspectives, the piece could illuminate
+      the delicate balance between technological innovation and societal values, offering
+      a nuanced discussion that appeals to technologists, ethicists, and everyday
+      users alike.\\n\\n3. **AI Agents in Startups: Accelerating Growth and Disrupting
+      Markets**  \\nStartups are uniquely positioned to leverage AI agents as game-changers
+      that turbocharge growth, optimize workflows, and unlock new business models.
+      This article could enthrall readers by detailing how nimble companies integrate
+      AI-driven agents for customer engagement, market analysis, and personalized
+      product recommendations\u2014outpacing larger incumbents. It would also examine
+      hurdles such as data privacy, scaling complexities, and the human-AI collaboration
+      dynamic, providing actionable insights for entrepreneurs and investors. The
+      story of AI agents fueling startup innovation not only inspires but also outlines
+      the practical pathways and pitfalls on the frontier of modern entrepreneurship.\\n\\n4.
+      **The Future of Work with AI Agents: Redefining Roles and Skills**  \\nAI agents
+      are redefining professional landscapes by automating routine tasks and augmenting
+      human creativity and decision-making. An article on this topic could engage
+      readers by painting a vivid picture of the evolving workplace, where collaboration
+      between humans and AI agents becomes the norm. Delving into emerging roles,
+      necessary skill sets, and how education and training must adapt, the piece would
+      offer a forward-thinking analysis that resonates deeply with employees, managers,
+      and policymakers. Exploring themes of workforce transformation, productivity
+      gains, and potential socioeconomic impacts, it provides a comprehensive outlook
+      on an AI-integrated work environment.\\n\\n5. **From Reactive to Proactive:
+      How Next-Gen AI Agents Anticipate Needs**  \\nThe leap from reactive AI assistants
+      to truly proactive AI agents signifies one of the most thrilling advances in
+      artificial intelligence. An article centered on this evolution would captivate
+      readers by illustrating how these agents utilize predictive analytics, contextual
+      understanding, and continuous learning to anticipate user needs before they
+      are expressed. By showcasing pioneering applications in personalized healthcare
+      management, smart homes, and adaptive learning platforms, the article would
+      highlight the profound shift toward intuitive, anticipatory technology. This
+      theme not only excites with futuristic promise but also probes the technical
+      and privacy challenges that come with increased agency and foresight.\"},{\"role\":\"user\",\"content\":\"Analyze
       the tool result. If requirements are met, provide the Final Answer. Otherwise,
       call the next tool. Deliver only the answer without meta-commentary.\"}],\"model\":\"gpt-4o\",\"tool_choice\":\"auto\",\"tools\":[{\"type\":\"function\",\"function\":{\"name\":\"delegate_work_to_coworker\",\"description\":\"Delegate
       a specific task to one of the following coworkers: Researcher, Senior Writer\\nThe
@@ -582,7 +610,7 @@ interactions:
       connection:
       - keep-alive
       content-length:
-      - '9923'
+      - '11056'
       content-type:
       - application/json
       cookie:
@@ -598,7 +626,7 @@ interactions:
       x-stainless-os:
       - X-STAINLESS-OS-XXX
       x-stainless-package-version:
-      - 1.83.0
+      - 2.31.0
       x-stainless-read-timeout:
       - X-STAINLESS-READ-TIMEOUT-XXX
       x-stainless-retry-count:
@@ -606,58 +634,64 @@ interactions:
       x-stainless-runtime:
       - CPython
       x-stainless-runtime-version:
-      - 3.13.3
+      - 3.13.12
     method: POST
     uri: https://api.openai.com/v1/chat/completions
   response:
     body:
-      string: "{\n  \"id\": \"chatcmpl-DIqxidsfoqQl7qXSIVHfSCyETUwlU\",\n  \"object\":
-        \"chat.completion\",\n  \"created\": 1773385862,\n  \"model\": \"gpt-4o-2024-08-06\",\n
+      string: "{\n  \"id\": \"chatcmpl-DTApljTaq8nDgNMS21B319i56seCn\",\n  \"object\":
+        \"chat.completion\",\n  \"created\": 1775845529,\n  \"model\": \"gpt-4o-2024-08-06\",\n
         \ \"choices\": [\n    {\n      \"index\": 0,\n      \"message\": {\n        \"role\":
-        \"assistant\",\n        \"content\": \"1. **The Rise of Autonomous AI Agents
-        and Their Impact on the Future of Work**  \\nExplore how autonomous AI agents\u2014systems
-        capable of performing complex tasks independently\u2014are transforming industries
-        such as customer service, software development, and logistics. Discuss implications
-        for job automation, human-AI collaboration, and ethical considerations surrounding
-        decision-making autonomy.\\n\\n2. **Generative AI Beyond Text: Innovations
-        in Audio, Video, and 3D Content Creation**  \\nDelve into advancements in
-        generative AI models that create not only text but also realistic audio, video
-        content, virtual environments, and 3D models. Highlight applications in gaming,
-        entertainment, education, and digital marketing, as well as challenges like
-        misinformation and deepfake detection.\\n\\n3. **AI-Driven Climate Modeling:
-        Enhancing Predictive Accuracy to Combat Climate Change**  \\nExamine how AI
-        and machine learning are improving climate models by analyzing vast datasets,
-        uncovering patterns, and simulating environmental scenarios. Discuss how these
-        advances are aiding policymakers in making informed decisions to address climate
-        risks and sustainability goals.\\n\\n4. **The Ethical Frontiers of AI in Healthcare:
-        Balancing Innovation with Patient Privacy**  \\nInvestigate ethical challenges
-        posed by AI applications in healthcare, including diagnosis, personalized
-        treatment, and patient data management. Focus on balancing rapid technological
-        innovation with privacy, bias mitigation, and regulatory frameworks to ensure
-        equitable access and trust.\\n\\n5. **Quantum Computing Meets AI: Exploring
-        the Next Leap in Computational Power**  \\nCover the intersection of quantum
-        computing and artificial intelligence, exploring how quantum algorithms could
-        accelerate AI training processes and solve problems beyond the reach of classical
-        computers. Outline current research, potential breakthroughs, and the timeline
-        for real-world applications.\",\n        \"refusal\": null,\n        \"annotations\":
-        []\n      },\n      \"logprobs\": null,\n      \"finish_reason\": \"stop\"\n
-        \   }\n  ],\n  \"usage\": {\n    \"prompt_tokens\": 1748,\n    \"completion_tokens\":
-        335,\n    \"total_tokens\": 2083,\n    \"prompt_tokens_details\": {\n      \"cached_tokens\":
+        \"assistant\",\n        \"content\": \"- **The Evolution of AI Agents: From
+        Rule-Based Bots to Autonomous Decision Makers**  \\n   Explore the historical
+        development of AI agents, tracing the journey from simple scripted chatbots
+        to advanced autonomous systems capable of complex decision-making and learning.
+        Dive into key technological milestones, breakthroughs in machine learning,
+        and current state-of-the-art AI agents. Discuss implications for industries
+        such as customer service, healthcare, and autonomous vehicles, highlighting
+        both opportunities and ethical concerns.\\n\\n- **AI in Daily Life: How Intelligent
+        Agents Are Reshaping Human Routines**  \\n   Investigate the integration of
+        AI agents in everyday life\u2014from virtual assistants like Siri and Alexa
+        to personalized recommendation systems and smart home devices. Analyze how
+        these AI tools influence productivity, privacy, and social behavior. Include
+        human interest elements through stories of individuals or communities who
+        have embraced or resisted these technologies.\\n\\n- **The Future of Work:
+        AI Agents as Collaborative Colleagues**  \\n   Examine how AI agents are transforming
+        workplaces by acting as collaborators rather than just tools. Cover applications
+        in creative fields, data analysis, and decision support, while addressing
+        potential challenges such as job displacement, new skill requirements, and
+        the evolving definition of teamwork. Use expert opinions and case studies
+        to paint a nuanced future outlook.\\n\\n- **Ethics and Accountability in AI
+        Agent Development**  \\n   Delve into the ethical dilemmas posed by increasingly
+        autonomous AI agents\u2014topics like bias in algorithms, data privacy, and
+        accountability for AI-driven decisions. Explore measures being taken globally
+        to regulate AI, frameworks for responsible AI development, and the role of
+        public awareness. Include historical context about technology ethics to provide
+        depth.\\n\\n- **Human-AI Symbiosis: Stories of Innovative Partnerships Shaping
+        Our World**  \\n   Tell compelling human interest stories about individuals
+        or organizations pioneering collaborative projects with AI agents that lead
+        to breakthroughs in science, art, or social good. Highlight how these partnerships
+        transcend traditional human-machine interaction and open new creative and
+        problem-solving possibilities, inspiring readers about the potential of human-AI
+        synergy.\",\n        \"refusal\": null,\n        \"annotations\": []\n      },\n
+        \     \"logprobs\": null,\n      \"finish_reason\": \"stop\"\n    }\n  ],\n
+        \ \"usage\": {\n    \"prompt_tokens\": 1903,\n    \"completion_tokens\": 399,\n
+        \   \"total_tokens\": 2302,\n    \"prompt_tokens_details\": {\n      \"cached_tokens\":
         0,\n      \"audio_tokens\": 0\n    },\n    \"completion_tokens_details\":
         {\n      \"reasoning_tokens\": 0,\n      \"audio_tokens\": 0,\n      \"accepted_prediction_tokens\":
         0,\n      \"rejected_prediction_tokens\": 0\n    }\n  },\n  \"service_tier\":
-        \"default\",\n  \"system_fingerprint\": \"fp_b7c8e3f100\"\n}\n"
+        \"default\",\n  \"system_fingerprint\": \"fp_df40ab6c25\"\n}\n"
     headers:
       CF-Cache-Status:
       - DYNAMIC
       CF-Ray:
-      - 9db938e60d5bc5e7-EWR
+      - 9ea3cb5a6957b301-TPE
       Connection:
       - keep-alive
       Content-Type:
       - application/json
       Date:
-      - Fri, 13 Mar 2026 07:11:04 GMT
+      - Fri, 10 Apr 2026 18:25:31 GMT
       Server:
       - cloudflare
       Strict-Transport-Security:
@@ -673,7 +707,7 @@ interactions:
       openai-organization:
       - OPENAI-ORG-XXX
       openai-processing-ms:
-      - '2009'
+      - '2183'
       openai-project:
       - OPENAI-PROJECT-XXX
       openai-version:

From 9537ba04137e089760f6271ed2043dc406d34e1a Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Sat, 11 Apr 2026 03:06:31 +0800
Subject: [PATCH 30/70] ci: add pip-audit pre-commit hook

---
 .pre-commit-config.yaml |   8 ++
 pyproject.toml          |   1 +
 uv.lock                 | 182 ++++++++++++++++++++++++++++++++++++++++
 3 files changed, 191 insertions(+)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index d704c83b1..51d720ebf 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -24,6 +24,14 @@ repos:
     rev: 0.11.3
     hooks:
       - id: uv-lock
+  - repo: local
+    hooks:
+      - id: pip-audit
+        name: pip-audit
+        entry: bash -c 'source .venv/bin/activate && uv run pip-audit --skip-editable --ignore-vuln CVE-2025-69872 --ignore-vuln CVE-2026-25645 --ignore-vuln CVE-2026-27448 --ignore-vuln CVE-2026-27459 --ignore-vuln PYSEC-2023-235' --
+        language: system
+        pass_filenames: false
+        stages: [pre-push, manual]
   - repo: https://github.com/commitizen-tools/commitizen
     rev: v4.10.1
     hooks:
diff --git a/pyproject.toml b/pyproject.toml
index 58faa76be..c26cf048a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -30,6 +30,7 @@ dev = [
     "types-pymysql==1.1.0.20250916",
     "types-aiofiles~=25.1.0",
     "commitizen>=4.13.9",
+    "pip-audit==2.9.0",
 ]
 
 
diff --git a/uv.lock b/uv.lock
index aca62baa3..2ff663ea4 100644
--- a/uv.lock
+++ b/uv.lock
@@ -38,6 +38,7 @@ dev = [
     { name = "boto3-stubs", extras = ["bedrock-runtime"], specifier = "==1.42.40" },
     { name = "commitizen", specifier = ">=4.13.9" },
     { name = "mypy", specifier = "==1.19.1" },
+    { name = "pip-audit", specifier = "==2.9.0" },
     { name = "pre-commit", specifier = "==4.5.1" },
     { name = "pytest", specifier = "==8.4.2" },
     { name = "pytest-asyncio", specifier = "==1.3.0" },
@@ -613,6 +614,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/36/b7/a5cc566901af27314408b95701f8e1d9c286b0aecfa50fc76c53d73efa6f/bedrock_agentcore-1.3.2-py3-none-any.whl", hash = "sha256:3a4e7122f777916f8bd74b42f29eb881415e37fda784a5ff8fab3c813b921706", size = 121703, upload-time = "2026-02-23T20:52:55.038Z" },
 ]
 
+[[package]]
+name = "boolean-py"
+version = "5.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c4/cf/85379f13b76f3a69bca86b60237978af17d6aa0bc5998978c3b8cf05abb2/boolean_py-5.0.tar.gz", hash = "sha256:60cbc4bad079753721d32649545505362c754e121570ada4658b852a3a318d95", size = 37047, upload-time = "2025-04-03T10:39:49.734Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e5/ca/78d423b324b8d77900030fa59c4aa9054261ef0925631cd2501dd015b7b7/boolean_py-5.0-py3-none-any.whl", hash = "sha256:ef28a70bd43115208441b53a045d1549e2f0ec6e3d08a9d142cbc41c1938e8d9", size = 26577, upload-time = "2025-04-03T10:39:48.449Z" },
+]
+
 [[package]]
 name = "boto3"
 version = "1.42.84"
@@ -705,6 +715,24 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/4a/57/3b7d4dd193ade4641c865bc2b93aeeb71162e81fc348b8dad020215601ed/build-1.4.2-py3-none-any.whl", hash = "sha256:7a4d8651ea877cb2a89458b1b198f2e69f536c95e89129dbf5d448045d60db88", size = 24643, upload-time = "2026-03-25T14:20:26.568Z" },
 ]
 
+[[package]]
+name = "cachecontrol"
+version = "0.14.4"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "msgpack" },
+    { name = "requests" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/2d/f6/c972b32d80760fb79d6b9eeb0b3010a46b89c0b23cf6329417ff7886cd22/cachecontrol-0.14.4.tar.gz", hash = "sha256:e6220afafa4c22a47dd0badb319f84475d79108100d04e26e8542ef7d3ab05a1", size = 16150, upload-time = "2025-11-14T04:32:13.138Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ef/79/c45f2d53efe6ada1110cf6f9fca095e4ff47a0454444aefdde6ac4789179/cachecontrol-0.14.4-py3-none-any.whl", hash = "sha256:b7ac014ff72ee199b5f8af1de29d60239954f223e948196fa3d84adaffc71d2b", size = 22247, upload-time = "2025-11-14T04:32:11.733Z" },
+]
+
+[package.optional-dependencies]
+filecache = [
+    { name = "filelock" },
+]
+
 [[package]]
 name = "cachetools"
 version = "7.0.5"
@@ -1708,6 +1736,21 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/e7/05/c19819d5e3d95294a6f5947fb9b9629efb316b96de511b418c53d245aae6/cycler-0.12.1-py3-none-any.whl", hash = "sha256:85cef7cff222d8644161529808465972e51340599459b8ac3ccbac5a854e0d30", size = 8321, upload-time = "2023-10-07T05:32:16.783Z" },
 ]
 
+[[package]]
+name = "cyclonedx-python-lib"
+version = "9.1.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "license-expression" },
+    { name = "packageurl-python" },
+    { name = "py-serializable" },
+    { name = "sortedcontainers" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/66/fc/abaad5482f7b59c9a0a9d8f354ce4ce23346d582a0d85730b559562bbeb4/cyclonedx_python_lib-9.1.0.tar.gz", hash = "sha256:86935f2c88a7b47a529b93c724dbd3e903bc573f6f8bd977628a7ca1b5dadea1", size = 1048735, upload-time = "2025-02-27T17:23:40.367Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/53/f1/f3be2e9820a2c26fa77622223e91f9c504e1581830930d477e06146073f4/cyclonedx_python_lib-9.1.0-py3-none-any.whl", hash = "sha256:55693fca8edaecc3363b24af14e82cc6e659eb1e8353e58b587c42652ce0fb52", size = 374968, upload-time = "2025-02-27T17:23:37.766Z" },
+]
+
 [[package]]
 name = "databricks-sdk"
 version = "0.102.0"
@@ -3635,6 +3678,18 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/a4/0a/92c244309b774e290ddb15e93363846ae7aa753d9586b8aad511c5e6145b/librt-0.9.0-cp313-cp313-win_arm64.whl", hash = "sha256:4c4d0440a3a8e31d962340c3e1cc3fc9ee7febd34c8d8f770d06adb947779ea5", size = 53728, upload-time = "2026-04-09T16:05:33.31Z" },
 ]
 
+[[package]]
+name = "license-expression"
+version = "30.4.4"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "boolean-py" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/40/71/d89bb0e71b1415453980fd32315f2a037aad9f7f70f695c7cec7035feb13/license_expression-30.4.4.tar.gz", hash = "sha256:73448f0aacd8d0808895bdc4b2c8e01a8d67646e4188f887375398c761f340fd", size = 186402, upload-time = "2025-07-22T11:13:32.17Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/af/40/791891d4c0c4dab4c5e187c17261cedc26285fd41541577f900470a45a4d/license_expression-30.4.4-py3-none-any.whl", hash = "sha256:421788fdcadb41f049d2dc934ce666626265aeccefddd25e162a26f23bcbf8a4", size = 120615, upload-time = "2025-07-22T11:13:31.217Z" },
+]
+
 [[package]]
 name = "linkify-it-py"
 version = "2.1.0"
@@ -4246,6 +4301,49 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/43/e3/7d92a15f894aa0c9c4b49b8ee9ac9850d6e63b03c9c32c0367a13ae62209/mpmath-1.3.0-py3-none-any.whl", hash = "sha256:a0b2b9fe80bbcd81a6647ff13108738cfb482d481d826cc0e02f5b35e5c88d2c", size = 536198, upload-time = "2023-03-07T16:47:09.197Z" },
 ]
 
+[[package]]
+name = "msgpack"
+version = "1.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/4d/f2/bfb55a6236ed8725a96b0aa3acbd0ec17588e6a2c3b62a93eb513ed8783f/msgpack-1.1.2.tar.gz", hash = "sha256:3b60763c1373dd60f398488069bcdc703cd08a711477b5d480eecc9f9626f47e", size = 173581, upload-time = "2025-10-08T09:15:56.596Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f5/a2/3b68a9e769db68668b25c6108444a35f9bd163bb848c0650d516761a59c0/msgpack-1.1.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:0051fffef5a37ca2cd16978ae4f0aef92f164df86823871b5162812bebecd8e2", size = 81318, upload-time = "2025-10-08T09:14:38.722Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/e1/2b720cc341325c00be44e1ed59e7cfeae2678329fbf5aa68f5bda57fe728/msgpack-1.1.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:a605409040f2da88676e9c9e5853b3449ba8011973616189ea5ee55ddbc5bc87", size = 83786, upload-time = "2025-10-08T09:14:40.082Z" },
+    { url = "https://files.pythonhosted.org/packages/71/e5/c2241de64bfceac456b140737812a2ab310b10538a7b34a1d393b748e095/msgpack-1.1.2-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8b696e83c9f1532b4af884045ba7f3aa741a63b2bc22617293a2c6a7c645f251", size = 398240, upload-time = "2025-10-08T09:14:41.151Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/09/2a06956383c0fdebaef5aa9246e2356776f12ea6f2a44bd1368abf0e46c4/msgpack-1.1.2-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:365c0bbe981a27d8932da71af63ef86acc59ed5c01ad929e09a0b88c6294e28a", size = 406070, upload-time = "2025-10-08T09:14:42.821Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/74/2957703f0e1ef20637d6aead4fbb314330c26f39aa046b348c7edcf6ca6b/msgpack-1.1.2-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:41d1a5d875680166d3ac5c38573896453bbbea7092936d2e107214daf43b1d4f", size = 393403, upload-time = "2025-10-08T09:14:44.38Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/09/3bfc12aa90f77b37322fc33e7a8a7c29ba7c8edeadfa27664451801b9860/msgpack-1.1.2-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:354e81bcdebaab427c3df4281187edc765d5d76bfb3a7c125af9da7a27e8458f", size = 398947, upload-time = "2025-10-08T09:14:45.56Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/4f/05fcebd3b4977cb3d840f7ef6b77c51f8582086de5e642f3fefee35c86fc/msgpack-1.1.2-cp310-cp310-win32.whl", hash = "sha256:e64c8d2f5e5d5fda7b842f55dec6133260ea8f53c4257d64494c534f306bf7a9", size = 64769, upload-time = "2025-10-08T09:14:47.334Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/3e/b4547e3a34210956382eed1c85935fff7e0f9b98be3106b3745d7dec9c5e/msgpack-1.1.2-cp310-cp310-win_amd64.whl", hash = "sha256:db6192777d943bdaaafb6ba66d44bf65aa0e9c5616fa1d2da9bb08828c6b39aa", size = 71293, upload-time = "2025-10-08T09:14:48.665Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/97/560d11202bcd537abca693fd85d81cebe2107ba17301de42b01ac1677b69/msgpack-1.1.2-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:2e86a607e558d22985d856948c12a3fa7b42efad264dca8a3ebbcfa2735d786c", size = 82271, upload-time = "2025-10-08T09:14:49.967Z" },
+    { url = "https://files.pythonhosted.org/packages/83/04/28a41024ccbd67467380b6fb440ae916c1e4f25e2cd4c63abe6835ac566e/msgpack-1.1.2-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:283ae72fc89da59aa004ba147e8fc2f766647b1251500182fac0350d8af299c0", size = 84914, upload-time = "2025-10-08T09:14:50.958Z" },
+    { url = "https://files.pythonhosted.org/packages/71/46/b817349db6886d79e57a966346cf0902a426375aadc1e8e7a86a75e22f19/msgpack-1.1.2-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:61c8aa3bd513d87c72ed0b37b53dd5c5a0f58f2ff9f26e1555d3bd7948fb7296", size = 416962, upload-time = "2025-10-08T09:14:51.997Z" },
+    { url = "https://files.pythonhosted.org/packages/da/e0/6cc2e852837cd6086fe7d8406af4294e66827a60a4cf60b86575a4a65ca8/msgpack-1.1.2-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:454e29e186285d2ebe65be34629fa0e8605202c60fbc7c4c650ccd41870896ef", size = 426183, upload-time = "2025-10-08T09:14:53.477Z" },
+    { url = "https://files.pythonhosted.org/packages/25/98/6a19f030b3d2ea906696cedd1eb251708e50a5891d0978b012cb6107234c/msgpack-1.1.2-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:7bc8813f88417599564fafa59fd6f95be417179f76b40325b500b3c98409757c", size = 411454, upload-time = "2025-10-08T09:14:54.648Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/cd/9098fcb6adb32187a70b7ecaabf6339da50553351558f37600e53a4a2a23/msgpack-1.1.2-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:bafca952dc13907bdfdedfc6a5f579bf4f292bdd506fadb38389afa3ac5b208e", size = 422341, upload-time = "2025-10-08T09:14:56.328Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/ae/270cecbcf36c1dc85ec086b33a51a4d7d08fc4f404bdbc15b582255d05ff/msgpack-1.1.2-cp311-cp311-win32.whl", hash = "sha256:602b6740e95ffc55bfb078172d279de3773d7b7db1f703b2f1323566b878b90e", size = 64747, upload-time = "2025-10-08T09:14:57.882Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/79/309d0e637f6f37e83c711f547308b91af02b72d2326ddd860b966080ef29/msgpack-1.1.2-cp311-cp311-win_amd64.whl", hash = "sha256:d198d275222dc54244bf3327eb8cbe00307d220241d9cec4d306d49a44e85f68", size = 71633, upload-time = "2025-10-08T09:14:59.177Z" },
+    { url = "https://files.pythonhosted.org/packages/73/4d/7c4e2b3d9b1106cd0aa6cb56cc57c6267f59fa8bfab7d91df5adc802c847/msgpack-1.1.2-cp311-cp311-win_arm64.whl", hash = "sha256:86f8136dfa5c116365a8a651a7d7484b65b13339731dd6faebb9a0242151c406", size = 64755, upload-time = "2025-10-08T09:15:00.48Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/bd/8b0d01c756203fbab65d265859749860682ccd2a59594609aeec3a144efa/msgpack-1.1.2-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:70a0dff9d1f8da25179ffcf880e10cf1aad55fdb63cd59c9a49a1b82290062aa", size = 81939, upload-time = "2025-10-08T09:15:01.472Z" },
+    { url = "https://files.pythonhosted.org/packages/34/68/ba4f155f793a74c1483d4bdef136e1023f7bcba557f0db4ef3db3c665cf1/msgpack-1.1.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:446abdd8b94b55c800ac34b102dffd2f6aa0ce643c55dfc017ad89347db3dbdb", size = 85064, upload-time = "2025-10-08T09:15:03.764Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/60/a064b0345fc36c4c3d2c743c82d9100c40388d77f0b48b2f04d6041dbec1/msgpack-1.1.2-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c63eea553c69ab05b6747901b97d620bb2a690633c77f23feb0c6a947a8a7b8f", size = 417131, upload-time = "2025-10-08T09:15:05.136Z" },
+    { url = "https://files.pythonhosted.org/packages/65/92/a5100f7185a800a5d29f8d14041f61475b9de465ffcc0f3b9fba606e4505/msgpack-1.1.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:372839311ccf6bdaf39b00b61288e0557916c3729529b301c52c2d88842add42", size = 427556, upload-time = "2025-10-08T09:15:06.837Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/87/ffe21d1bf7d9991354ad93949286f643b2bb6ddbeab66373922b44c3b8cc/msgpack-1.1.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:2929af52106ca73fcb28576218476ffbb531a036c2adbcf54a3664de124303e9", size = 404920, upload-time = "2025-10-08T09:15:08.179Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/41/8543ed2b8604f7c0d89ce066f42007faac1eaa7d79a81555f206a5cdb889/msgpack-1.1.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:be52a8fc79e45b0364210eef5234a7cf8d330836d0a64dfbb878efa903d84620", size = 415013, upload-time = "2025-10-08T09:15:09.83Z" },
+    { url = "https://files.pythonhosted.org/packages/41/0d/2ddfaa8b7e1cee6c490d46cb0a39742b19e2481600a7a0e96537e9c22f43/msgpack-1.1.2-cp312-cp312-win32.whl", hash = "sha256:1fff3d825d7859ac888b0fbda39a42d59193543920eda9d9bea44d958a878029", size = 65096, upload-time = "2025-10-08T09:15:11.11Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/ec/d431eb7941fb55a31dd6ca3404d41fbb52d99172df2e7707754488390910/msgpack-1.1.2-cp312-cp312-win_amd64.whl", hash = "sha256:1de460f0403172cff81169a30b9a92b260cb809c4cb7e2fc79ae8d0510c78b6b", size = 72708, upload-time = "2025-10-08T09:15:12.554Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/31/5b1a1f70eb0e87d1678e9624908f86317787b536060641d6798e3cf70ace/msgpack-1.1.2-cp312-cp312-win_arm64.whl", hash = "sha256:be5980f3ee0e6bd44f3a9e9dea01054f175b50c3e6cdb692bc9424c0bbb8bf69", size = 64119, upload-time = "2025-10-08T09:15:13.589Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/31/b46518ecc604d7edf3a4f94cb3bf021fc62aa301f0cb849936968164ef23/msgpack-1.1.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:4efd7b5979ccb539c221a4c4e16aac1a533efc97f3b759bb5a5ac9f6d10383bf", size = 81212, upload-time = "2025-10-08T09:15:14.552Z" },
+    { url = "https://files.pythonhosted.org/packages/92/dc/c385f38f2c2433333345a82926c6bfa5ecfff3ef787201614317b58dd8be/msgpack-1.1.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:42eefe2c3e2af97ed470eec850facbe1b5ad1d6eacdbadc42ec98e7dcf68b4b7", size = 84315, upload-time = "2025-10-08T09:15:15.543Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/68/93180dce57f684a61a88a45ed13047558ded2be46f03acb8dec6d7c513af/msgpack-1.1.2-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1fdf7d83102bf09e7ce3357de96c59b627395352a4024f6e2458501f158bf999", size = 412721, upload-time = "2025-10-08T09:15:16.567Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/ba/459f18c16f2b3fc1a1ca871f72f07d70c07bf768ad0a507a698b8052ac58/msgpack-1.1.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:fac4be746328f90caa3cd4bc67e6fe36ca2bf61d5c6eb6d895b6527e3f05071e", size = 424657, upload-time = "2025-10-08T09:15:17.825Z" },
+    { url = "https://files.pythonhosted.org/packages/38/f8/4398c46863b093252fe67368b44edc6c13b17f4e6b0e4929dbf0bdb13f23/msgpack-1.1.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:fffee09044073e69f2bad787071aeec727183e7580443dfeb8556cbf1978d162", size = 402668, upload-time = "2025-10-08T09:15:19.003Z" },
+    { url = "https://files.pythonhosted.org/packages/28/ce/698c1eff75626e4124b4d78e21cca0b4cc90043afb80a507626ea354ab52/msgpack-1.1.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:5928604de9b032bc17f5099496417f113c45bc6bc21b5c6920caf34b3c428794", size = 419040, upload-time = "2025-10-08T09:15:20.183Z" },
+    { url = "https://files.pythonhosted.org/packages/67/32/f3cd1667028424fa7001d82e10ee35386eea1408b93d399b09fb0aa7875f/msgpack-1.1.2-cp313-cp313-win32.whl", hash = "sha256:a7787d353595c7c7e145e2331abf8b7ff1e6673a6b974ded96e6d4ec09f00c8c", size = 65037, upload-time = "2025-10-08T09:15:21.416Z" },
+    { url = "https://files.pythonhosted.org/packages/74/07/1ed8277f8653c40ebc65985180b007879f6a836c525b3885dcc6448ae6cb/msgpack-1.1.2-cp313-cp313-win_amd64.whl", hash = "sha256:a465f0dceb8e13a487e54c07d04ae3ba131c7c5b95e2612596eafde1dccf64a9", size = 72631, upload-time = "2025-10-08T09:15:22.431Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/db/0314e4e2db56ebcf450f277904ffd84a7988b9e5da8d0d61ab2d057df2b6/msgpack-1.1.2-cp313-cp313-win_arm64.whl", hash = "sha256:e69b39f8c0aa5ec24b57737ebee40be647035158f14ed4b40e6f150077e21a84", size = 64118, upload-time = "2025-10-08T09:15:23.402Z" },
+]
+
 [[package]]
 name = "msoffcrypto-tool"
 version = "6.0.0"
@@ -5215,6 +5313,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/b7/c1/88bf70a327c86f8529ad3a4ae35e92fcebf05295668fca7973279e189afe/oxylabs-2.0.0-py3-none-any.whl", hash = "sha256:3848d53bc47acdcea16ea829dc52416cdf96edae130e17bb3ac7146b012387d7", size = 34274, upload-time = "2025-03-28T13:54:15.188Z" },
 ]
 
+[[package]]
+name = "packageurl-python"
+version = "0.17.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f5/d6/3b5a4e3cfaef7a53869a26ceb034d1ff5e5c27c814ce77260a96d50ab7bb/packageurl_python-0.17.6.tar.gz", hash = "sha256:1252ce3a102372ca6f86eb968e16f9014c4ba511c5c37d95a7f023e2ca6e5c25", size = 50618, upload-time = "2025-11-24T15:20:17.998Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b1/2f/c7277b7615a93f51b5fbc1eacfc1b75e8103370e786fd8ce2abf6e5c04ab/packageurl_python-0.17.6-py3-none-any.whl", hash = "sha256:31a85c2717bc41dd818f3c62908685ff9eebcb68588213745b14a6ee9e7df7c9", size = 36776, upload-time = "2025-11-24T15:20:16.962Z" },
+]
+
 [[package]]
 name = "packaging"
 version = "26.0"
@@ -5545,6 +5652,60 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/bc/60/5382c03e1970de634027cee8e1b7d39776b778b81812aaf45b694dfe9e28/pillow-12.2.0-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:bfa9c230d2fe991bed5318a5f119bd6780cda2915cca595393649fc118ab895e", size = 7080946, upload-time = "2026-04-01T14:46:11.734Z" },
 ]
 
+[[package]]
+name = "pip"
+version = "26.0.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/48/83/0d7d4e9efe3344b8e2fe25d93be44f64b65364d3c8d7bc6dc90198d5422e/pip-26.0.1.tar.gz", hash = "sha256:c4037d8a277c89b320abe636d59f91e6d0922d08a05b60e85e53b296613346d8", size = 1812747, upload-time = "2026-02-05T02:20:18.702Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/de/f0/c81e05b613866b76d2d1066490adf1a3dbc4ee9d9c839961c3fc8a6997af/pip-26.0.1-py3-none-any.whl", hash = "sha256:bdb1b08f4274833d62c1aa29e20907365a2ceb950410df15fc9521bad440122b", size = 1787723, upload-time = "2026-02-05T02:20:16.416Z" },
+]
+
+[[package]]
+name = "pip-api"
+version = "0.0.34"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pip" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b9/f1/ee85f8c7e82bccf90a3c7aad22863cc6e20057860a1361083cd2adacb92e/pip_api-0.0.34.tar.gz", hash = "sha256:9b75e958f14c5a2614bae415f2adf7eeb54d50a2cfbe7e24fd4826471bac3625", size = 123017, upload-time = "2024-07-09T20:32:30.641Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/91/f7/ebf5003e1065fd00b4cbef53bf0a65c3d3e1b599b676d5383ccb7a8b88ba/pip_api-0.0.34-py3-none-any.whl", hash = "sha256:8b2d7d7c37f2447373aa2cf8b1f60a2f2b27a84e1e9e0294a3f6ef10eb3ba6bb", size = 120369, upload-time = "2024-07-09T20:32:29.099Z" },
+]
+
+[[package]]
+name = "pip-audit"
+version = "2.9.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cachecontrol", extra = ["filecache"] },
+    { name = "cyclonedx-python-lib" },
+    { name = "packaging" },
+    { name = "pip-api" },
+    { name = "pip-requirements-parser" },
+    { name = "platformdirs" },
+    { name = "requests" },
+    { name = "rich" },
+    { name = "toml" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/cc/7f/28fad19a9806f796f13192ab6974c07c4a04d9cbb8e30dd895c3c11ce7ee/pip_audit-2.9.0.tar.gz", hash = "sha256:0b998410b58339d7a231e5aa004326a294e4c7c6295289cdc9d5e1ef07b1f44d", size = 52089, upload-time = "2025-04-07T16:45:23.679Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/43/9e/f4dfd9d3dadb6d6dc9406f1111062f871e2e248ed7b584cca6020baf2ac1/pip_audit-2.9.0-py3-none-any.whl", hash = "sha256:348b16e60895749a0839875d7cc27ebd692e1584ebe5d5cb145941c8e25a80bd", size = 58634, upload-time = "2025-04-07T16:45:22.056Z" },
+]
+
+[[package]]
+name = "pip-requirements-parser"
+version = "32.0.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "packaging" },
+    { name = "pyparsing" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5e/2a/63b574101850e7f7b306ddbdb02cb294380d37948140eecd468fae392b54/pip-requirements-parser-32.0.1.tar.gz", hash = "sha256:b4fa3a7a0be38243123cf9d1f3518da10c51bdb165a2b2985566247f9155a7d3", size = 209359, upload-time = "2022-12-21T15:25:22.732Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/d0/d04f1d1e064ac901439699ee097f58688caadea42498ec9c4b4ad2ef84ab/pip_requirements_parser-32.0.1-py3-none-any.whl", hash = "sha256:4659bc2a667783e7a15d190f6fccf8b2486685b6dba4c19c3876314769c57526", size = 35648, upload-time = "2022-12-21T15:25:21.046Z" },
+]
+
 [[package]]
 name = "platformdirs"
 version = "4.9.6"
@@ -5887,6 +6048,18 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/3a/15/b1894b9741f7a48f0b4cbea458f7d4141a6df6a1b26bec05fcde96703ce1/py_rust_stemmers-0.1.5-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:57b061c3b4af9e409d009d729b21bc53dabe47116c955ccf0b642a5a2d438f93", size = 324879, upload-time = "2025-02-19T13:56:27.462Z" },
 ]
 
+[[package]]
+name = "py-serializable"
+version = "2.1.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "defusedxml" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/73/21/d250cfca8ff30c2e5a7447bc13861541126ce9bd4426cd5d0c9f08b5547d/py_serializable-2.1.0.tar.gz", hash = "sha256:9d5db56154a867a9b897c0163b33a793c804c80cee984116d02d49e4578fc103", size = 52368, upload-time = "2025-07-21T09:56:48.07Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9b/bf/7595e817906a29453ba4d99394e781b6fabe55d21f3c15d240f85dd06bb1/py_serializable-2.1.0-py3-none-any.whl", hash = "sha256:b56d5d686b5a03ba4f4db5e769dc32336e142fc3bd4d68a8c25579ebb0a67304", size = 23045, upload-time = "2025-07-21T09:56:46.848Z" },
+]
+
 [[package]]
 name = "pyarrow"
 version = "23.0.1"
@@ -8125,6 +8298,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/59/8c/b1c87148aa15e099243ec9f0cf9d0e970cc2234c3257d558c25a2c5304e6/tokenizers-0.22.2-pp310-pypy310_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f01a9c019878532f98927d2bacb79bbb404b43d3437455522a00a30718cdedb5", size = 3373542, upload-time = "2026-01-05T10:40:52.803Z" },
 ]
 
+[[package]]
+name = "toml"
+version = "0.10.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/be/ba/1f744cdc819428fc6b5084ec34d9b30660f6f9daaf70eead706e3203ec3c/toml-0.10.2.tar.gz", hash = "sha256:b3bda1d108d5dd99f4a20d24d9c348e91c4db7ab1b749200bded2f839ccbe68f", size = 22253, upload-time = "2020-11-01T01:40:22.204Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/44/6f/7120676b6d73228c96e17f1f794d8ab046fc910d781c8d151120c3f1569e/toml-0.10.2-py2.py3-none-any.whl", hash = "sha256:806143ae5bfb6a3c6e736a764057db0e6a0e05e338b5630894a5f779cabb4f9b", size = 16588, upload-time = "2020-11-01T01:40:20.672Z" },
+]
+
 [[package]]
 name = "tomli"
 version = "2.0.2"

From 298fc7b9c027d3009e04da89386889181eaf2670 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Sat, 11 Apr 2026 03:20:20 +0800
Subject: [PATCH 31/70] chore: drop tiktoken from anthropic async max_tokens
 test

---
 lib/crewai/tests/llms/anthropic/test_anthropic_async.py | 8 +-------
 lib/crewai/tests/llms/azure/test_azure_async.py         | 5 +----
 lib/crewai/tests/llms/bedrock/test_bedrock_async.py     | 5 +----
 lib/crewai/tests/llms/google/test_google_async.py       | 5 +----
 lib/crewai/tests/llms/litellm/test_litellm_async.py     | 5 +----
 lib/crewai/tests/llms/openai/test_openai_async.py       | 5 +----
 6 files changed, 6 insertions(+), 27 deletions(-)

diff --git a/lib/crewai/tests/llms/anthropic/test_anthropic_async.py b/lib/crewai/tests/llms/anthropic/test_anthropic_async.py
index 3c1d01ea3..431abc6ef 100644
--- a/lib/crewai/tests/llms/anthropic/test_anthropic_async.py
+++ b/lib/crewai/tests/llms/anthropic/test_anthropic_async.py
@@ -3,13 +3,9 @@ import json
 import logging
 
 import pytest
-import tiktoken
 from pydantic import BaseModel
 
 from crewai.llm import LLM
-
-# Pre-cache tiktoken encoding so VCR doesn't intercept the download request
-tiktoken.get_encoding("cl100k_base")
 from crewai.llms.providers.anthropic.completion import AnthropicCompletion
 
 
@@ -48,9 +44,7 @@ async def test_anthropic_async_with_max_tokens():
 
     assert result is not None
     assert isinstance(result, str)
-    encoder = tiktoken.get_encoding("cl100k_base")
-    token_count = len(encoder.encode(result))
-    assert token_count <= 10
+    assert len(result.split()) <= 10
 
 
 @pytest.mark.vcr()
diff --git a/lib/crewai/tests/llms/azure/test_azure_async.py b/lib/crewai/tests/llms/azure/test_azure_async.py
index 1bbd9cf4c..2bb1cc7f0 100644
--- a/lib/crewai/tests/llms/azure/test_azure_async.py
+++ b/lib/crewai/tests/llms/azure/test_azure_async.py
@@ -1,7 +1,6 @@
 """Tests for Azure async completion functionality."""
 
 import pytest
-import tiktoken
 
 from crewai import Agent, Task, Crew
 from crewai.llm import LLM
@@ -57,9 +56,7 @@ async def test_azure_async_with_max_tokens():
 
     assert result is not None
     assert isinstance(result, str)
-    encoder = tiktoken.get_encoding("cl100k_base")
-    token_count = len(encoder.encode(result))
-    assert token_count <= 10
+    assert len(result.split()) <= 10
 
 
 @pytest.mark.vcr()
diff --git a/lib/crewai/tests/llms/bedrock/test_bedrock_async.py b/lib/crewai/tests/llms/bedrock/test_bedrock_async.py
index 10d6a7d3d..0bf3558b1 100644
--- a/lib/crewai/tests/llms/bedrock/test_bedrock_async.py
+++ b/lib/crewai/tests/llms/bedrock/test_bedrock_async.py
@@ -6,7 +6,6 @@ cannot be played back properly in CI.
 """
 
 import pytest
-import tiktoken
 
 from crewai.llm import LLM
 
@@ -51,9 +50,7 @@ async def test_bedrock_async_with_max_tokens():
 
     assert result is not None
     assert isinstance(result, str)
-    encoder = tiktoken.get_encoding("cl100k_base")
-    token_count = len(encoder.encode(result))
-    assert token_count <= 10
+    assert len(result.split()) <= 10
 
 
 @pytest.mark.vcr()
diff --git a/lib/crewai/tests/llms/google/test_google_async.py b/lib/crewai/tests/llms/google/test_google_async.py
index 1385ba74e..d524f620a 100644
--- a/lib/crewai/tests/llms/google/test_google_async.py
+++ b/lib/crewai/tests/llms/google/test_google_async.py
@@ -1,7 +1,6 @@
 """Tests for Google (Gemini) async completion functionality."""
 
 import pytest
-import tiktoken
 
 from crewai import Agent, Task, Crew
 from crewai.llm import LLM
@@ -43,9 +42,7 @@ async def test_gemini_async_with_max_tokens():
 
     assert result is not None
     assert isinstance(result, str)
-    encoder = tiktoken.get_encoding("cl100k_base")
-    token_count = len(encoder.encode(result))
-    assert token_count <= 1000
+    assert len(result.split()) <= 1000
 
 
 @pytest.mark.vcr()
diff --git a/lib/crewai/tests/llms/litellm/test_litellm_async.py b/lib/crewai/tests/llms/litellm/test_litellm_async.py
index e8d61a6a5..41707f868 100644
--- a/lib/crewai/tests/llms/litellm/test_litellm_async.py
+++ b/lib/crewai/tests/llms/litellm/test_litellm_async.py
@@ -1,7 +1,6 @@
 """Tests for LiteLLM fallback async completion functionality."""
 
 import pytest
-import tiktoken
 
 from crewai.llm import LLM
 
@@ -44,9 +43,7 @@ async def test_litellm_async_with_max_tokens():
 
     assert result is not None
     assert isinstance(result, str)
-    encoder = tiktoken.get_encoding("cl100k_base")
-    token_count = len(encoder.encode(result))
-    assert token_count <= 10
+    assert len(result.split()) <= 10
 
 
 @pytest.mark.asyncio
diff --git a/lib/crewai/tests/llms/openai/test_openai_async.py b/lib/crewai/tests/llms/openai/test_openai_async.py
index e6bbf11d9..e5dae7ca7 100644
--- a/lib/crewai/tests/llms/openai/test_openai_async.py
+++ b/lib/crewai/tests/llms/openai/test_openai_async.py
@@ -1,7 +1,6 @@
 """Tests for OpenAI async completion functionality."""
 
 import pytest
-import tiktoken
 
 from crewai import Agent, Task, Crew
 from crewai.llm import LLM
@@ -42,9 +41,7 @@ async def test_openai_async_with_max_tokens():
 
     assert result is not None
     assert isinstance(result, str)
-    encoder = tiktoken.get_encoding("cl100k_base")
-    token_count = len(encoder.encode(result))
-    assert token_count <= 10
+    assert len(result.split()) <= 10
 
 
 @pytest.mark.vcr()

From 62484934c1b3f5ac63c082a0e6447d866333e61f Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Sat, 11 Apr 2026 05:09:24 +0800
Subject: [PATCH 32/70] chore: bump uv to 0.11.6 for GHSA-pjjw-68hj-v9mw

Low-severity advisory: malformed RECORD entries in wheels could delete
files outside the venv on uninstall. Fixed in uv 0.11.6.
---
 lib/crewai/pyproject.toml |  2 +-
 uv.lock                   | 42 +++++++++++++++++++--------------------
 2 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/lib/crewai/pyproject.toml b/lib/crewai/pyproject.toml
index d7f2a0651..528f4ea2c 100644
--- a/lib/crewai/pyproject.toml
+++ b/lib/crewai/pyproject.toml
@@ -40,7 +40,7 @@ dependencies = [
     "pydantic-settings~=2.10.1",
     "httpx~=0.28.1",
     "mcp~=1.26.0",
-    "uv~=0.9.13",
+    "uv~=0.11.6",
     "aiosqlite~=0.21.0",
     "pyyaml~=6.0",
     "aiofiles~=24.1.0",
diff --git a/uv.lock b/uv.lock
index 2ff663ea4..a5c381614 100644
--- a/uv.lock
+++ b/uv.lock
@@ -1374,7 +1374,7 @@ requires-dist = [
     { name = "tokenizers", specifier = ">=0.21,<1" },
     { name = "tomli", specifier = "~=2.0.2" },
     { name = "tomli-w", specifier = "~=1.1.0" },
-    { name = "uv", specifier = "~=0.9.13" },
+    { name = "uv", specifier = "~=0.11.6" },
     { name = "voyageai", marker = "extra == 'voyageai'", specifier = "~=0.3.5" },
 ]
 provides-extras = ["a2a", "anthropic", "aws", "azure-ai-inference", "bedrock", "docling", "embeddings", "file-processing", "google-genai", "litellm", "mem0", "openpyxl", "pandas", "qdrant", "qdrant-edge", "tools", "voyageai", "watson"]
@@ -8976,28 +8976,28 @@ wheels = [
 
 [[package]]
 name = "uv"
-version = "0.9.30"
+version = "0.11.6"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/4e/a0/63cea38fe839fb89592728b91928ee6d15705f1376a7940fee5bbc77fea0/uv-0.9.30.tar.gz", hash = "sha256:03ebd4b22769e0a8d825fa09d038e31cbab5d3d48edf755971cb0cec7920ab95", size = 3846526, upload-time = "2026-02-04T21:45:37.58Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/dd/f3/8aceeab67ea69805293ab290e7ca8cc1b61a064d28b8a35c76d8eba063dd/uv-0.11.6.tar.gz", hash = "sha256:e3b21b7e80024c95ff339fcd147ac6fc3dd98d3613c9d45d3a1f4fd1057f127b", size = 4073298, upload-time = "2026-04-09T12:09:01.738Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a3/3c/71be72f125f0035348b415468559cc3b335ec219376d17a3d242d2bd9b23/uv-0.9.30-py3-none-linux_armv6l.whl", hash = "sha256:a5467dddae1cd5f4e093f433c0f0d9a0df679b92696273485ec91bbb5a8620e6", size = 21927585, upload-time = "2026-02-04T21:46:14.935Z" },
-    { url = "https://files.pythonhosted.org/packages/0f/fd/8070b5423a77d4058d14e48a970aa075762bbff4c812dda3bb3171543e44/uv-0.9.30-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:6ec38ae29aa83a37c6e50331707eac8ecc90cf2b356d60ea6382a94de14973be", size = 21050392, upload-time = "2026-02-04T21:45:55.649Z" },
-    { url = "https://files.pythonhosted.org/packages/42/5f/3ccc9415ef62969ed01829572338ea7bdf4c5cf1ffb9edc1f8cb91b571f3/uv-0.9.30-py3-none-macosx_11_0_arm64.whl", hash = "sha256:777ecd117cf1d8d6bb07de8c9b7f6c5f3e802415b926cf059d3423699732eb8c", size = 19817085, upload-time = "2026-02-04T21:45:40.881Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/3f/76b44e2a224f4c4a8816fc92686ef6d4c2656bc5fc9d4f673816162c994d/uv-0.9.30-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl", hash = "sha256:93049ba3c41fa2cc38b467cb78ef61b2ddedca34b6be924a5481d7750c8111c6", size = 21620537, upload-time = "2026-02-04T21:45:47.846Z" },
-    { url = "https://files.pythonhosted.org/packages/60/2a/50f7e8c6d532af8dd327f77bdc75ce4652322ac34f5e29f79a8e04ea3cc8/uv-0.9.30-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.musllinux_1_1_armv7l.whl", hash = "sha256:f295604fee71224ebe2685a0f1f4ff7a45c77211a60bd57133a4a02056d7c775", size = 21550855, upload-time = "2026-02-04T21:46:26.269Z" },
-    { url = "https://files.pythonhosted.org/packages/0e/10/f823d4af1125fae559194b356757dc7d4a8ac79d10d11db32c2d4c9e2f63/uv-0.9.30-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2faf84e1f3b6fc347a34c07f1291d11acf000b0dd537a61d541020f22b17ccd9", size = 21516576, upload-time = "2026-02-04T21:46:03.494Z" },
-    { url = "https://files.pythonhosted.org/packages/91/f3/64b02db11f38226ed34458c7fbdb6f16b6d4fd951de24c3e51acf02b30f8/uv-0.9.30-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0b3b3700ecf64a09a07fd04d10ec35f0973ec15595d38bbafaa0318252f7e31f", size = 22718097, upload-time = "2026-02-04T21:45:51.875Z" },
-    { url = "https://files.pythonhosted.org/packages/28/21/a48d1872260f04a68bb5177b0f62ddef62ab892d544ed1922f2d19fd2b00/uv-0.9.30-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:b176fc2937937dd81820445cb7e7e2e3cd1009a003c512f55fa0ae10064c8a38", size = 24107844, upload-time = "2026-02-04T21:46:19.032Z" },
-    { url = "https://files.pythonhosted.org/packages/1c/c6/d7e5559bfe1ab7a215a7ad49c58c8a5701728f2473f7f436ef00b4664e88/uv-0.9.30-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:180e8070b8c438b9a3fb3fde8a37b365f85c3c06e17090f555dc68fdebd73333", size = 23685378, upload-time = "2026-02-04T21:46:07.166Z" },
-    { url = "https://files.pythonhosted.org/packages/a8/bf/b937bbd50d14c6286e353fd4c7bdc09b75f6b3a26bd4e2f3357e99891f28/uv-0.9.30-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4125a9aa2a751e1589728f6365cfe204d1be41499148ead44b6180b7df576f27", size = 22848471, upload-time = "2026-02-04T21:45:18.728Z" },
-    { url = "https://files.pythonhosted.org/packages/6a/57/12a67c569e69b71508ad669adad266221f0b1d374be88eaf60109f551354/uv-0.9.30-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4366dd740ac9ad3ec50a58868a955b032493bb7d7e6ed368289e6ced8bbc70f3", size = 22774258, upload-time = "2026-02-04T21:46:10.798Z" },
-    { url = "https://files.pythonhosted.org/packages/3d/b8/a26cc64685dddb9fb13f14c3dc1b12009f800083405f854f84eb8c86b494/uv-0.9.30-py3-none-manylinux_2_28_aarch64.whl", hash = "sha256:33e50f208e01a0c20b3c5f87d453356a5cbcfd68f19e47a28b274cd45618881c", size = 21699573, upload-time = "2026-02-04T21:45:44.365Z" },
-    { url = "https://files.pythonhosted.org/packages/c8/59/995af0c5f0740f8acb30468e720269e720352df1d204e82c2d52d9a8c586/uv-0.9.30-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:5e7a6fa7a3549ce893cf91fe4b06629e3e594fc1dca0a6050aba2ea08722e964", size = 22460799, upload-time = "2026-02-04T21:45:26.658Z" },
-    { url = "https://files.pythonhosted.org/packages/bb/0b/6affe815ecbaebf38b35d6230fbed2f44708c67d5dd5720f81f2ec8f96ff/uv-0.9.30-py3-none-musllinux_1_1_i686.whl", hash = "sha256:62d7e408d41e392b55ffa4cf9b07f7bbd8b04e0929258a42e19716c221ac0590", size = 22001777, upload-time = "2026-02-04T21:45:34.656Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/b6/47a515171c891b0d29f8e90c8a1c0e233e4813c95a011799605cfe04c74c/uv-0.9.30-py3-none-musllinux_1_1_x86_64.whl", hash = "sha256:6dc65c24f5b9cdc78300fa6631368d3106e260bbffa66fb1e831a318374da2df", size = 22968416, upload-time = "2026-02-04T21:45:22.863Z" },
-    { url = "https://files.pythonhosted.org/packages/3d/3a/c1df8615385138bb7c43342586431ca32b77466c5fb086ac0ed14ab6ca28/uv-0.9.30-py3-none-win32.whl", hash = "sha256:74e94c65d578657db94a753d41763d0364e5468ec0d368fb9ac8ddab0fb6e21f", size = 20889232, upload-time = "2026-02-04T21:46:22.617Z" },
-    { url = "https://files.pythonhosted.org/packages/f2/a8/e8761c8414a880d70223723946576069e042765475f73b4436d78b865dba/uv-0.9.30-py3-none-win_amd64.whl", hash = "sha256:88a2190810684830a1ba4bb1cf8fb06b0308988a1589559404259d295260891c", size = 23432208, upload-time = "2026-02-04T21:45:30.85Z" },
-    { url = "https://files.pythonhosted.org/packages/49/e8/6f2ebab941ec559f97110bbbae1279cd0333d6bc352b55f6fa3fefb020d9/uv-0.9.30-py3-none-win_arm64.whl", hash = "sha256:7fde83a5b5ea027315223c33c30a1ab2f2186910b933d091a1b7652da879e230", size = 21887273, upload-time = "2026-02-04T21:45:59.787Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/fe/4b61a3d5ad9d02e8a4405026ccd43593d7044598e0fa47d892d4dafe44c9/uv-0.11.6-py3-none-linux_armv6l.whl", hash = "sha256:ada04dcf89ddea5b69d27ac9cdc5ef575a82f90a209a1392e930de504b2321d6", size = 23780079, upload-time = "2026-04-09T12:08:56.609Z" },
+    { url = "https://files.pythonhosted.org/packages/52/db/d27519a9e1a5ffee9d71af1a811ad0e19ce7ab9ae815453bef39dd479389/uv-0.11.6-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:5be013888420f96879c6e0d3081e7bcf51b539b034a01777041934457dfbedf3", size = 23214721, upload-time = "2026-04-09T12:09:32.228Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/8f/4399fa8b882bd7e0efffc829f73ab24d117d490a93e6bc7104a50282b854/uv-0.11.6-py3-none-macosx_11_0_arm64.whl", hash = "sha256:ffa5dc1cbb52bdce3b8447e83d1601a57ad4da6b523d77d4b47366db8b1ceb18", size = 21750109, upload-time = "2026-04-09T12:09:24.357Z" },
+    { url = "https://files.pythonhosted.org/packages/32/07/5a12944c31c3dda253632da7a363edddb869ed47839d4d92a2dc5f546c93/uv-0.11.6-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl", hash = "sha256:bfb107b4dade1d2c9e572992b06992d51dd5f2136eb8ceee9e62dd124289e825", size = 23551146, upload-time = "2026-04-09T12:09:10.439Z" },
+    { url = "https://files.pythonhosted.org/packages/79/5b/2ec8b0af80acd1016ed596baf205ddc77b19ece288473b01926c4a9cf6db/uv-0.11.6-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.musllinux_1_1_armv7l.whl", hash = "sha256:9e2fe7ce12161d8016b7deb1eaad7905a76ff7afec13383333ca75e0c4b5425d", size = 23331192, upload-time = "2026-04-09T12:09:34.792Z" },
+    { url = "https://files.pythonhosted.org/packages/62/7d/eea35935f2112b21c296a3e42645f3e4b1aa8bcd34dcf13345fbd55134b7/uv-0.11.6-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:7ed9c6f70c25e8dfeedddf4eddaf14d353f5e6b0eb43da9a14d3a1033d51d915", size = 23337686, upload-time = "2026-04-09T12:09:18.522Z" },
+    { url = "https://files.pythonhosted.org/packages/21/47/2584f5ab618f6ebe9bdefb2f765f2ca8540e9d739667606a916b35449eec/uv-0.11.6-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d68a013e609cebf82077cbeeb0809ed5e205257814273bfd31e02fc0353bbfc2", size = 25008139, upload-time = "2026-04-09T12:09:03.983Z" },
+    { url = "https://files.pythonhosted.org/packages/95/81/497ae5c1d36355b56b97dc59f550c7e89d0291c163a3f203c6f341dff195/uv-0.11.6-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:93f736dddca03dae732c6fdea177328d3bc4bf137c75248f3d433c57416a4311", size = 25712458, upload-time = "2026-04-09T12:09:07.598Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/1c/74083238e4fab2672b63575b9008f1ea418b02a714bcfcf017f4f6a309b6/uv-0.11.6-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e96a66abe53fced0e3389008b8d2eff8278cfa8bb545d75631ae8ceb9c929aba", size = 24915507, upload-time = "2026-04-09T12:08:50.892Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/ee/e14fe10ba455a823ed18233f12de6699a601890905420b5c504abf115116/uv-0.11.6-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b096311b2743b228df911a19532b3f18fa420bf9530547aecd6a8e04bbfaccd", size = 24971011, upload-time = "2026-04-09T12:08:54.016Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/a1/7b9c83eaadf98e343317ff6384a7227a4855afd02cdaf9696bcc71ee6155/uv-0.11.6-py3-none-manylinux_2_28_aarch64.whl", hash = "sha256:904d537b4a6e798015b4a64ff5622023bd4601b43b6cd1e5f423d63471f5e948", size = 23640234, upload-time = "2026-04-09T12:09:15.735Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/51/75ccdd23e76ff1703b70eb82881cd5b4d2a954c9679f8ef7e0136ef2cfab/uv-0.11.6-py3-none-manylinux_2_31_riscv64.musllinux_1_1_riscv64.whl", hash = "sha256:4ed8150c26b5e319381d75ae2ce6aba1e9c65888f4850f4e3b3fa839953c90a5", size = 24452664, upload-time = "2026-04-09T12:09:26.875Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/86/ace80fe47d8d48b5e3b5aee0b6eb1a49deaacc2313782870250b3faa36f5/uv-0.11.6-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:1c9218c8d4ac35ca6e617fb0951cc0ab2d907c91a6aea2617de0a5494cf162c0", size = 24494599, upload-time = "2026-04-09T12:09:37.368Z" },
+    { url = "https://files.pythonhosted.org/packages/05/2d/4b642669b56648194f026de79bc992cbfc3ac2318b0a8d435f3c284934e8/uv-0.11.6-py3-none-musllinux_1_1_i686.whl", hash = "sha256:9e211c83cc890c569b86a4183fcf5f8b6f0c7adc33a839b699a98d30f1310d3a", size = 24159150, upload-time = "2026-04-09T12:09:13.17Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/24/7eecd76fe983a74fed1fc700a14882e70c4e857f1d562a9f2303d4286c12/uv-0.11.6-py3-none-musllinux_1_1_x86_64.whl", hash = "sha256:d2a1d2089afdf117ad19a4c1dd36b8189c00ae1ad4135d3bfbfced82342595cf", size = 25164324, upload-time = "2026-04-09T12:08:59.56Z" },
+    { url = "https://files.pythonhosted.org/packages/27/e0/bbd4ba7c2e5067bbba617d87d306ec146889edaeeaa2081d3e122178ca08/uv-0.11.6-py3-none-win32.whl", hash = "sha256:6e8344f38fa29f85dcfd3e62dc35a700d2448f8e90381077ef393438dcd5012e", size = 22865693, upload-time = "2026-04-09T12:09:21.415Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/33/1983ce113c538a856f2d620d16e39691962ecceef091a84086c5785e32e5/uv-0.11.6-py3-none-win_amd64.whl", hash = "sha256:a28bea69c1186303d1200f155c7a28c449f8a4431e458fcf89360cc7ef546e40", size = 25371258, upload-time = "2026-04-09T12:09:40.52Z" },
+    { url = "https://files.pythonhosted.org/packages/35/01/be0873f44b9c9bc250fcbf263367fcfc1f59feab996355bcb6b52fff080d/uv-0.11.6-py3-none-win_arm64.whl", hash = "sha256:a78f6d64b9950e24061bc7ec7f15ff8089ad7f5a976e7b65fcadce58fe02f613", size = 23869585, upload-time = "2026-04-09T12:09:29.425Z" },
 ]
 
 [[package]]

From 8de44217055a9f478817034816abd1bed4c8ff0e Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Sat, 11 Apr 2026 05:26:48 +0800
Subject: [PATCH 33/70] fix: sanitize tool schemas for strict mode

Pydantic schemas intermittently fail strict tool-use on openai, anthropic,
and bedrock. All three reject nested objects missing additionalProperties:
false, and anthropic also rejects keywords like minLength and top-level
anyOf. Adds per-provider sanitizers that inline refs, close objects, mark
every property required, preserve nullable unions, and strip keywords each
grammar compiler rejects. Verified against real bedrock, anthropic, and
openai.
---
 .../llms/providers/anthropic/completion.py    |  20 ++-
 .../llms/providers/bedrock/completion.py      |  21 +++-
 .../llms/providers/openai/completion.py       |  18 ++-
 .../crewai/utilities/pydantic_schema_utils.py | 115 +++++++++++++++++-
 4 files changed, 151 insertions(+), 23 deletions(-)

diff --git a/lib/crewai/src/crewai/llms/providers/anthropic/completion.py b/lib/crewai/src/crewai/llms/providers/anthropic/completion.py
index 0d666a63c..c0e854ce0 100644
--- a/lib/crewai/src/crewai/llms/providers/anthropic/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/anthropic/completion.py
@@ -11,10 +11,14 @@ from crewai.events.types.llm_events import LLMCallType
 from crewai.llms.base_llm import BaseLLM, JsonResponseFormat, llm_call_context
 from crewai.llms.hooks.base import BaseInterceptor
 from crewai.llms.hooks.transport import AsyncHTTPTransport, HTTPTransport
+from crewai.llms.providers.utils.common import safe_tool_conversion
 from crewai.utilities.agent_utils import is_context_length_exceeded
 from crewai.utilities.exceptions.context_window_exceeding_exception import (
     LLMContextLengthExceededError,
 )
+from crewai.utilities.pydantic_schema_utils import (
+    sanitize_tool_params_for_anthropic_strict,
+)
 from crewai.utilities.types import LLMMessage
 
 
@@ -473,10 +477,8 @@ class AnthropicCompletion(BaseLLM):
                 continue
 
             try:
-                from crewai.llms.providers.utils.common import safe_tool_conversion
-
                 name, description, parameters = safe_tool_conversion(tool, "Anthropic")
-            except (ImportError, KeyError, ValueError) as e:
+            except (KeyError, ValueError) as e:
                 logging.error(f"Error converting tool to Anthropic format: {e}")
                 raise e
 
@@ -485,8 +487,15 @@ class AnthropicCompletion(BaseLLM):
                 "description": description,
             }
 
+            func_info = tool.get("function", {})
+            strict_enabled = bool(func_info.get("strict"))
+
             if parameters and isinstance(parameters, dict):
-                anthropic_tool["input_schema"] = parameters
+                anthropic_tool["input_schema"] = (
+                    sanitize_tool_params_for_anthropic_strict(parameters)
+                    if strict_enabled
+                    else parameters
+                )
             else:
                 anthropic_tool["input_schema"] = {
                     "type": "object",
@@ -494,8 +503,7 @@ class AnthropicCompletion(BaseLLM):
                     "required": [],
                 }
 
-            func_info = tool.get("function", {})
-            if func_info.get("strict"):
+            if strict_enabled:
                 anthropic_tool["strict"] = True
 
             anthropic_tools.append(anthropic_tool)
diff --git a/lib/crewai/src/crewai/llms/providers/bedrock/completion.py b/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
index 0747b7006..75fe712b5 100644
--- a/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
@@ -12,11 +12,15 @@ from typing_extensions import Required
 
 from crewai.events.types.llm_events import LLMCallType
 from crewai.llms.base_llm import BaseLLM, llm_call_context
+from crewai.llms.providers.utils.common import safe_tool_conversion
 from crewai.utilities.agent_utils import is_context_length_exceeded
 from crewai.utilities.exceptions.context_window_exceeding_exception import (
     LLMContextLengthExceededError,
 )
-from crewai.utilities.pydantic_schema_utils import generate_model_description
+from crewai.utilities.pydantic_schema_utils import (
+    generate_model_description,
+    sanitize_tool_params_for_bedrock_strict,
+)
 from crewai.utilities.types import LLMMessage
 
 
@@ -1949,8 +1953,6 @@ class BedrockCompletion(BaseLLM):
         tools: list[dict[str, Any]],
     ) -> list[ConverseToolTypeDef]:
         """Convert CrewAI tools to Converse API format following AWS specification."""
-        from crewai.llms.providers.utils.common import safe_tool_conversion
-
         converse_tools: list[ConverseToolTypeDef] = []
 
         for tool in tools:
@@ -1962,12 +1964,19 @@ class BedrockCompletion(BaseLLM):
                     "description": description,
                 }
 
+                func_info = tool.get("function", {})
+                strict_enabled = bool(func_info.get("strict"))
+
                 if parameters and isinstance(parameters, dict):
-                    input_schema: ToolInputSchema = {"json": parameters}
+                    schema_params = (
+                        sanitize_tool_params_for_bedrock_strict(parameters)
+                        if strict_enabled
+                        else parameters
+                    )
+                    input_schema: ToolInputSchema = {"json": schema_params}
                     tool_spec["inputSchema"] = input_schema
 
-                func_info = tool.get("function", {})
-                if func_info.get("strict"):
+                if strict_enabled:
                     tool_spec["strict"] = True
 
                 converse_tool: ConverseToolTypeDef = {"toolSpec": tool_spec}
diff --git a/lib/crewai/src/crewai/llms/providers/openai/completion.py b/lib/crewai/src/crewai/llms/providers/openai/completion.py
index 668794e83..e9509e7d2 100644
--- a/lib/crewai/src/crewai/llms/providers/openai/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/openai/completion.py
@@ -32,11 +32,15 @@ from crewai.events.types.llm_events import LLMCallType
 from crewai.llms.base_llm import BaseLLM, JsonResponseFormat, llm_call_context
 from crewai.llms.hooks.base import BaseInterceptor
 from crewai.llms.hooks.transport import AsyncHTTPTransport, HTTPTransport
+from crewai.llms.providers.utils.common import safe_tool_conversion
 from crewai.utilities.agent_utils import is_context_length_exceeded
 from crewai.utilities.exceptions.context_window_exceeding_exception import (
     LLMContextLengthExceededError,
 )
-from crewai.utilities.pydantic_schema_utils import generate_model_description
+from crewai.utilities.pydantic_schema_utils import (
+    generate_model_description,
+    sanitize_tool_params_for_openai_strict,
+)
 from crewai.utilities.types import LLMMessage
 
 
@@ -764,8 +768,6 @@ class OpenAICompletion(BaseLLM):
             "function": {"name": "...", "description": "...", "parameters": {...}}
         }
         """
-        from crewai.llms.providers.utils.common import safe_tool_conversion
-
         responses_tools = []
 
         for tool in tools:
@@ -1548,11 +1550,6 @@ class OpenAICompletion(BaseLLM):
         self, tools: list[dict[str, BaseTool]]
     ) -> list[dict[str, Any]]:
         """Convert CrewAI tool format to OpenAI function calling format."""
-        from crewai.llms.providers.utils.common import safe_tool_conversion
-        from crewai.utilities.pydantic_schema_utils import (
-            force_additional_properties_false,
-        )
-
         openai_tools = []
 
         for tool in tools:
@@ -1571,8 +1568,9 @@ class OpenAICompletion(BaseLLM):
                 params_dict = (
                     parameters if isinstance(parameters, dict) else dict(parameters)
                 )
-                params_dict = force_additional_properties_false(params_dict)
-                openai_tool["function"]["parameters"] = params_dict
+                openai_tool["function"]["parameters"] = (
+                    sanitize_tool_params_for_openai_strict(params_dict)
+                )
 
             openai_tools.append(openai_tool)
         return openai_tools
diff --git a/lib/crewai/src/crewai/utilities/pydantic_schema_utils.py b/lib/crewai/src/crewai/utilities/pydantic_schema_utils.py
index 62536cbe7..4c69c9bf6 100644
--- a/lib/crewai/src/crewai/utilities/pydantic_schema_utils.py
+++ b/lib/crewai/src/crewai/utilities/pydantic_schema_utils.py
@@ -19,7 +19,7 @@ from collections.abc import Callable
 from copy import deepcopy
 import datetime
 import logging
-from typing import TYPE_CHECKING, Annotated, Any, Final, Literal, TypedDict, Union
+from typing import TYPE_CHECKING, Annotated, Any, Final, Literal, TypedDict, Union, cast
 import uuid
 
 import jsonref  # type: ignore[import-untyped]
@@ -417,6 +417,119 @@ def strip_null_from_types(schema: dict[str, Any]) -> dict[str, Any]:
     return schema
 
 
+_STRICT_METADATA_KEYS: Final[tuple[str, ...]] = (
+    "title",
+    "default",
+    "examples",
+    "example",
+    "$comment",
+    "readOnly",
+    "writeOnly",
+    "deprecated",
+)
+
+_CLAUDE_STRICT_UNSUPPORTED: Final[tuple[str, ...]] = (
+    "minimum",
+    "maximum",
+    "exclusiveMinimum",
+    "exclusiveMaximum",
+    "multipleOf",
+    "minLength",
+    "maxLength",
+    "pattern",
+    "minItems",
+    "maxItems",
+    "uniqueItems",
+    "minContains",
+    "maxContains",
+    "minProperties",
+    "maxProperties",
+    "patternProperties",
+    "propertyNames",
+    "dependentRequired",
+    "dependentSchemas",
+)
+
+
+def _strip_keys_recursive(d: Any, keys: tuple[str, ...]) -> Any:
+    """Recursively delete a fixed set of keys from a schema."""
+    if isinstance(d, dict):
+        for key in keys:
+            d.pop(key, None)
+        for v in d.values():
+            _strip_keys_recursive(v, keys)
+    elif isinstance(d, list):
+        for i in d:
+            _strip_keys_recursive(i, keys)
+    return d
+
+
+def lift_top_level_anyof(schema: dict[str, Any]) -> dict[str, Any]:
+    """Unwrap a top-level anyOf/oneOf/allOf wrapping a single object variant.
+
+    Anthropic's strict ``input_schema`` rejects top-level union keywords. When
+    exactly one variant is an object schema, lift it so the root is a plain
+    object; otherwise leave the schema alone.
+    """
+    for key in ("anyOf", "oneOf", "allOf"):
+        variants = schema.get(key)
+        if not isinstance(variants, list):
+            continue
+        object_variants = [
+            v for v in variants if isinstance(v, dict) and v.get("type") == "object"
+        ]
+        if len(object_variants) == 1:
+            lifted = deepcopy(object_variants[0])
+            schema.pop(key)
+            schema.update(lifted)
+            break
+    return schema
+
+
+def _common_strict_pipeline(params: dict[str, Any]) -> dict[str, Any]:
+    """Shared strict sanitization: inline refs, close objects, require all properties."""
+    sanitized = resolve_refs(deepcopy(params))
+    sanitized.pop("$defs", None)
+    sanitized = convert_oneof_to_anyof(sanitized)
+    sanitized = ensure_type_in_schemas(sanitized)
+    sanitized = force_additional_properties_false(sanitized)
+    sanitized = ensure_all_properties_required(sanitized)
+    return cast(dict[str, Any], _strip_keys_recursive(sanitized, _STRICT_METADATA_KEYS))
+
+
+def sanitize_tool_params_for_openai_strict(
+    params: dict[str, Any],
+) -> dict[str, Any]:
+    """Sanitize a JSON schema for OpenAI strict function calling."""
+    if not isinstance(params, dict):
+        return params
+    return cast(
+        dict[str, Any], strip_unsupported_formats(_common_strict_pipeline(params))
+    )
+
+
+def sanitize_tool_params_for_anthropic_strict(
+    params: dict[str, Any],
+) -> dict[str, Any]:
+    """Sanitize a JSON schema for Anthropic strict tool use."""
+    if not isinstance(params, dict):
+        return params
+    sanitized = lift_top_level_anyof(_common_strict_pipeline(params))
+    sanitized = _strip_keys_recursive(sanitized, _CLAUDE_STRICT_UNSUPPORTED)
+    return cast(dict[str, Any], strip_unsupported_formats(sanitized))
+
+
+def sanitize_tool_params_for_bedrock_strict(
+    params: dict[str, Any],
+) -> dict[str, Any]:
+    """Sanitize a JSON schema for Bedrock Converse strict tool use.
+
+    Bedrock Converse uses the same grammar compiler as the underlying Claude
+    model, so the constraints match Anthropic's.
+    """
+    return sanitize_tool_params_for_anthropic_strict(params)
+
+
 def generate_model_description(
     model: type[BaseModel],
     *,

From 3b280e41fb6e3da7eb641a05de0f202d4147fcd5 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Sat, 11 Apr 2026 05:56:11 +0800
Subject: [PATCH 34/70] chore: bump pypdf to 6.10.0 for GHSA-3crg-w4f6-42mx

Resolves CVE-2026-40260 where manipulated XMP metadata entity
declarations can exhaust RAM in pypdf <6.10.0.
---
 lib/crewai-files/pyproject.toml | 2 +-
 uv.lock                         | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/lib/crewai-files/pyproject.toml b/lib/crewai-files/pyproject.toml
index 99f7c15c5..0302b5900 100644
--- a/lib/crewai-files/pyproject.toml
+++ b/lib/crewai-files/pyproject.toml
@@ -9,7 +9,7 @@ authors = [
 requires-python = ">=3.10, <3.14"
 dependencies = [
     "Pillow~=12.1.1",
-    "pypdf~=6.9.1",
+    "pypdf~=6.10.0",
     "python-magic>=0.4.27",
     "aiocache~=0.12.3",
     "aiofiles~=24.1.0",
diff --git a/uv.lock b/uv.lock
index a5c381614..e6b7a9de4 100644
--- a/uv.lock
+++ b/uv.lock
@@ -1420,7 +1420,7 @@ requires-dist = [
     { name = "aiofiles", specifier = "~=24.1.0" },
     { name = "av", specifier = "~=13.0.0" },
     { name = "pillow", specifier = "~=12.1.1" },
-    { name = "pypdf", specifier = "~=6.9.1" },
+    { name = "pypdf", specifier = "~=6.10.0" },
     { name = "python-magic", specifier = ">=0.4.27" },
     { name = "tinytag", specifier = "~=2.2.1" },
 ]
@@ -6724,14 +6724,14 @@ wheels = [
 
 [[package]]
 name = "pypdf"
-version = "6.9.2"
+version = "6.10.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/31/83/691bdb309306232362503083cb15777491045dd54f45393a317dc7d8082f/pypdf-6.9.2.tar.gz", hash = "sha256:7f850faf2b0d4ab936582c05da32c52214c2b089d61a316627b5bfb5b0dab46c", size = 5311837, upload-time = "2026-03-23T14:53:27.983Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/b8/9f/ca96abf18683ca12602065e4ed2bec9050b672c87d317f1079abc7b6d993/pypdf-6.10.0.tar.gz", hash = "sha256:4c5a48ba258c37024ec2505f7e8fd858525f5502784a2e1c8d415604af29f6ef", size = 5314833, upload-time = "2026-04-10T09:34:57.102Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a5/7e/c85f41243086a8fe5d1baeba527cb26a1918158a565932b41e0f7c0b32e9/pypdf-6.9.2-py3-none-any.whl", hash = "sha256:662cf29bcb419a36a1365232449624ab40b7c2d0cfc28e54f42eeecd1fd7e844", size = 333744, upload-time = "2026-03-23T14:53:26.573Z" },
+    { url = "https://files.pythonhosted.org/packages/55/f2/7ebe366f633f30a6ad105f650f44f24f98cb1335c4157d21ae47138b3482/pypdf-6.10.0-py3-none-any.whl", hash = "sha256:90005e959e1596c6e6c84c8b0ad383285b3e17011751cedd17f2ce8fcdfc86de", size = 334459, upload-time = "2026-04-10T09:34:54.966Z" },
 ]
 
 [[package]]

From 25fcf39cc1030b841dc5b8c3f855a7784c5fa8e4 Mon Sep 17 00:00:00 2001
From: Yanhu <huangfuyang900204@gmail.com>
Date: Sun, 12 Apr 2026 15:50:56 +0800
Subject: [PATCH 35/70] fix: preserve Bedrock tool call arguments by removing
 truthy default

func_info.get('arguments', '{}') returns '{}' (truthy) when no
'function' wrapper exists (Bedrock format), causing the or-fallback
to tool_call.get('input', {}) to never execute. The actual Bedrock
arguments are silently discarded.

Remove the default so get('arguments') returns None (falsy) when
there's no function wrapper, allowing the or-chain to correctly
fall through to Bedrock's 'input' field.

Fixes #5275
---
 lib/crewai/src/crewai/agents/crew_agent_executor.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/crewai/src/crewai/agents/crew_agent_executor.py b/lib/crewai/src/crewai/agents/crew_agent_executor.py
index 909fa5c66..b98840cae 100644
--- a/lib/crewai/src/crewai/agents/crew_agent_executor.py
+++ b/lib/crewai/src/crewai/agents/crew_agent_executor.py
@@ -827,7 +827,7 @@ class CrewAgentExecutor(BaseAgentExecutor):
             func_name = sanitize_tool_name(
                 func_info.get("name", "") or tool_call.get("name", "")
             )
-            func_args = func_info.get("arguments", "{}") or tool_call.get("input", {})
+            func_args = func_info.get("arguments") or tool_call.get("input", {})
             return call_id, func_name, func_args
         return None
 

From 29fc4ac226a6827cb4064b68f3261f71f9e3ea27 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Sun, 12 Apr 2026 16:00:46 +0800
Subject: [PATCH 36/70] feat: add deploy validation CLI and improve LLM
 initialization ergonomics

Add crewai deploy validate to check project structure, dependencies, imports, and env usage before deploy
Run validation automatically in deploy create and deploy push with skip flag support
Return structured findings with stable codes and hints
Add test coverage for validation scenarios

refactor: defer LLM client construction to first use

Move SDK client creation out of model initialization into lazy getters
Add _get_sync_client and _get_async_client across providers
Route all provider calls through lazy getters
Surface credential errors at first real invocation

refactor: standardize provider client access

Align async paths to use _get_async_client
Avoid client construction in lightweight config accessors
Simplify provider lifecycle and improve consistency

test: update suite for new behavior

Update tests for lazy initialization contract
Update CLI tests for validation flow and skip flag
Expand coverage for provider initialization paths
---
 lib/crewai/src/crewai/cli/cli.py              |  31 +-
 lib/crewai/src/crewai/cli/deploy/main.py      |  36 +-
 lib/crewai/src/crewai/cli/deploy/validate.py  | 845 ++++++++++++++++++
 .../llms/providers/anthropic/completion.py    |  78 +-
 .../crewai/llms/providers/azure/completion.py | 116 ++-
 .../llms/providers/bedrock/completion.py      |  34 +-
 .../llms/providers/gemini/completion.py       |  37 +-
 .../llms/providers/openai/completion.py       |  78 +-
 .../tests/cli/deploy/test_deploy_main.py      |   6 +-
 lib/crewai/tests/cli/deploy/test_validate.py  | 430 +++++++++
 lib/crewai/tests/cli/test_cli.py              |   4 +-
 lib/crewai/tests/llms/azure/test_azure.py     |  62 +-
 lib/crewai/tests/llms/google/test_google.py   |  17 +
 lib/crewai/tests/utilities/test_llm_utils.py  |   6 +-
 14 files changed, 1674 insertions(+), 106 deletions(-)
 create mode 100644 lib/crewai/src/crewai/cli/deploy/validate.py
 create mode 100644 lib/crewai/tests/cli/deploy/test_validate.py

diff --git a/lib/crewai/src/crewai/cli/cli.py b/lib/crewai/src/crewai/cli/cli.py
index 03bdcd502..2e10d5162 100644
--- a/lib/crewai/src/crewai/cli/cli.py
+++ b/lib/crewai/src/crewai/cli/cli.py
@@ -392,10 +392,15 @@ def deploy() -> None:
 
 @deploy.command(name="create")
 @click.option("-y", "--yes", is_flag=True, help="Skip the confirmation prompt")
-def deploy_create(yes: bool) -> None:
+@click.option(
+    "--skip-validate",
+    is_flag=True,
+    help="Skip the pre-deploy validation checks.",
+)
+def deploy_create(yes: bool, skip_validate: bool) -> None:
     """Create a Crew deployment."""
     deploy_cmd = DeployCommand()
-    deploy_cmd.create_crew(yes)
+    deploy_cmd.create_crew(yes, skip_validate=skip_validate)
 
 
 @deploy.command(name="list")
@@ -407,10 +412,28 @@ def deploy_list() -> None:
 
 @deploy.command(name="push")
 @click.option("-u", "--uuid", type=str, help="Crew UUID parameter")
-def deploy_push(uuid: str | None) -> None:
+@click.option(
+    "--skip-validate",
+    is_flag=True,
+    help="Skip the pre-deploy validation checks.",
+)
+def deploy_push(uuid: str | None, skip_validate: bool) -> None:
     """Deploy the Crew."""
     deploy_cmd = DeployCommand()
-    deploy_cmd.deploy(uuid=uuid)
+    deploy_cmd.deploy(uuid=uuid, skip_validate=skip_validate)
+
+
+@deploy.command(name="validate")
+def deploy_validate() -> None:
+    """Validate the current project against common deployment failures.
+
+    Runs the same pre-deploy checks that `crewai deploy create` and
+    `crewai deploy push` run automatically, without contacting the platform.
+    Exits non-zero if any blocking issues are found.
+    """
+    from crewai.cli.deploy.validate import run_validate_command
+
+    run_validate_command()
 
 
 @deploy.command(name="status")
diff --git a/lib/crewai/src/crewai/cli/deploy/main.py b/lib/crewai/src/crewai/cli/deploy/main.py
index f5a32eb8e..5a677ba5d 100644
--- a/lib/crewai/src/crewai/cli/deploy/main.py
+++ b/lib/crewai/src/crewai/cli/deploy/main.py
@@ -4,12 +4,35 @@ from rich.console import Console
 
 from crewai.cli import git
 from crewai.cli.command import BaseCommand, PlusAPIMixin
+from crewai.cli.deploy.validate import validate_project
 from crewai.cli.utils import fetch_and_json_env_file, get_project_name
 
 
 console = Console()
 
 
+def _run_predeploy_validation(skip_validate: bool) -> bool:
+    """Run pre-deploy validation unless skipped.
+
+    Returns True if deployment should proceed, False if it should abort.
+    """
+    if skip_validate:
+        console.print(
+            "[yellow]Skipping pre-deploy validation (--skip-validate).[/yellow]"
+        )
+        return True
+
+    console.print("Running pre-deploy validation...", style="bold blue")
+    validator = validate_project()
+    if not validator.ok:
+        console.print(
+            "\n[bold red]Pre-deploy validation failed. "
+            "Fix the issues above or re-run with --skip-validate.[/bold red]"
+        )
+        return False
+    return True
+
+
 class DeployCommand(BaseCommand, PlusAPIMixin):
     """
     A class to handle deployment-related operations for CrewAI projects.
@@ -60,13 +83,16 @@ class DeployCommand(BaseCommand, PlusAPIMixin):
                 f"{log_message['timestamp']} - {log_message['level']}: {log_message['message']}"
             )
 
-    def deploy(self, uuid: str | None = None) -> None:
+    def deploy(self, uuid: str | None = None, skip_validate: bool = False) -> None:
         """
         Deploy a crew using either UUID or project name.
 
         Args:
             uuid (Optional[str]): The UUID of the crew to deploy.
+            skip_validate (bool): Skip pre-deploy validation checks.
         """
+        if not _run_predeploy_validation(skip_validate):
+            return
         self._telemetry.start_deployment_span(uuid)
         console.print("Starting deployment...", style="bold blue")
         if uuid:
@@ -80,10 +106,16 @@ class DeployCommand(BaseCommand, PlusAPIMixin):
         self._validate_response(response)
         self._display_deployment_info(response.json())
 
-    def create_crew(self, confirm: bool = False) -> None:
+    def create_crew(self, confirm: bool = False, skip_validate: bool = False) -> None:
         """
         Create a new crew deployment.
+
+        Args:
+            confirm (bool): Whether to skip the interactive confirmation prompt.
+            skip_validate (bool): Skip pre-deploy validation checks.
         """
+        if not _run_predeploy_validation(skip_validate):
+            return
         self._telemetry.create_crew_deployment_span()
         console.print("Creating deployment...", style="bold blue")
         env_vars = fetch_and_json_env_file()
diff --git a/lib/crewai/src/crewai/cli/deploy/validate.py b/lib/crewai/src/crewai/cli/deploy/validate.py
new file mode 100644
index 000000000..55246e102
--- /dev/null
+++ b/lib/crewai/src/crewai/cli/deploy/validate.py
@@ -0,0 +1,845 @@
+"""Pre-deploy validation for CrewAI projects.
+
+Catches locally what a deploy would reject at build or runtime so users
+don't burn deployment attempts on fixable project-structure problems.
+
+Each check is grouped into one of:
+- ERROR: will block a deployment; validator exits non-zero.
+- WARNING: may still deploy but is almost always a deployment bug; printed
+  but does not block.
+
+The individual checks mirror the categories observed in production
+deployment-failure logs:
+
+1. pyproject.toml present with ``[project].name``
+2. lockfile (``uv.lock`` or ``poetry.lock``) present and not stale
+3. package directory at ``src/<package>/`` exists (no empty name, no egg-info)
+4. standard crew files: ``crew.py``, ``config/agents.yaml``, ``config/tasks.yaml``
+5. flow entrypoint: ``main.py`` with a Flow subclass
+6. hatch wheel target resolves (packages = [...] or default dir matches name)
+7. crew/flow module imports cleanly (catches ``@CrewBase not found``,
+   ``No Flow subclass found``, provider import errors)
+8. environment variables referenced in code vs ``.env`` / deployment env
+9. installed crewai vs lockfile pin (catches missing-attribute failures from
+   stale pins)
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import Enum
+import json
+import logging
+import os
+from pathlib import Path
+import re
+import shutil
+import subprocess
+import sys
+from typing import Any
+
+from rich.console import Console
+
+from crewai.cli.utils import parse_toml
+
+
+console = Console()
+logger = logging.getLogger(__name__)
+
+
+class Severity(str, Enum):
+    """Severity of a validation finding."""
+
+    ERROR = "error"
+    WARNING = "warning"
+
+
+@dataclass
+class ValidationResult:
+    """A single finding from a validation check.
+
+    Attributes:
+        severity: whether this blocks deploy or is advisory.
+        code: stable short identifier, used in tests and docs
+            (e.g. ``missing_pyproject``, ``stale_lockfile``).
+        title: one-line summary shown to the user.
+        detail: optional multi-line explanation.
+        hint: optional remediation suggestion.
+    """
+
+    severity: Severity
+    code: str
+    title: str
+    detail: str = ""
+    hint: str = ""
+
+
+# Maps known provider env var names → label used in hint messages.
+_KNOWN_API_KEY_HINTS: dict[str, str] = {
+    "OPENAI_API_KEY": "OpenAI",
+    "ANTHROPIC_API_KEY": "Anthropic",
+    "GOOGLE_API_KEY": "Google",
+    "GEMINI_API_KEY": "Gemini",
+    "AZURE_OPENAI_API_KEY": "Azure OpenAI",
+    "AZURE_API_KEY": "Azure",
+    "AWS_ACCESS_KEY_ID": "AWS",
+    "AWS_SECRET_ACCESS_KEY": "AWS",
+    "COHERE_API_KEY": "Cohere",
+    "GROQ_API_KEY": "Groq",
+    "MISTRAL_API_KEY": "Mistral",
+    "TAVILY_API_KEY": "Tavily",
+    "SERPER_API_KEY": "Serper",
+    "SERPLY_API_KEY": "Serply",
+    "PERPLEXITY_API_KEY": "Perplexity",
+    "DEEPSEEK_API_KEY": "DeepSeek",
+    "OPENROUTER_API_KEY": "OpenRouter",
+    "FIRECRAWL_API_KEY": "Firecrawl",
+    "EXA_API_KEY": "Exa",
+    "BROWSERBASE_API_KEY": "Browserbase",
+}
+
+
+def normalize_package_name(project_name: str) -> str:
+    """Normalize a pyproject project.name into a Python package directory name.
+
+    Mirrors the rules in ``crewai.cli.create_crew.create_crew`` so the
+    validator agrees with the scaffolder about where ``src/<pkg>/`` should
+    live.
+    """
+    folder = project_name.replace(" ", "_").replace("-", "_").lower()
+    return re.sub(r"[^a-zA-Z0-9_]", "", folder)
+
+
+class DeployValidator:
+    """Runs the full pre-deploy validation suite against a project directory."""
+
+    def __init__(self, project_root: Path | None = None) -> None:
+        self.project_root: Path = (project_root or Path.cwd()).resolve()
+        self.results: list[ValidationResult] = []
+        self._pyproject: dict[str, Any] | None = None
+        self._project_name: str | None = None
+        self._package_name: str | None = None
+        self._package_dir: Path | None = None
+        self._is_flow: bool = False
+
+    def _add(
+        self,
+        severity: Severity,
+        code: str,
+        title: str,
+        detail: str = "",
+        hint: str = "",
+    ) -> None:
+        self.results.append(
+            ValidationResult(
+                severity=severity,
+                code=code,
+                title=title,
+                detail=detail,
+                hint=hint,
+            )
+        )
+
+    @property
+    def errors(self) -> list[ValidationResult]:
+        return [r for r in self.results if r.severity is Severity.ERROR]
+
+    @property
+    def warnings(self) -> list[ValidationResult]:
+        return [r for r in self.results if r.severity is Severity.WARNING]
+
+    @property
+    def ok(self) -> bool:
+        return not self.errors
+
+    def run(self) -> list[ValidationResult]:
+        """Run all checks. Later checks are skipped when earlier ones make
+        them impossible (e.g. no pyproject.toml → no lockfile check)."""
+        if not self._check_pyproject():
+            return self.results
+
+        self._check_lockfile()
+
+        if not self._check_package_dir():
+            self._check_hatch_wheel_target()
+            return self.results
+
+        if self._is_flow:
+            self._check_flow_entrypoint()
+        else:
+            self._check_crew_entrypoint()
+            self._check_config_yamls()
+
+        self._check_hatch_wheel_target()
+        self._check_module_imports()
+        self._check_env_vars()
+        self._check_version_vs_lockfile()
+
+        return self.results
+
+    def _check_pyproject(self) -> bool:
+        pyproject_path = self.project_root / "pyproject.toml"
+        if not pyproject_path.exists():
+            self._add(
+                Severity.ERROR,
+                "missing_pyproject",
+                "Cannot find pyproject.toml",
+                detail=(
+                    f"Expected pyproject.toml at {pyproject_path}. "
+                    "CrewAI projects must be installable Python packages."
+                ),
+                hint="Run `crewai create crew <name>` to scaffold a valid project layout.",
+            )
+            return False
+
+        try:
+            self._pyproject = parse_toml(pyproject_path.read_text())
+        except Exception as e:
+            self._add(
+                Severity.ERROR,
+                "invalid_pyproject",
+                "pyproject.toml is not valid TOML",
+                detail=str(e),
+            )
+            return False
+
+        project = self._pyproject.get("project") or {}
+        name = project.get("name")
+        if not isinstance(name, str) or not name.strip():
+            self._add(
+                Severity.ERROR,
+                "missing_project_name",
+                "pyproject.toml is missing [project].name",
+                detail=(
+                    "Without a project name the platform cannot resolve your "
+                    "package directory (this produces errors like "
+                    "'Cannot find src//crew.py')."
+                ),
+                hint='Set a `name = "..."` field under `[project]` in pyproject.toml.',
+            )
+            return False
+
+        self._project_name = name
+        self._package_name = normalize_package_name(name)
+        self._is_flow = (self._pyproject.get("tool") or {}).get("crewai", {}).get(
+            "type"
+        ) == "flow"
+        return True
+
+    def _check_lockfile(self) -> None:
+        uv_lock = self.project_root / "uv.lock"
+        poetry_lock = self.project_root / "poetry.lock"
+        pyproject = self.project_root / "pyproject.toml"
+
+        if not uv_lock.exists() and not poetry_lock.exists():
+            self._add(
+                Severity.ERROR,
+                "missing_lockfile",
+                "Expected to find at least one of these files: uv.lock or poetry.lock",
+                hint=(
+                    "Run `uv lock` (recommended) or `poetry lock` in your project "
+                    "directory, commit the lockfile, then redeploy."
+                ),
+            )
+            return
+
+        lockfile = uv_lock if uv_lock.exists() else poetry_lock
+        try:
+            if lockfile.stat().st_mtime < pyproject.stat().st_mtime:
+                self._add(
+                    Severity.WARNING,
+                    "stale_lockfile",
+                    f"{lockfile.name} is older than pyproject.toml",
+                    detail=(
+                        "Your lockfile may not reflect recent dependency changes. "
+                        "The platform resolves from the lockfile, so deployed "
+                        "dependencies may differ from local."
+                    ),
+                    hint="Run `uv lock` (or `poetry lock`) and commit the result.",
+                )
+        except OSError:
+            pass
+
+    def _check_package_dir(self) -> bool:
+        if self._package_name is None:
+            return False
+
+        src_dir = self.project_root / "src"
+        if not src_dir.is_dir():
+            self._add(
+                Severity.ERROR,
+                "missing_src_dir",
+                "Missing src/ directory",
+                detail=(
+                    "CrewAI deployments expect a src-layout project: "
+                    f"src/{self._package_name}/crew.py (or main.py for flows)."
+                ),
+                hint="Run `crewai create crew <name>` to see the expected layout.",
+            )
+            return False
+
+        package_dir = src_dir / self._package_name
+        if not package_dir.is_dir():
+            siblings = [
+                p.name
+                for p in src_dir.iterdir()
+                if p.is_dir() and not p.name.endswith(".egg-info")
+            ]
+            egg_info = [
+                p.name for p in src_dir.iterdir() if p.name.endswith(".egg-info")
+            ]
+
+            hint_parts = [
+                f'Create src/{self._package_name}/ to match [project].name = "{self._project_name}".'
+            ]
+            if siblings:
+                hint_parts.append(
+                    f"Found other package directories: {', '.join(siblings)}. "
+                    f"Either rename one to '{self._package_name}' or update [project].name."
+                )
+            if egg_info:
+                hint_parts.append(
+                    f"Delete stale build artifacts: {', '.join(egg_info)} "
+                    "(these confuse the platform's package discovery)."
+                )
+
+            self._add(
+                Severity.ERROR,
+                "missing_package_dir",
+                f"Cannot find src/{self._package_name}/",
+                detail=(
+                    "The platform looks for your crew source under "
+                    "src/<package_name>/, derived from [project].name."
+                ),
+                hint=" ".join(hint_parts),
+            )
+            return False
+
+        for p in src_dir.iterdir():
+            if p.name.endswith(".egg-info"):
+                self._add(
+                    Severity.WARNING,
+                    "stale_egg_info",
+                    f"Stale build artifact in src/: {p.name}",
+                    detail=(
+                        ".egg-info directories can be mistaken for your package "
+                        "and cause 'Cannot find src/<name>.egg-info/crew.py' errors."
+                    ),
+                    hint=f"Delete {p} and add `*.egg-info/` to .gitignore.",
+                )
+
+        self._package_dir = package_dir
+        return True
+
+    def _check_crew_entrypoint(self) -> None:
+        if self._package_dir is None:
+            return
+        crew_py = self._package_dir / "crew.py"
+        if not crew_py.is_file():
+            self._add(
+                Severity.ERROR,
+                "missing_crew_py",
+                f"Cannot find {crew_py.relative_to(self.project_root)}",
+                detail=(
+                    "Standard crew projects must define a Crew class decorated "
+                    "with @CrewBase inside crew.py."
+                ),
+                hint=(
+                    "Create crew.py with an @CrewBase-annotated class, or set "
+                    '`[tool.crewai] type = "flow"` in pyproject.toml if this is a flow.'
+                ),
+            )
+
+    def _check_config_yamls(self) -> None:
+        if self._package_dir is None:
+            return
+        config_dir = self._package_dir / "config"
+        if not config_dir.is_dir():
+            self._add(
+                Severity.ERROR,
+                "missing_config_dir",
+                f"Cannot find {config_dir.relative_to(self.project_root)}",
+                hint="Create a config/ directory with agents.yaml and tasks.yaml.",
+            )
+            return
+
+        for yaml_name in ("agents.yaml", "tasks.yaml"):
+            yaml_path = config_dir / yaml_name
+            if not yaml_path.is_file():
+                self._add(
+                    Severity.ERROR,
+                    f"missing_{yaml_name.replace('.', '_')}",
+                    f"Cannot find {yaml_path.relative_to(self.project_root)}",
+                    detail=(
+                        "CrewAI loads agent and task config from these files; "
+                        "missing them causes empty-config warnings and runtime crashes."
+                    ),
+                )
+
+    def _check_flow_entrypoint(self) -> None:
+        if self._package_dir is None:
+            return
+        main_py = self._package_dir / "main.py"
+        if not main_py.is_file():
+            self._add(
+                Severity.ERROR,
+                "missing_flow_main",
+                f"Cannot find {main_py.relative_to(self.project_root)}",
+                detail=(
+                    "Flow projects must define a Flow subclass in main.py. "
+                    'This project has `[tool.crewai] type = "flow"` set.'
+                ),
+                hint="Create main.py with a `class MyFlow(Flow[...])`.",
+            )
+
+    def _check_hatch_wheel_target(self) -> None:
+        if not self._pyproject:
+            return
+
+        build_system = self._pyproject.get("build-system") or {}
+        backend = build_system.get("build-backend", "")
+        if "hatchling" not in backend:
+            return
+
+        hatch_wheel = (
+            (self._pyproject.get("tool") or {})
+            .get("hatch", {})
+            .get("build", {})
+            .get("targets", {})
+            .get("wheel", {})
+        )
+        if hatch_wheel.get("packages") or hatch_wheel.get("only-include"):
+            return
+
+        if self._package_dir and self._package_dir.is_dir():
+            return
+
+        self._add(
+            Severity.ERROR,
+            "hatch_wheel_target_missing",
+            "Hatchling cannot determine which files to ship",
+            detail=(
+                "Your pyproject uses hatchling but has no "
+                "[tool.hatch.build.targets.wheel] configuration and no "
+                "directory matching your project name."
+            ),
+            hint=(
+                "Add:\n"
+                "  [tool.hatch.build.targets.wheel]\n"
+                f'  packages = ["src/{self._package_name}"]'
+            ),
+        )
+
+    def _check_module_imports(self) -> None:
+        """Import the user's crew/flow via `uv run` so the check sees the same
+        package versions as `crewai run` would. Result is reported as JSON on
+        the subprocess's stdout."""
+        script = (
+            "import json, sys, traceback, os\n"
+            "os.chdir(sys.argv[1])\n"
+            "try:\n"
+            "    from crewai.cli.utils import get_crews, get_flows\n"
+            "    is_flow = sys.argv[2] == 'flow'\n"
+            "    if is_flow:\n"
+            "        instances = get_flows()\n"
+            "        kind = 'flow'\n"
+            "    else:\n"
+            "        instances = get_crews()\n"
+            "        kind = 'crew'\n"
+            "    print(json.dumps({'ok': True, 'kind': kind, 'count': len(instances)}))\n"
+            "except BaseException as e:\n"
+            "    print(json.dumps({\n"
+            "        'ok': False,\n"
+            "        'error_type': type(e).__name__,\n"
+            "        'error': str(e),\n"
+            "        'traceback': traceback.format_exc(),\n"
+            "    }))\n"
+        )
+
+        uv_path = shutil.which("uv")
+        if uv_path is None:
+            self._add(
+                Severity.WARNING,
+                "uv_not_found",
+                "Skipping import check: `uv` not installed",
+                hint="Install uv: https://docs.astral.sh/uv/",
+            )
+            return
+
+        try:
+            proc = subprocess.run(  # noqa: S603 - args constructed from trusted inputs
+                [
+                    uv_path,
+                    "run",
+                    "python",
+                    "-c",
+                    script,
+                    str(self.project_root),
+                    "flow" if self._is_flow else "crew",
+                ],
+                cwd=self.project_root,
+                capture_output=True,
+                text=True,
+                timeout=120,
+                check=False,
+            )
+        except subprocess.TimeoutExpired:
+            self._add(
+                Severity.ERROR,
+                "import_timeout",
+                "Importing your crew/flow module timed out after 120s",
+                detail=(
+                    "User code may be making network calls or doing heavy work "
+                    "at import time. Move that work into agent methods."
+                ),
+            )
+            return
+
+        # The payload is the last JSON object on stdout; user code may print
+        # other lines before it.
+        payload: dict[str, Any] | None = None
+        for line in reversed(proc.stdout.splitlines()):
+            line = line.strip()
+            if line.startswith("{") and line.endswith("}"):
+                try:
+                    payload = json.loads(line)
+                    break
+                except json.JSONDecodeError:
+                    continue
+
+        if payload is None:
+            self._add(
+                Severity.ERROR,
+                "import_failed",
+                "Could not import your crew/flow module",
+                detail=(proc.stderr or proc.stdout or "").strip()[:1500],
+                hint="Run `crewai run` locally first to reproduce the error.",
+            )
+            return
+
+        if payload.get("ok"):
+            if payload.get("count", 0) == 0:
+                kind = payload.get("kind", "crew")
+                if kind == "flow":
+                    self._add(
+                        Severity.ERROR,
+                        "no_flow_subclass",
+                        "No Flow subclass found in the module",
+                        hint=(
+                            "main.py must define a class extending "
+                            "`crewai.flow.Flow`, instantiable with no arguments."
+                        ),
+                    )
+                else:
+                    self._add(
+                        Severity.ERROR,
+                        "no_crewbase_class",
+                        "Crew class annotated with @CrewBase not found",
+                        hint=(
+                            "Decorate your crew class with @CrewBase from "
+                            "crewai.project (see `crewai create crew` template)."
+                        ),
+                    )
+            return
+
+        err_msg = str(payload.get("error", ""))
+        err_type = str(payload.get("error_type", "Exception"))
+        tb = str(payload.get("traceback", ""))
+        self._classify_import_error(err_type, err_msg, tb)
+
+    def _classify_import_error(self, err_type: str, err_msg: str, tb: str) -> None:
+        """Turn a raw import-time exception into a user-actionable finding."""
+        # Must be checked before the generic "native provider" branch below:
+        # the extras-missing message contains the same phrase. Providers
+        # format the install command as plain text (`to install: uv add
+        # "crewai[extra]"`); also tolerate backtick-delimited variants.
+        m = re.search(
+            r"(?P<pkg>[A-Za-z0-9_ -]+?)\s+native provider not available"
+            r".*?to install:\s*`?(?P<cmd>uv add [\"']crewai\[[^\]]+\][\"'])`?",
+            err_msg,
+        )
+        if m:
+            self._add(
+                Severity.ERROR,
+                "missing_provider_extra",
+                f"{m.group('pkg').strip()} provider extra not installed",
+                hint=f"Run: {m.group('cmd')}",
+            )
+            return
+
+        # crewai.llm.LLM.__new__ wraps provider init errors as
+        # ImportError("Error importing native provider: ...").
+        if "Error importing native provider" in err_msg or "native provider" in err_msg:
+            missing_key = self._extract_missing_api_key(err_msg)
+            if missing_key:
+                provider = _KNOWN_API_KEY_HINTS.get(missing_key, missing_key)
+                self._add(
+                    Severity.WARNING,
+                    "llm_init_missing_key",
+                    f"LLM is constructed at import time but {missing_key} is not set",
+                    detail=(
+                        f"Your crew instantiates a {provider} LLM during module "
+                        "load (e.g. in a class field default or @crew method). "
+                        f"The {provider} provider currently requires {missing_key} "
+                        "at construction time, so this will fail on the platform "
+                        "unless the key is set in your deployment environment."
+                    ),
+                    hint=(
+                        f"Add {missing_key} to your deployment's Environment "
+                        "Variables before deploying, or move LLM construction "
+                        "inside agent methods so it runs lazily."
+                    ),
+                )
+                return
+            self._add(
+                Severity.ERROR,
+                "llm_provider_init_failed",
+                "LLM native provider failed to initialize",
+                detail=err_msg,
+                hint=(
+                    "Check your LLM(model=...) configuration and provider-specific "
+                    "extras (e.g. `uv add 'crewai[azure-ai-inference]'` for Azure)."
+                ),
+            )
+            return
+
+        if err_type == "KeyError":
+            key = err_msg.strip("'\"")
+            if key in _KNOWN_API_KEY_HINTS or key.endswith("_API_KEY"):
+                self._add(
+                    Severity.WARNING,
+                    "env_var_read_at_import",
+                    f"{key} is read at import time via os.environ[...]",
+                    detail=(
+                        "Using os.environ[...] (rather than os.getenv(...)) "
+                        "at module scope crashes the build if the key isn't set."
+                    ),
+                    hint=(
+                        f"Either add {key} as a deployment env var, or switch "
+                        "to os.getenv() and move the access inside agent methods."
+                    ),
+                )
+                return
+
+        if "Crew class annotated with @CrewBase not found" in err_msg:
+            self._add(
+                Severity.ERROR,
+                "no_crewbase_class",
+                "Crew class annotated with @CrewBase not found",
+                detail=err_msg,
+            )
+            return
+        if "No Flow subclass found" in err_msg:
+            self._add(
+                Severity.ERROR,
+                "no_flow_subclass",
+                "No Flow subclass found in the module",
+                detail=err_msg,
+            )
+            return
+
+        if (
+            err_type == "AttributeError"
+            and "has no attribute '_load_response_format'" in err_msg
+        ):
+            self._add(
+                Severity.ERROR,
+                "stale_crewai_pin",
+                "Your lockfile pins a crewai version missing `_load_response_format`",
+                detail=err_msg,
+                hint=(
+                    "Run `uv lock --upgrade-package crewai` (or `poetry update crewai`) "
+                    "to pin a newer release."
+                ),
+            )
+            return
+
+        if "pydantic" in tb.lower() or "validation error" in err_msg.lower():
+            self._add(
+                Severity.ERROR,
+                "pydantic_validation_error",
+                "Pydantic validation failed while loading your crew",
+                detail=err_msg[:800],
+                hint=(
+                    "Check agent/task configuration fields. `crewai run` locally "
+                    "will show the full traceback."
+                ),
+            )
+            return
+
+        self._add(
+            Severity.ERROR,
+            "import_failed",
+            f"Importing your crew failed: {err_type}",
+            detail=err_msg[:800],
+            hint="Run `crewai run` locally to see the full traceback.",
+        )
+
+    @staticmethod
+    def _extract_missing_api_key(err_msg: str) -> str | None:
+        """Pull 'FOO_API_KEY' out of '... FOO_API_KEY is required ...'."""
+        m = re.search(r"([A-Z][A-Z0-9_]*_API_KEY)\s+is required", err_msg)
+        if m:
+            return m.group(1)
+        m = re.search(r"['\"]([A-Z][A-Z0-9_]*_API_KEY)['\"]", err_msg)
+        if m:
+            return m.group(1)
+        return None
+
+    def _check_env_vars(self) -> None:
+        """Warn about env vars referenced in user code but missing locally.
+        Best-effort only — the platform sets vars server-side, so we never error.
+        """
+        if not self._package_dir:
+            return
+
+        referenced: set[str] = set()
+        pattern = re.compile(
+            r"""(?x)
+            (?:os\.environ\s*(?:\[\s*|\.get\s*\(\s*)
+              |os\.getenv\s*\(\s*
+              |getenv\s*\(\s*)
+            ['"]([A-Z][A-Z0-9_]*)['"]
+            """
+        )
+
+        for path in self._package_dir.rglob("*.py"):
+            try:
+                text = path.read_text(encoding="utf-8", errors="ignore")
+            except OSError:
+                continue
+            referenced.update(pattern.findall(text))
+
+        for path in self._package_dir.rglob("*.yaml"):
+            try:
+                text = path.read_text(encoding="utf-8", errors="ignore")
+            except OSError:
+                continue
+            referenced.update(re.findall(r"\$\{?([A-Z][A-Z0-9_]+)\}?", text))
+
+        env_file = self.project_root / ".env"
+        env_keys: set[str] = set()
+        if env_file.exists():
+            for line in env_file.read_text(errors="ignore").splitlines():
+                line = line.strip()
+                if not line or line.startswith("#") or "=" not in line:
+                    continue
+                env_keys.add(line.split("=", 1)[0].strip())
+
+        missing_known: list[str] = sorted(
+            var
+            for var in referenced
+            if var in _KNOWN_API_KEY_HINTS
+            and var not in env_keys
+            and var not in os.environ
+        )
+        if missing_known:
+            self._add(
+                Severity.WARNING,
+                "env_vars_not_in_dotenv",
+                f"{len(missing_known)} referenced API key(s) not in .env",
+                detail=(
+                    "These env vars are referenced in your source but not set "
+                    f"locally: {', '.join(missing_known)}. Deploys will fail "
+                    "unless they are added to the deployment's Environment "
+                    "Variables in the CrewAI dashboard."
+                ),
+            )
+
+    def _check_version_vs_lockfile(self) -> None:
+        """Warn when the lockfile pins a crewai release older than 1.13.0,
+        which is where ``_load_response_format`` was introduced.
+        """
+        uv_lock = self.project_root / "uv.lock"
+        poetry_lock = self.project_root / "poetry.lock"
+        lockfile = (
+            uv_lock
+            if uv_lock.exists()
+            else poetry_lock
+            if poetry_lock.exists()
+            else None
+        )
+        if lockfile is None:
+            return
+
+        try:
+            text = lockfile.read_text(errors="ignore")
+        except OSError:
+            return
+
+        m = re.search(
+            r'name\s*=\s*"crewai"\s*\nversion\s*=\s*"([^"]+)"',
+            text,
+        )
+        if not m:
+            return
+        locked = m.group(1)
+
+        try:
+            from packaging.version import Version
+
+            if Version(locked) < Version("1.13.0"):
+                self._add(
+                    Severity.WARNING,
+                    "old_crewai_pin",
+                    f"Lockfile pins crewai=={locked} (older than 1.13.0)",
+                    detail=(
+                        "Older pinned versions are missing API surface the "
+                        "platform builder expects (e.g. `_load_response_format`)."
+                    ),
+                    hint="Run `uv lock --upgrade-package crewai` and redeploy.",
+                )
+        except Exception as e:
+            logger.debug("Could not parse crewai pin from lockfile: %s", e)
+
+
+def render_report(results: list[ValidationResult]) -> None:
+    """Pretty-print results to the shared rich console."""
+    if not results:
+        console.print("[bold green]Pre-deploy validation passed.[/bold green]")
+        return
+
+    errors = [r for r in results if r.severity is Severity.ERROR]
+    warnings = [r for r in results if r.severity is Severity.WARNING]
+
+    for result in errors:
+        console.print(f"[bold red]ERROR[/bold red] [{result.code}] {result.title}")
+        if result.detail:
+            console.print(f"  {result.detail}")
+        if result.hint:
+            console.print(f"  [dim]hint:[/dim] {result.hint}")
+
+    for result in warnings:
+        console.print(
+            f"[bold yellow]WARNING[/bold yellow] [{result.code}] {result.title}"
+        )
+        if result.detail:
+            console.print(f"  {result.detail}")
+        if result.hint:
+            console.print(f"  [dim]hint:[/dim] {result.hint}")
+
+    summary_parts: list[str] = []
+    if errors:
+        summary_parts.append(f"[bold red]{len(errors)} error(s)[/bold red]")
+    if warnings:
+        summary_parts.append(f"[bold yellow]{len(warnings)} warning(s)[/bold yellow]")
+    console.print(f"\n{' / '.join(summary_parts)}")
+
+
+def validate_project(project_root: Path | None = None) -> DeployValidator:
+    """Entrypoint: run validation, render results, return the validator.
+
+    The caller inspects ``validator.ok`` to decide whether to proceed with a
+    deploy.
+    """
+    validator = DeployValidator(project_root=project_root)
+    validator.run()
+    render_report(validator.results)
+    return validator
+
+
+def run_validate_command() -> None:
+    """Implementation of `crewai deploy validate`."""
+    validator = validate_project()
+    if not validator.ok:
+        sys.exit(1)
diff --git a/lib/crewai/src/crewai/llms/providers/anthropic/completion.py b/lib/crewai/src/crewai/llms/providers/anthropic/completion.py
index c0e854ce0..b627a8539 100644
--- a/lib/crewai/src/crewai/llms/providers/anthropic/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/anthropic/completion.py
@@ -193,16 +193,41 @@ class AnthropicCompletion(BaseLLM):
 
     @model_validator(mode="after")
     def _init_clients(self) -> AnthropicCompletion:
-        self._client = Anthropic(**self._get_client_params())
+        """Eagerly build clients when the API key is available, otherwise
+        defer so ``LLM(model="anthropic/...")`` can be constructed at module
+        import time even before deployment env vars are set.
+        """
+        try:
+            self._client = self._build_sync_client()
+            self._async_client = self._build_async_client()
+        except ValueError:
+            pass
+        return self
 
-        async_client_params = self._get_client_params()
+    def _build_sync_client(self) -> Any:
+        return Anthropic(**self._get_client_params())
+
+    def _build_async_client(self) -> Any:
+        # Skip the sync httpx.Client that `_get_client_params` would
+        # otherwise construct under `interceptor`; we attach an async one
+        # below and would leak the sync one if both were built.
+        async_client_params = self._get_client_params(include_http_client=False)
         if self.interceptor:
             async_transport = AsyncHTTPTransport(interceptor=self.interceptor)
-            async_http_client = httpx.AsyncClient(transport=async_transport)
-            async_client_params["http_client"] = async_http_client
+            async_client_params["http_client"] = httpx.AsyncClient(
+                transport=async_transport
+            )
+        return AsyncAnthropic(**async_client_params)
 
-        self._async_client = AsyncAnthropic(**async_client_params)
-        return self
+    def _get_sync_client(self) -> Any:
+        if self._client is None:
+            self._client = self._build_sync_client()
+        return self._client
+
+    def _get_async_client(self) -> Any:
+        if self._async_client is None:
+            self._async_client = self._build_async_client()
+        return self._async_client
 
     def to_config_dict(self) -> dict[str, Any]:
         """Extend base config with Anthropic-specific fields."""
@@ -217,8 +242,15 @@ class AnthropicCompletion(BaseLLM):
             config["timeout"] = self.timeout
         return config
 
-    def _get_client_params(self) -> dict[str, Any]:
-        """Get client parameters."""
+    def _get_client_params(self, include_http_client: bool = True) -> dict[str, Any]:
+        """Get client parameters.
+
+        Args:
+            include_http_client: When True (default) and an interceptor is
+                set, attach a sync ``httpx.Client``. The async builder
+                passes ``False`` so it can attach its own async client
+                without leaking a sync one.
+        """
 
         if self.api_key is None:
             self.api_key = os.getenv("ANTHROPIC_API_KEY")
@@ -232,7 +264,7 @@ class AnthropicCompletion(BaseLLM):
             "max_retries": self.max_retries,
         }
 
-        if self.interceptor:
+        if include_http_client and self.interceptor:
             transport = HTTPTransport(interceptor=self.interceptor)
             http_client = httpx.Client(transport=transport)
             client_params["http_client"] = http_client  # type: ignore[assignment]
@@ -798,11 +830,11 @@ class AnthropicCompletion(BaseLLM):
         try:
             if betas:
                 params["betas"] = betas
-                response = self._client.beta.messages.create(
+                response = self._get_sync_client().beta.messages.create(
                     **params, extra_body=extra_body
                 )
             else:
-                response = self._client.messages.create(**params)
+                response = self._get_sync_client().messages.create(**params)
 
         except Exception as e:
             if is_context_length_exceeded(e):
@@ -950,9 +982,11 @@ class AnthropicCompletion(BaseLLM):
         current_tool_calls: dict[int, dict[str, Any]] = {}
 
         stream_context = (
-            self._client.beta.messages.stream(**stream_params, extra_body=extra_body)
+            self._get_sync_client().beta.messages.stream(
+                **stream_params, extra_body=extra_body
+            )
             if betas
-            else self._client.messages.stream(**stream_params)
+            else self._get_sync_client().messages.stream(**stream_params)
         )
         with stream_context as stream:
             response_id = None
@@ -1231,7 +1265,9 @@ class AnthropicCompletion(BaseLLM):
 
         try:
             # Send tool results back to Claude for final response
-            final_response: Message = self._client.messages.create(**follow_up_params)
+            final_response: Message = self._get_sync_client().messages.create(
+                **follow_up_params
+            )
 
             # Track token usage for follow-up call
             follow_up_usage = self._extract_anthropic_token_usage(final_response)
@@ -1327,11 +1363,11 @@ class AnthropicCompletion(BaseLLM):
         try:
             if betas:
                 params["betas"] = betas
-                response = await self._async_client.beta.messages.create(
+                response = await self._get_async_client().beta.messages.create(
                     **params, extra_body=extra_body
                 )
             else:
-                response = await self._async_client.messages.create(**params)
+                response = await self._get_async_client().messages.create(**params)
 
         except Exception as e:
             if is_context_length_exceeded(e):
@@ -1465,11 +1501,11 @@ class AnthropicCompletion(BaseLLM):
         current_tool_calls: dict[int, dict[str, Any]] = {}
 
         stream_context = (
-            self._async_client.beta.messages.stream(
+            self._get_async_client().beta.messages.stream(
                 **stream_params, extra_body=extra_body
             )
             if betas
-            else self._async_client.messages.stream(**stream_params)
+            else self._get_async_client().messages.stream(**stream_params)
         )
         async with stream_context as stream:
             response_id = None
@@ -1634,7 +1670,7 @@ class AnthropicCompletion(BaseLLM):
         ]
 
         try:
-            final_response: Message = await self._async_client.messages.create(
+            final_response: Message = await self._get_async_client().messages.create(
                 **follow_up_params
             )
 
@@ -1762,8 +1798,8 @@ class AnthropicCompletion(BaseLLM):
             from crewai_files.uploaders.anthropic import AnthropicFileUploader
 
             return AnthropicFileUploader(
-                client=self._client,
-                async_client=self._async_client,
+                client=self._get_sync_client(),
+                async_client=self._get_async_client(),
             )
         except ImportError:
             return None
diff --git a/lib/crewai/src/crewai/llms/providers/azure/completion.py b/lib/crewai/src/crewai/llms/providers/azure/completion.py
index cac811bc7..4b8d842a5 100644
--- a/lib/crewai/src/crewai/llms/providers/azure/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/azure/completion.py
@@ -116,43 +116,100 @@ class AzureCompletion(BaseLLM):
             data.get("api_version") or os.getenv("AZURE_API_VERSION") or "2024-06-01"
         )
 
-        if not data["api_key"]:
-            raise ValueError(
-                "Azure API key is required. Set AZURE_API_KEY environment variable or pass api_key parameter."
-            )
-        if not data["endpoint"]:
-            raise ValueError(
-                "Azure endpoint is required. Set AZURE_ENDPOINT environment variable or pass endpoint parameter."
-            )
-
+        # Credentials and endpoint are validated lazily in `_init_clients`
+        # so the LLM can be constructed before deployment env vars are set.
         model = data.get("model", "")
-        data["endpoint"] = AzureCompletion._validate_and_fix_endpoint(
-            data["endpoint"], model
+        if data["endpoint"]:
+            data["endpoint"] = AzureCompletion._validate_and_fix_endpoint(
+                data["endpoint"], model
+            )
+        data["is_azure_openai_endpoint"] = AzureCompletion._is_azure_openai_endpoint(
+            data["endpoint"]
         )
         data["is_openai_model"] = any(
             prefix in model.lower() for prefix in ["gpt-", "o1-", "text-"]
         )
-        parsed = urlparse(data["endpoint"])
-        hostname = parsed.hostname or ""
-        data["is_azure_openai_endpoint"] = (
-            hostname == "openai.azure.com" or hostname.endswith(".openai.azure.com")
-        ) and "/openai/deployments/" in data["endpoint"]
         return data
 
+    @staticmethod
+    def _is_azure_openai_endpoint(endpoint: str | None) -> bool:
+        if not endpoint:
+            return False
+        hostname = urlparse(endpoint).hostname or ""
+        return (
+            hostname == "openai.azure.com" or hostname.endswith(".openai.azure.com")
+        ) and "/openai/deployments/" in endpoint
+
     @model_validator(mode="after")
     def _init_clients(self) -> AzureCompletion:
+        """Eagerly build clients when credentials are available, otherwise
+        defer so ``LLM(model="azure/...")`` can be constructed at module
+        import time even before deployment env vars are set.
+        """
+        try:
+            self._client = self._build_sync_client()
+            self._async_client = self._build_async_client()
+        except ValueError:
+            pass
+        return self
+
+    def _build_sync_client(self) -> Any:
+        return ChatCompletionsClient(**self._make_client_kwargs())
+
+    def _build_async_client(self) -> Any:
+        return AsyncChatCompletionsClient(**self._make_client_kwargs())
+
+    def _make_client_kwargs(self) -> dict[str, Any]:
+        # Re-read env vars so that a deferred build can pick up credentials
+        # that weren't set at instantiation time (e.g. LLM constructed at
+        # module import before deployment env vars were injected).
         if not self.api_key:
-            raise ValueError("Azure API key is required.")
+            self.api_key = os.getenv("AZURE_API_KEY")
+        if not self.endpoint:
+            endpoint = (
+                os.getenv("AZURE_ENDPOINT")
+                or os.getenv("AZURE_OPENAI_ENDPOINT")
+                or os.getenv("AZURE_API_BASE")
+            )
+            if endpoint:
+                self.endpoint = AzureCompletion._validate_and_fix_endpoint(
+                    endpoint, self.model
+                )
+                # Recompute the routing flag now that the endpoint is known —
+                # _prepare_completion_params uses it to decide whether to
+                # include `model` in the request body (Azure OpenAI endpoints
+                # embed the deployment name in the URL and reject it).
+                self.is_azure_openai_endpoint = (
+                    AzureCompletion._is_azure_openai_endpoint(self.endpoint)
+                )
+
+        if not self.api_key:
+            raise ValueError(
+                "Azure API key is required. Set AZURE_API_KEY environment "
+                "variable or pass api_key parameter."
+            )
+        if not self.endpoint:
+            raise ValueError(
+                "Azure endpoint is required. Set AZURE_ENDPOINT environment "
+                "variable or pass endpoint parameter."
+            )
         client_kwargs: dict[str, Any] = {
             "endpoint": self.endpoint,
             "credential": AzureKeyCredential(self.api_key),
         }
         if self.api_version:
             client_kwargs["api_version"] = self.api_version
+        return client_kwargs
 
-        self._client = ChatCompletionsClient(**client_kwargs)
-        self._async_client = AsyncChatCompletionsClient(**client_kwargs)
-        return self
+    def _get_sync_client(self) -> Any:
+        if self._client is None:
+            self._client = self._build_sync_client()
+        return self._client
+
+    def _get_async_client(self) -> Any:
+        if self._async_client is None:
+            self._async_client = self._build_async_client()
+        return self._async_client
 
     def to_config_dict(self) -> dict[str, Any]:
         """Extend base config with Azure-specific fields."""
@@ -713,8 +770,7 @@ class AzureCompletion(BaseLLM):
     ) -> str | Any:
         """Handle non-streaming chat completion."""
         try:
-            # Cast params to Any to avoid type checking issues with TypedDict unpacking
-            response: ChatCompletions = self._client.complete(**params)
+            response: ChatCompletions = self._get_sync_client().complete(**params)
             return self._process_completion_response(
                 response=response,
                 params=params,
@@ -913,7 +969,7 @@ class AzureCompletion(BaseLLM):
         tool_calls: dict[int, dict[str, Any]] = {}
 
         usage_data: dict[str, Any] | None = None
-        for update in self._client.complete(**params):
+        for update in self._get_sync_client().complete(**params):
             if isinstance(update, StreamingChatCompletionsUpdate):
                 if update.usage:
                     usage = update.usage
@@ -953,8 +1009,9 @@ class AzureCompletion(BaseLLM):
     ) -> str | Any:
         """Handle non-streaming chat completion asynchronously."""
         try:
-            # Cast params to Any to avoid type checking issues with TypedDict unpacking
-            response: ChatCompletions = await self._async_client.complete(**params)
+            response: ChatCompletions = await self._get_async_client().complete(
+                **params
+            )
             return self._process_completion_response(
                 response=response,
                 params=params,
@@ -980,7 +1037,7 @@ class AzureCompletion(BaseLLM):
 
         usage_data: dict[str, Any] | None = None
 
-        stream = await self._async_client.complete(**params)
+        stream = await self._get_async_client().complete(**params)
         async for update in stream:
             if isinstance(update, StreamingChatCompletionsUpdate):
                 if hasattr(update, "usage") and update.usage:
@@ -1103,9 +1160,12 @@ class AzureCompletion(BaseLLM):
         """Close the async client and clean up resources.
 
         This ensures proper cleanup of the underlying aiohttp session
-        to avoid unclosed connector warnings.
+        to avoid unclosed connector warnings. Accesses the cached client
+        directly rather than going through `_get_async_client` so a
+        cleanup on an uninitialized LLM is a harmless no-op rather than
+        a credential-required error.
         """
-        if hasattr(self._async_client, "close"):
+        if self._async_client is not None and hasattr(self._async_client, "close"):
             await self._async_client.close()
 
     async def __aenter__(self) -> Self:
diff --git a/lib/crewai/src/crewai/llms/providers/bedrock/completion.py b/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
index 75fe712b5..5932b66f0 100644
--- a/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
@@ -307,6 +307,22 @@ class BedrockCompletion(BaseLLM):
 
     @model_validator(mode="after")
     def _init_clients(self) -> BedrockCompletion:
+        """Eagerly build the sync client when AWS credentials resolve,
+        otherwise defer so ``LLM(model="bedrock/...")`` can be constructed
+        at module import time even before deployment env vars are set.
+
+        Only credential/SDK errors are caught — programming errors like
+        ``TypeError`` or ``AttributeError`` propagate so real bugs aren't
+        silently swallowed.
+        """
+        try:
+            self._client = self._build_sync_client()
+        except (BotoCoreError, ClientError, ValueError) as e:
+            logging.debug("Deferring Bedrock client construction: %s", e)
+        self._async_exit_stack = AsyncExitStack() if AIOBOTOCORE_AVAILABLE else None
+        return self
+
+    def _build_sync_client(self) -> Any:
         config = Config(
             read_timeout=300,
             retries={"max_attempts": 3, "mode": "adaptive"},
@@ -318,9 +334,17 @@ class BedrockCompletion(BaseLLM):
             aws_session_token=self.aws_session_token,
             region_name=self.region_name,
         )
-        self._client = session.client("bedrock-runtime", config=config)
-        self._async_exit_stack = AsyncExitStack() if AIOBOTOCORE_AVAILABLE else None
-        return self
+        return session.client("bedrock-runtime", config=config)
+
+    def _get_sync_client(self) -> Any:
+        if self._client is None:
+            self._client = self._build_sync_client()
+        return self._client
+
+    def _get_async_client(self) -> Any:
+        """Async client is set up separately by ``_ensure_async_client``
+        using ``aiobotocore`` inside an exit stack."""
+        return self._async_client
 
     def to_config_dict(self) -> dict[str, Any]:
         """Extend base config with Bedrock-specific fields."""
@@ -660,7 +684,7 @@ class BedrockCompletion(BaseLLM):
                     raise ValueError(f"Invalid message format at index {i}")
 
             # Call Bedrock Converse API with proper error handling
-            response = self._client.converse(
+            response = self._get_sync_client().converse(
                 modelId=self.model_id,
                 messages=cast(
                     "Sequence[MessageTypeDef | MessageOutputTypeDef]",
@@ -949,7 +973,7 @@ class BedrockCompletion(BaseLLM):
         usage_data: dict[str, Any] | None = None
 
         try:
-            response = self._client.converse_stream(
+            response = self._get_sync_client().converse_stream(
                 modelId=self.model_id,
                 messages=cast(
                     "Sequence[MessageTypeDef | MessageOutputTypeDef]",
diff --git a/lib/crewai/src/crewai/llms/providers/gemini/completion.py b/lib/crewai/src/crewai/llms/providers/gemini/completion.py
index 3959bc659..1b2fb26cb 100644
--- a/lib/crewai/src/crewai/llms/providers/gemini/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/gemini/completion.py
@@ -118,9 +118,33 @@ class GeminiCompletion(BaseLLM):
 
     @model_validator(mode="after")
     def _init_client(self) -> GeminiCompletion:
-        self._client = self._initialize_client(self.use_vertexai)
+        """Eagerly build the client when credentials resolve, otherwise defer
+        so ``LLM(model="gemini/...")`` can be constructed at module import time
+        even before deployment env vars are set.
+        """
+        try:
+            self._client = self._initialize_client(self.use_vertexai)
+        except ValueError:
+            pass
         return self
 
+    def _get_sync_client(self) -> Any:
+        if self._client is None:
+            # Re-read env vars so a deferred build can pick up credentials
+            # that weren't set at instantiation time.
+            if not self.api_key:
+                self.api_key = os.getenv("GOOGLE_API_KEY") or os.getenv(
+                    "GEMINI_API_KEY"
+                )
+            if not self.project:
+                self.project = os.getenv("GOOGLE_CLOUD_PROJECT")
+            self._client = self._initialize_client(self.use_vertexai)
+        return self._client
+
+    def _get_async_client(self) -> Any:
+        """Gemini uses a single client for both sync and async calls."""
+        return self._get_sync_client()
+
     def to_config_dict(self) -> dict[str, Any]:
         """Extend base config with Gemini/Vertex-specific fields."""
         config = super().to_config_dict()
@@ -228,6 +252,7 @@ class GeminiCompletion(BaseLLM):
 
         if (
             hasattr(self, "client")
+            and self._client is not None
             and hasattr(self._client, "vertexai")
             and self._client.vertexai
         ):
@@ -1112,7 +1137,7 @@ class GeminiCompletion(BaseLLM):
         try:
             # The API accepts list[Content] but mypy is overly strict about variance
             contents_for_api: Any = contents
-            response = self._client.models.generate_content(
+            response = self._get_sync_client().models.generate_content(
                 model=self.model,
                 contents=contents_for_api,
                 config=config,
@@ -1153,7 +1178,7 @@ class GeminiCompletion(BaseLLM):
 
         # The API accepts list[Content] but mypy is overly strict about variance
         contents_for_api: Any = contents
-        for chunk in self._client.models.generate_content_stream(
+        for chunk in self._get_sync_client().models.generate_content_stream(
             model=self.model,
             contents=contents_for_api,
             config=config,
@@ -1191,7 +1216,7 @@ class GeminiCompletion(BaseLLM):
         try:
             # The API accepts list[Content] but mypy is overly strict about variance
             contents_for_api: Any = contents
-            response = await self._client.aio.models.generate_content(
+            response = await self._get_async_client().aio.models.generate_content(
                 model=self.model,
                 contents=contents_for_api,
                 config=config,
@@ -1232,7 +1257,7 @@ class GeminiCompletion(BaseLLM):
 
         # The API accepts list[Content] but mypy is overly strict about variance
         contents_for_api: Any = contents
-        stream = await self._client.aio.models.generate_content_stream(
+        stream = await self._get_async_client().aio.models.generate_content_stream(
             model=self.model,
             contents=contents_for_api,
             config=config,
@@ -1439,6 +1464,6 @@ class GeminiCompletion(BaseLLM):
         try:
             from crewai_files.uploaders.gemini import GeminiFileUploader
 
-            return GeminiFileUploader(client=self._client)
+            return GeminiFileUploader(client=self._get_sync_client())
         except ImportError:
             return None
diff --git a/lib/crewai/src/crewai/llms/providers/openai/completion.py b/lib/crewai/src/crewai/llms/providers/openai/completion.py
index e9509e7d2..ce3567fb8 100644
--- a/lib/crewai/src/crewai/llms/providers/openai/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/openai/completion.py
@@ -257,22 +257,40 @@ class OpenAICompletion(BaseLLM):
 
     @model_validator(mode="after")
     def _init_clients(self) -> OpenAICompletion:
+        """Eagerly build clients when the API key is available, otherwise
+        defer so ``LLM(model="openai/...")`` can be constructed at module
+        import time even before deployment env vars are set.
+        """
+        try:
+            self._client = self._build_sync_client()
+            self._async_client = self._build_async_client()
+        except ValueError:
+            pass
+        return self
+
+    def _build_sync_client(self) -> Any:
         client_config = self._get_client_params()
         if self.interceptor:
             transport = HTTPTransport(interceptor=self.interceptor)
-            http_client = httpx.Client(transport=transport)
-            client_config["http_client"] = http_client
+            client_config["http_client"] = httpx.Client(transport=transport)
+        return OpenAI(**client_config)
 
-        self._client = OpenAI(**client_config)
-
-        async_client_config = self._get_client_params()
+    def _build_async_client(self) -> Any:
+        client_config = self._get_client_params()
         if self.interceptor:
-            async_transport = AsyncHTTPTransport(interceptor=self.interceptor)
-            async_http_client = httpx.AsyncClient(transport=async_transport)
-            async_client_config["http_client"] = async_http_client
+            transport = AsyncHTTPTransport(interceptor=self.interceptor)
+            client_config["http_client"] = httpx.AsyncClient(transport=transport)
+        return AsyncOpenAI(**client_config)
 
-        self._async_client = AsyncOpenAI(**async_client_config)
-        return self
+    def _get_sync_client(self) -> Any:
+        if self._client is None:
+            self._client = self._build_sync_client()
+        return self._client
+
+    def _get_async_client(self) -> Any:
+        if self._async_client is None:
+            self._async_client = self._build_async_client()
+        return self._async_client
 
     @property
     def last_response_id(self) -> str | None:
@@ -799,7 +817,7 @@ class OpenAICompletion(BaseLLM):
     ) -> str | ResponsesAPIResult | Any:
         """Handle non-streaming Responses API call."""
         try:
-            response: Response = self._client.responses.create(**params)
+            response: Response = self._get_sync_client().responses.create(**params)
 
             # Track response ID for auto-chaining
             if self.auto_chain and response.id:
@@ -935,7 +953,9 @@ class OpenAICompletion(BaseLLM):
     ) -> str | ResponsesAPIResult | Any:
         """Handle async non-streaming Responses API call."""
         try:
-            response: Response = await self._async_client.responses.create(**params)
+            response: Response = await self._get_async_client().responses.create(
+                **params
+            )
 
             # Track response ID for auto-chaining
             if self.auto_chain and response.id:
@@ -1071,7 +1091,7 @@ class OpenAICompletion(BaseLLM):
         final_response: Response | None = None
         usage: dict[str, Any] | None = None
 
-        stream = self._client.responses.create(**params)
+        stream = self._get_sync_client().responses.create(**params)
         response_id_stream = None
 
         for event in stream:
@@ -1199,7 +1219,7 @@ class OpenAICompletion(BaseLLM):
         final_response: Response | None = None
         usage: dict[str, Any] | None = None
 
-        stream = await self._async_client.responses.create(**params)
+        stream = await self._get_async_client().responses.create(**params)
         response_id_stream = None
 
         async for event in stream:
@@ -1589,7 +1609,7 @@ class OpenAICompletion(BaseLLM):
                 parse_params = {
                     k: v for k, v in params.items() if k != "response_format"
                 }
-                parsed_response = self._client.beta.chat.completions.parse(
+                parsed_response = self._get_sync_client().beta.chat.completions.parse(
                     **parse_params,
                     response_format=response_model,
                 )
@@ -1613,7 +1633,9 @@ class OpenAICompletion(BaseLLM):
                     )
                     return parsed_object
 
-            response: ChatCompletion = self._client.chat.completions.create(**params)
+            response: ChatCompletion = self._get_sync_client().chat.completions.create(
+                **params
+            )
 
             usage = self._extract_openai_token_usage(response)
 
@@ -1840,7 +1862,7 @@ class OpenAICompletion(BaseLLM):
             }
 
             stream: ChatCompletionStream[BaseModel]
-            with self._client.beta.chat.completions.stream(
+            with self._get_sync_client().beta.chat.completions.stream(
                 **parse_params, response_format=response_model
             ) as stream:
                 for chunk in stream:
@@ -1877,7 +1899,7 @@ class OpenAICompletion(BaseLLM):
             return ""
 
         completion_stream: Stream[ChatCompletionChunk] = (
-            self._client.chat.completions.create(**params)
+            self._get_sync_client().chat.completions.create(**params)
         )
 
         usage_data: dict[str, Any] | None = None
@@ -1974,9 +1996,11 @@ class OpenAICompletion(BaseLLM):
                 parse_params = {
                     k: v for k, v in params.items() if k != "response_format"
                 }
-                parsed_response = await self._async_client.beta.chat.completions.parse(
-                    **parse_params,
-                    response_format=response_model,
+                parsed_response = (
+                    await self._get_async_client().beta.chat.completions.parse(
+                        **parse_params,
+                        response_format=response_model,
+                    )
                 )
                 math_reasoning = parsed_response.choices[0].message
 
@@ -1998,8 +2022,8 @@ class OpenAICompletion(BaseLLM):
                     )
                     return parsed_object
 
-            response: ChatCompletion = await self._async_client.chat.completions.create(
-                **params
+            response: ChatCompletion = (
+                await self._get_async_client().chat.completions.create(**params)
             )
 
             usage = self._extract_openai_token_usage(response)
@@ -2125,7 +2149,7 @@ class OpenAICompletion(BaseLLM):
         if response_model:
             completion_stream: AsyncIterator[
                 ChatCompletionChunk
-            ] = await self._async_client.chat.completions.create(**params)
+            ] = await self._get_async_client().chat.completions.create(**params)
 
             accumulated_content = ""
             usage_data: dict[str, Any] | None = None
@@ -2181,7 +2205,7 @@ class OpenAICompletion(BaseLLM):
 
         stream: AsyncIterator[
             ChatCompletionChunk
-        ] = await self._async_client.chat.completions.create(**params)
+        ] = await self._get_async_client().chat.completions.create(**params)
 
         usage_data = None
 
@@ -2377,8 +2401,8 @@ class OpenAICompletion(BaseLLM):
             from crewai_files.uploaders.openai import OpenAIFileUploader
 
             return OpenAIFileUploader(
-                client=self._client,
-                async_client=self._async_client,
+                client=self._get_sync_client(),
+                async_client=self._get_async_client(),
             )
         except ImportError:
             return None
diff --git a/lib/crewai/tests/cli/deploy/test_deploy_main.py b/lib/crewai/tests/cli/deploy/test_deploy_main.py
index 4b818cc58..9b6e49e1a 100644
--- a/lib/crewai/tests/cli/deploy/test_deploy_main.py
+++ b/lib/crewai/tests/cli/deploy/test_deploy_main.py
@@ -125,7 +125,7 @@ class TestDeployCommand(unittest.TestCase):
         mock_response.json.return_value = {"uuid": "test-uuid"}
         self.mock_client.deploy_by_uuid.return_value = mock_response
 
-        self.deploy_command.deploy(uuid="test-uuid")
+        self.deploy_command.deploy(uuid="test-uuid", skip_validate=True)
 
         self.mock_client.deploy_by_uuid.assert_called_once_with("test-uuid")
         mock_display.assert_called_once_with({"uuid": "test-uuid"})
@@ -137,7 +137,7 @@ class TestDeployCommand(unittest.TestCase):
         mock_response.json.return_value = {"uuid": "test-uuid"}
         self.mock_client.deploy_by_name.return_value = mock_response
 
-        self.deploy_command.deploy()
+        self.deploy_command.deploy(skip_validate=True)
 
         self.mock_client.deploy_by_name.assert_called_once_with("test_project")
         mock_display.assert_called_once_with({"uuid": "test-uuid"})
@@ -156,7 +156,7 @@ class TestDeployCommand(unittest.TestCase):
         self.mock_client.create_crew.return_value = mock_response
 
         with patch("sys.stdout", new=StringIO()) as fake_out:
-            self.deploy_command.create_crew()
+            self.deploy_command.create_crew(skip_validate=True)
             self.assertIn("Deployment created successfully!", fake_out.getvalue())
             self.assertIn("new-uuid", fake_out.getvalue())
 
diff --git a/lib/crewai/tests/cli/deploy/test_validate.py b/lib/crewai/tests/cli/deploy/test_validate.py
new file mode 100644
index 000000000..ff8b26376
--- /dev/null
+++ b/lib/crewai/tests/cli/deploy/test_validate.py
@@ -0,0 +1,430 @@
+"""Tests for `crewai.cli.deploy.validate`.
+
+The fixtures here correspond 1:1 to the deployment-failure patterns observed
+in the #crewai-deployment-failures Slack channel that motivated this work.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from textwrap import dedent
+from typing import Iterable
+from unittest.mock import patch
+
+import pytest
+
+from crewai.cli.deploy.validate import (
+    DeployValidator,
+    Severity,
+    normalize_package_name,
+)
+
+
+def _make_pyproject(
+    name: str = "my_crew",
+    dependencies: Iterable[str] = ("crewai>=1.14.0",),
+    *,
+    hatchling: bool = False,
+    flow: bool = False,
+    extra: str = "",
+) -> str:
+    deps = ", ".join(f'"{d}"' for d in dependencies)
+    lines = [
+        "[project]",
+        f'name = "{name}"',
+        'version = "0.1.0"',
+        f"dependencies = [{deps}]",
+    ]
+    if hatchling:
+        lines += [
+            "",
+            "[build-system]",
+            'requires = ["hatchling"]',
+            'build-backend = "hatchling.build"',
+        ]
+    if flow:
+        lines += ["", "[tool.crewai]", 'type = "flow"']
+    if extra:
+        lines += ["", extra]
+    return "\n".join(lines) + "\n"
+
+
+def _scaffold_standard_crew(
+    root: Path,
+    *,
+    name: str = "my_crew",
+    include_crew_py: bool = True,
+    include_agents_yaml: bool = True,
+    include_tasks_yaml: bool = True,
+    include_lockfile: bool = True,
+    pyproject: str | None = None,
+) -> Path:
+    (root / "pyproject.toml").write_text(pyproject or _make_pyproject(name=name))
+    if include_lockfile:
+        (root / "uv.lock").write_text("# dummy uv lockfile\n")
+
+    pkg_dir = root / "src" / normalize_package_name(name)
+    pkg_dir.mkdir(parents=True)
+    (pkg_dir / "__init__.py").write_text("")
+
+    if include_crew_py:
+        (pkg_dir / "crew.py").write_text(
+            dedent(
+                """
+                from crewai.project import CrewBase, crew
+
+                @CrewBase
+                class MyCrew:
+                    agents_config = "config/agents.yaml"
+                    tasks_config = "config/tasks.yaml"
+
+                    @crew
+                    def crew(self):
+                        from crewai import Crew
+                        return Crew(agents=[], tasks=[])
+                """
+            ).strip()
+            + "\n"
+        )
+
+    config_dir = pkg_dir / "config"
+    config_dir.mkdir()
+    if include_agents_yaml:
+        (config_dir / "agents.yaml").write_text("{}\n")
+    if include_tasks_yaml:
+        (config_dir / "tasks.yaml").write_text("{}\n")
+
+    return pkg_dir
+
+
+def _codes(validator: DeployValidator) -> set[str]:
+    return {r.code for r in validator.results}
+
+
+def _run_without_import_check(root: Path) -> DeployValidator:
+    """Run validation with the subprocess-based import check stubbed out;
+    the classifier is exercised directly in its own tests below."""
+    with patch.object(DeployValidator, "_check_module_imports", lambda self: None):
+        v = DeployValidator(project_root=root)
+        v.run()
+    return v
+
+
+@pytest.mark.parametrize(
+    "project_name, expected",
+    [
+        ("my-crew", "my_crew"),
+        ("My Cool-Project", "my_cool_project"),
+        ("crew123", "crew123"),
+        ("crew.name!with$chars", "crewnamewithchars"),
+    ],
+)
+def test_normalize_package_name(project_name: str, expected: str) -> None:
+    assert normalize_package_name(project_name) == expected
+
+
+def test_valid_standard_crew_project_passes(tmp_path: Path) -> None:
+    _scaffold_standard_crew(tmp_path)
+    v = _run_without_import_check(tmp_path)
+    assert v.ok, f"expected clean run, got {v.results}"
+
+
+def test_missing_pyproject_errors(tmp_path: Path) -> None:
+    v = _run_without_import_check(tmp_path)
+    assert "missing_pyproject" in _codes(v)
+    assert not v.ok
+
+
+def test_invalid_pyproject_errors(tmp_path: Path) -> None:
+    (tmp_path / "pyproject.toml").write_text("this is not valid toml ====\n")
+    v = _run_without_import_check(tmp_path)
+    assert "invalid_pyproject" in _codes(v)
+
+
+def test_missing_project_name_errors(tmp_path: Path) -> None:
+    (tmp_path / "pyproject.toml").write_text(
+        '[project]\nversion = "0.1.0"\ndependencies = ["crewai>=1.14.0"]\n'
+    )
+    v = _run_without_import_check(tmp_path)
+    assert "missing_project_name" in _codes(v)
+
+
+def test_missing_lockfile_errors(tmp_path: Path) -> None:
+    _scaffold_standard_crew(tmp_path, include_lockfile=False)
+    v = _run_without_import_check(tmp_path)
+    assert "missing_lockfile" in _codes(v)
+
+
+def test_poetry_lock_is_accepted(tmp_path: Path) -> None:
+    _scaffold_standard_crew(tmp_path, include_lockfile=False)
+    (tmp_path / "poetry.lock").write_text("# poetry lockfile\n")
+    v = _run_without_import_check(tmp_path)
+    assert "missing_lockfile" not in _codes(v)
+
+
+def test_stale_lockfile_warns(tmp_path: Path) -> None:
+    _scaffold_standard_crew(tmp_path)
+    # Make lockfile older than pyproject.
+    lock = tmp_path / "uv.lock"
+    pyproject = tmp_path / "pyproject.toml"
+    old_time = pyproject.stat().st_mtime - 60
+    import os
+
+    os.utime(lock, (old_time, old_time))
+    v = _run_without_import_check(tmp_path)
+    assert "stale_lockfile" in _codes(v)
+    # Stale is a warning, so the run can still be ok (no errors).
+    assert v.ok
+
+
+def test_missing_package_dir_errors(tmp_path: Path) -> None:
+    # pyproject says name=my_crew but we only create src/other_pkg/
+    (tmp_path / "pyproject.toml").write_text(_make_pyproject(name="my_crew"))
+    (tmp_path / "uv.lock").write_text("")
+    (tmp_path / "src" / "other_pkg").mkdir(parents=True)
+    v = _run_without_import_check(tmp_path)
+    codes = _codes(v)
+    assert "missing_package_dir" in codes
+    finding = next(r for r in v.results if r.code == "missing_package_dir")
+    assert "other_pkg" in finding.hint
+
+
+def test_egg_info_only_errors_with_targeted_hint(tmp_path: Path) -> None:
+    """Regression for the case where only src/<name>.egg-info/ exists."""
+    (tmp_path / "pyproject.toml").write_text(_make_pyproject(name="odoo_pm_agents"))
+    (tmp_path / "uv.lock").write_text("")
+    (tmp_path / "src" / "odoo_pm_agents.egg-info").mkdir(parents=True)
+    v = _run_without_import_check(tmp_path)
+    finding = next(r for r in v.results if r.code == "missing_package_dir")
+    assert "egg-info" in finding.hint
+
+
+def test_stale_egg_info_sibling_warns(tmp_path: Path) -> None:
+    _scaffold_standard_crew(tmp_path)
+    (tmp_path / "src" / "my_crew.egg-info").mkdir()
+    v = _run_without_import_check(tmp_path)
+    assert "stale_egg_info" in _codes(v)
+
+
+def test_missing_crew_py_errors(tmp_path: Path) -> None:
+    _scaffold_standard_crew(tmp_path, include_crew_py=False)
+    v = _run_without_import_check(tmp_path)
+    assert "missing_crew_py" in _codes(v)
+
+
+def test_missing_agents_yaml_errors(tmp_path: Path) -> None:
+    _scaffold_standard_crew(tmp_path, include_agents_yaml=False)
+    v = _run_without_import_check(tmp_path)
+    assert "missing_agents_yaml" in _codes(v)
+
+
+def test_missing_tasks_yaml_errors(tmp_path: Path) -> None:
+    _scaffold_standard_crew(tmp_path, include_tasks_yaml=False)
+    v = _run_without_import_check(tmp_path)
+    assert "missing_tasks_yaml" in _codes(v)
+
+
+def test_flow_project_requires_main_py(tmp_path: Path) -> None:
+    (tmp_path / "pyproject.toml").write_text(
+        _make_pyproject(name="my_flow", flow=True)
+    )
+    (tmp_path / "uv.lock").write_text("")
+    (tmp_path / "src" / "my_flow").mkdir(parents=True)
+    v = _run_without_import_check(tmp_path)
+    assert "missing_flow_main" in _codes(v)
+
+
+def test_flow_project_with_main_py_passes(tmp_path: Path) -> None:
+    (tmp_path / "pyproject.toml").write_text(
+        _make_pyproject(name="my_flow", flow=True)
+    )
+    (tmp_path / "uv.lock").write_text("")
+    pkg = tmp_path / "src" / "my_flow"
+    pkg.mkdir(parents=True)
+    (pkg / "main.py").write_text("# flow entrypoint\n")
+    v = _run_without_import_check(tmp_path)
+    assert "missing_flow_main" not in _codes(v)
+
+
+def test_hatchling_without_wheel_config_passes_when_pkg_dir_matches(
+    tmp_path: Path,
+) -> None:
+    _scaffold_standard_crew(
+        tmp_path, pyproject=_make_pyproject(name="my_crew", hatchling=True)
+    )
+    v = _run_without_import_check(tmp_path)
+    # src/my_crew/ exists, so hatch default should find it — no wheel error.
+    assert "hatch_wheel_target_missing" not in _codes(v)
+
+
+def test_hatchling_with_explicit_wheel_config_passes(tmp_path: Path) -> None:
+    extra = (
+        "[tool.hatch.build.targets.wheel]\n"
+        'packages = ["src/my_crew"]'
+    )
+    _scaffold_standard_crew(
+        tmp_path,
+        pyproject=_make_pyproject(name="my_crew", hatchling=True, extra=extra),
+    )
+    v = _run_without_import_check(tmp_path)
+    assert "hatch_wheel_target_missing" not in _codes(v)
+
+
+def test_classify_missing_openai_key_is_warning(tmp_path: Path) -> None:
+    v = DeployValidator(project_root=tmp_path)
+    v._classify_import_error(
+        "ImportError",
+        "Error importing native provider: 1 validation error for OpenAICompletion\n"
+        "  Value error, OPENAI_API_KEY is required",
+        tb="",
+    )
+    assert len(v.results) == 1
+    result = v.results[0]
+    assert result.code == "llm_init_missing_key"
+    assert result.severity is Severity.WARNING
+    assert "OPENAI_API_KEY" in result.title
+
+
+def test_classify_azure_extra_missing_is_error(tmp_path: Path) -> None:
+    """The real message raised by the Azure provider module uses plain
+    double quotes around the install command (no backticks). Match the
+    exact string that ships in the provider source so this test actually
+    guards the regex used in production."""
+    v = DeployValidator(project_root=tmp_path)
+    v._classify_import_error(
+        "ImportError",
+        'Azure AI Inference native provider not available, to install: uv add "crewai[azure-ai-inference]"',
+        tb="",
+    )
+    assert "missing_provider_extra" in _codes(v)
+    finding = next(r for r in v.results if r.code == "missing_provider_extra")
+    assert finding.title.startswith("Azure AI Inference")
+    assert 'uv add "crewai[azure-ai-inference]"' in finding.hint
+
+
+@pytest.mark.parametrize(
+    "pkg_label, install_cmd",
+    [
+        ("Anthropic", 'uv add "crewai[anthropic]"'),
+        ("AWS Bedrock", 'uv add "crewai[bedrock]"'),
+        ("Google Gen AI", 'uv add "crewai[google-genai]"'),
+    ],
+)
+def test_classify_missing_provider_extra_matches_real_messages(
+    tmp_path: Path, pkg_label: str, install_cmd: str
+) -> None:
+    """Regression for the four provider error strings verbatim."""
+    v = DeployValidator(project_root=tmp_path)
+    v._classify_import_error(
+        "ImportError",
+        f"{pkg_label} native provider not available, to install: {install_cmd}",
+        tb="",
+    )
+    assert "missing_provider_extra" in _codes(v)
+    finding = next(r for r in v.results if r.code == "missing_provider_extra")
+    assert install_cmd in finding.hint
+
+
+def test_classify_keyerror_at_import_is_warning(tmp_path: Path) -> None:
+    """Regression for `KeyError: 'SERPLY_API_KEY'` raised at import time."""
+    v = DeployValidator(project_root=tmp_path)
+    v._classify_import_error("KeyError", "'SERPLY_API_KEY'", tb="")
+    codes = _codes(v)
+    assert "env_var_read_at_import" in codes
+
+
+def test_classify_no_crewbase_class_is_error(tmp_path: Path) -> None:
+    v = DeployValidator(project_root=tmp_path)
+    v._classify_import_error(
+        "ValueError",
+        "Crew class annotated with @CrewBase not found.",
+        tb="",
+    )
+    assert "no_crewbase_class" in _codes(v)
+
+
+def test_classify_no_flow_subclass_is_error(tmp_path: Path) -> None:
+    v = DeployValidator(project_root=tmp_path)
+    v._classify_import_error("ValueError", "No Flow subclass found in the module.", tb="")
+    assert "no_flow_subclass" in _codes(v)
+
+
+def test_classify_stale_crewai_pin_attribute_error(tmp_path: Path) -> None:
+    """Regression for a stale crewai pin missing `_load_response_format`."""
+    v = DeployValidator(project_root=tmp_path)
+    v._classify_import_error(
+        "AttributeError",
+        "'EmploymentServiceDecisionSupportSystemCrew' object has no attribute '_load_response_format'",
+        tb="",
+    )
+    assert "stale_crewai_pin" in _codes(v)
+
+
+def test_classify_unknown_error_is_fallback(tmp_path: Path) -> None:
+    v = DeployValidator(project_root=tmp_path)
+    v._classify_import_error("RuntimeError", "something weird happened", tb="")
+    assert "import_failed" in _codes(v)
+
+
+def test_env_var_referenced_but_missing_warns(tmp_path: Path) -> None:
+    pkg = _scaffold_standard_crew(tmp_path)
+    (pkg / "tools.py").write_text(
+        'import os\nkey = os.getenv("TAVILY_API_KEY")\n'
+    )
+    import os
+
+    # Make sure the test doesn't inherit the key from the host environment.
+    with patch.dict(os.environ, {}, clear=False):
+        os.environ.pop("TAVILY_API_KEY", None)
+        v = _run_without_import_check(tmp_path)
+    codes = _codes(v)
+    assert "env_vars_not_in_dotenv" in codes
+
+
+def test_env_var_in_dotenv_does_not_warn(tmp_path: Path) -> None:
+    pkg = _scaffold_standard_crew(tmp_path)
+    (pkg / "tools.py").write_text(
+        'import os\nkey = os.getenv("TAVILY_API_KEY")\n'
+    )
+    (tmp_path / ".env").write_text("TAVILY_API_KEY=abc\n")
+    v = _run_without_import_check(tmp_path)
+    assert "env_vars_not_in_dotenv" not in _codes(v)
+
+
+def test_old_crewai_pin_in_uv_lock_warns(tmp_path: Path) -> None:
+    _scaffold_standard_crew(tmp_path)
+    (tmp_path / "uv.lock").write_text(
+        'name = "crewai"\nversion = "1.10.0"\nsource = { registry = "..." }\n'
+    )
+    v = _run_without_import_check(tmp_path)
+    assert "old_crewai_pin" in _codes(v)
+
+
+def test_modern_crewai_pin_does_not_warn(tmp_path: Path) -> None:
+    _scaffold_standard_crew(tmp_path)
+    (tmp_path / "uv.lock").write_text(
+        'name = "crewai"\nversion = "1.14.1"\nsource = { registry = "..." }\n'
+    )
+    v = _run_without_import_check(tmp_path)
+    assert "old_crewai_pin" not in _codes(v)
+
+
+def test_create_crew_aborts_on_validation_error(tmp_path: Path) -> None:
+    """`crewai deploy create` must not contact the API when validation fails."""
+    from unittest.mock import MagicMock, patch as mock_patch
+
+    from crewai.cli.deploy.main import DeployCommand
+
+    with (
+        mock_patch("crewai.cli.command.get_auth_token", return_value="tok"),
+        mock_patch("crewai.cli.deploy.main.get_project_name", return_value="p"),
+        mock_patch("crewai.cli.command.PlusAPI") as mock_api,
+        mock_patch(
+            "crewai.cli.deploy.main.validate_project"
+        ) as mock_validate,
+    ):
+        mock_validate.return_value = MagicMock(ok=False)
+        cmd = DeployCommand()
+        cmd.create_crew()
+        assert not cmd.plus_api_client.create_crew.called
+        del mock_api  # silence unused-var lint
\ No newline at end of file
diff --git a/lib/crewai/tests/cli/test_cli.py b/lib/crewai/tests/cli/test_cli.py
index ed74a6036..b324294b1 100644
--- a/lib/crewai/tests/cli/test_cli.py
+++ b/lib/crewai/tests/cli/test_cli.py
@@ -367,7 +367,7 @@ def test_deploy_push(command, runner):
     result = runner.invoke(deploy_push, ["-u", uuid])
 
     assert result.exit_code == 0
-    mock_deploy.deploy.assert_called_once_with(uuid=uuid)
+    mock_deploy.deploy.assert_called_once_with(uuid=uuid, skip_validate=False)
 
 
 @mock.patch("crewai.cli.cli.DeployCommand")
@@ -376,7 +376,7 @@ def test_deploy_push_no_uuid(command, runner):
     result = runner.invoke(deploy_push)
 
     assert result.exit_code == 0
-    mock_deploy.deploy.assert_called_once_with(uuid=None)
+    mock_deploy.deploy.assert_called_once_with(uuid=None, skip_validate=False)
 
 
 @mock.patch("crewai.cli.cli.DeployCommand")
diff --git a/lib/crewai/tests/llms/azure/test_azure.py b/lib/crewai/tests/llms/azure/test_azure.py
index 38b31a2e2..d42e2d7fe 100644
--- a/lib/crewai/tests/llms/azure/test_azure.py
+++ b/lib/crewai/tests/llms/azure/test_azure.py
@@ -2,6 +2,7 @@ import os
 import sys
 import types
 from unittest.mock import patch, MagicMock, Mock
+from urllib.parse import urlparse
 import pytest
 
 from crewai.llm import LLM
@@ -378,23 +379,72 @@ def test_azure_completion_with_tools():
 
 
 def test_azure_raises_error_when_endpoint_missing():
-    """Test that AzureCompletion raises ValueError when endpoint is missing"""
+    """Credentials are validated lazily: construction succeeds, first
+    client build raises the descriptive error."""
     from crewai.llms.providers.azure.completion import AzureCompletion
 
-    # Clear environment variables
     with patch.dict(os.environ, {}, clear=True):
+        llm = AzureCompletion(model="gpt-4", api_key="test-key")
         with pytest.raises(ValueError, match="Azure endpoint is required"):
-            AzureCompletion(model="gpt-4", api_key="test-key")
+            llm._get_sync_client()
 
 
 def test_azure_raises_error_when_api_key_missing():
-    """Test that AzureCompletion raises ValueError when API key is missing"""
+    """Credentials are validated lazily: construction succeeds, first
+    client build raises the descriptive error."""
     from crewai.llms.providers.azure.completion import AzureCompletion
 
-    # Clear environment variables
     with patch.dict(os.environ, {}, clear=True):
+        llm = AzureCompletion(
+            model="gpt-4", endpoint="https://test.openai.azure.com"
+        )
         with pytest.raises(ValueError, match="Azure API key is required"):
-            AzureCompletion(model="gpt-4", endpoint="https://test.openai.azure.com")
+            llm._get_sync_client()
+
+
+@pytest.mark.asyncio
+async def test_azure_aclose_is_noop_when_uninitialized():
+    """`aclose` (and `async with`) on an uninstantiated-client LLM must be
+    a harmless no-op, not force lazy construction that then raises for
+    missing credentials."""
+    from crewai.llms.providers.azure.completion import AzureCompletion
+
+    with patch.dict(os.environ, {}, clear=True):
+        llm = AzureCompletion(model="gpt-4")
+        assert llm._async_client is None
+        await llm.aclose()
+        async with llm:
+            pass
+
+
+def test_azure_lazy_build_reads_env_vars_set_after_construction():
+    """When `LLM(model="azure/...")` is constructed before env vars are set,
+    the lazy client builder must re-read `AZURE_API_KEY` / `AZURE_ENDPOINT`
+    so the LLM actually works once credentials become available, and the
+    `is_azure_openai_endpoint` routing flag must be recomputed off the
+    newly-resolved endpoint."""
+    from crewai.llms.providers.azure.completion import AzureCompletion
+
+    with patch.dict(os.environ, {}, clear=True):
+        llm = AzureCompletion(model="gpt-4")
+        assert llm.api_key is None
+        assert llm.endpoint is None
+        assert llm.is_azure_openai_endpoint is False
+
+    with patch.dict(
+        os.environ,
+        {
+            "AZURE_API_KEY": "late-key",
+            "AZURE_ENDPOINT": "https://test.openai.azure.com/openai/deployments/gpt-4",
+        },
+        clear=True,
+    ):
+        client = llm._get_sync_client()
+        assert client is not None
+        assert llm.api_key == "late-key"
+        assert llm.endpoint is not None
+        assert urlparse(llm.endpoint).hostname == "test.openai.azure.com"
+        assert llm.is_azure_openai_endpoint is True
 
 
 def test_azure_endpoint_configuration():
diff --git a/lib/crewai/tests/llms/google/test_google.py b/lib/crewai/tests/llms/google/test_google.py
index 25b755dae..f6e94f89e 100644
--- a/lib/crewai/tests/llms/google/test_google.py
+++ b/lib/crewai/tests/llms/google/test_google.py
@@ -64,6 +64,23 @@ def test_gemini_completion_module_is_imported():
     assert hasattr(completion_mod, 'GeminiCompletion')
 
 
+def test_gemini_lazy_build_reads_env_vars_set_after_construction():
+    """When `LLM(model="gemini/...")` is constructed before env vars are set,
+    the lazy client builder must re-read `GOOGLE_API_KEY` / `GEMINI_API_KEY`
+    so the LLM works once credentials become available."""
+    from crewai.llms.providers.gemini.completion import GeminiCompletion
+
+    with patch.dict(os.environ, {}, clear=True):
+        llm = GeminiCompletion(model="gemini-1.5-pro")
+        assert llm.api_key is None
+        assert llm._client is None
+
+    with patch.dict(os.environ, {"GEMINI_API_KEY": "late-key"}, clear=True):
+        client = llm._get_sync_client()
+        assert client is not None
+        assert llm.api_key == "late-key"
+
+
 def test_native_gemini_raises_error_when_initialization_fails():
     """
     Test that LLM raises ImportError when native Gemini completion fails.
diff --git a/lib/crewai/tests/utilities/test_llm_utils.py b/lib/crewai/tests/utilities/test_llm_utils.py
index 5d7d70b76..a32fdcbc9 100644
--- a/lib/crewai/tests/utilities/test_llm_utils.py
+++ b/lib/crewai/tests/utilities/test_llm_utils.py
@@ -119,10 +119,12 @@ def test_create_llm_with_invalid_type() -> None:
 
 
 def test_create_llm_openai_missing_api_key() -> None:
-    """Test that create_llm raises error when OpenAI API key is missing"""
+    """Credentials are validated lazily: `create_llm` succeeds, and the
+    descriptive error only surfaces when the client is actually built."""
     with patch.dict(os.environ, {}, clear=True):
+        llm = create_llm(llm_value="gpt-4o")
         with pytest.raises((ValueError, ImportError)) as exc_info:
-            create_llm(llm_value="gpt-4o")
+            llm._get_sync_client()
 
         error_message = str(exc_info.value).lower()
         assert "openai_api_key" in error_message or "api_key" in error_message

From 16bf24001e16899101e6c42a392925d1de4b8664 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Sun, 12 Apr 2026 16:12:35 +0800
Subject: [PATCH 37/70] fix: upgrade requests to >=2.33.0 for CVE temp file
 vulnerability

---
 lib/crewai-tools/pyproject.toml | 2 +-
 uv.lock                         | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/lib/crewai-tools/pyproject.toml b/lib/crewai-tools/pyproject.toml
index 2662344c0..de4320acd 100644
--- a/lib/crewai-tools/pyproject.toml
+++ b/lib/crewai-tools/pyproject.toml
@@ -9,7 +9,7 @@ authors = [
 requires-python = ">=3.10, <3.14"
 dependencies = [
     "pytube~=15.0.0",
-    "requests~=2.32.5",
+    "requests>=2.33.0,<3",
     "crewai==1.14.2a2",
     "tiktoken~=0.8.0",
     "beautifulsoup4~=4.13.4",
diff --git a/uv.lock b/uv.lock
index e6b7a9de4..714d04b61 100644
--- a/uv.lock
+++ b/uv.lock
@@ -1592,7 +1592,7 @@ requires-dist = [
     { name = "python-docx", marker = "extra == 'rag'", specifier = ">=1.1.0" },
     { name = "pytube", specifier = "~=15.0.0" },
     { name = "qdrant-client", marker = "extra == 'qdrant-client'", specifier = ">=1.12.1" },
-    { name = "requests", specifier = "~=2.32.5" },
+    { name = "requests", specifier = ">=2.33.0,<3" },
     { name = "scrapegraph-py", marker = "extra == 'scrapegraph-py'", specifier = ">=1.9.0" },
     { name = "scrapfly-sdk", marker = "extra == 'scrapfly-sdk'", specifier = ">=0.8.19" },
     { name = "selenium", marker = "extra == 'selenium'", specifier = ">=4.27.1" },
@@ -7369,7 +7369,7 @@ wheels = [
 
 [[package]]
 name = "requests"
-version = "2.32.5"
+version = "2.33.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "certifi" },
@@ -7377,9 +7377,9 @@ dependencies = [
     { name = "idna" },
     { name = "urllib3" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/c9/74/b3ff8e6c8446842c3f5c837e9c3dfcfe2018ea6ecef224c710c85ef728f4/requests-2.32.5.tar.gz", hash = "sha256:dbba0bac56e100853db0ea71b82b4dfd5fe2bf6d3754a8893c3af500cec7d7cf", size = 134517, upload-time = "2025-08-18T20:46:02.573Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/5f/a4/98b9c7c6428a668bf7e42ebb7c79d576a1c3c1e3ae2d47e674b468388871/requests-2.33.1.tar.gz", hash = "sha256:18817f8c57c6263968bc123d237e3b8b08ac046f5456bd1e307ee8f4250d3517", size = 134120, upload-time = "2026-03-30T16:09:15.531Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6", size = 64738, upload-time = "2025-08-18T20:46:00.542Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/8e/7540e8a2036f79a125c1d2ebadf69ed7901608859186c856fa0388ef4197/requests-2.33.1-py3-none-any.whl", hash = "sha256:4e6d1ef462f3626a1f0a0a9c42dd93c63bad33f9f1c1937509b8c5c8718ab56a", size = 64947, upload-time = "2026-03-30T16:09:13.83Z" },
 ]
 
 [[package]]

From 121720cbb384e8a2ee21cd309f42911d969fef71 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Mon, 13 Apr 2026 10:49:59 +0800
Subject: [PATCH 38/70] chore: clean up redundant inline docs in a2a module

---
 lib/crewai/src/crewai/a2a/errors.py               | 1 -
 lib/crewai/src/crewai/a2a/extensions/base.py      | 4 ----
 lib/crewai/src/crewai/a2a/utils/response_model.py | 1 -
 3 files changed, 6 deletions(-)

diff --git a/lib/crewai/src/crewai/a2a/errors.py b/lib/crewai/src/crewai/a2a/errors.py
index b55200708..56d82e110 100644
--- a/lib/crewai/src/crewai/a2a/errors.py
+++ b/lib/crewai/src/crewai/a2a/errors.py
@@ -98,7 +98,6 @@ class A2AErrorCode(IntEnum):
     """The specified artifact was not found."""
 
 
-# Error code to default message mapping
 ERROR_MESSAGES: dict[int, str] = {
     A2AErrorCode.JSON_PARSE_ERROR: "Parse error",
     A2AErrorCode.INVALID_REQUEST: "Invalid Request",
diff --git a/lib/crewai/src/crewai/a2a/extensions/base.py b/lib/crewai/src/crewai/a2a/extensions/base.py
index b94e9543e..d9a280506 100644
--- a/lib/crewai/src/crewai/a2a/extensions/base.py
+++ b/lib/crewai/src/crewai/a2a/extensions/base.py
@@ -63,25 +63,21 @@ class A2AExtension(Protocol):
     Example:
         class MyExtension:
             def inject_tools(self, agent: Agent) -> None:
-                # Add custom tools to the agent
                 pass
 
             def extract_state_from_history(
                 self, conversation_history: Sequence[Message]
             ) -> ConversationState | None:
-                # Extract state from conversation
                 return None
 
             def augment_prompt(
                 self, base_prompt: str, conversation_state: ConversationState | None
             ) -> str:
-                # Add custom instructions
                 return base_prompt
 
             def process_response(
                 self, agent_response: Any, conversation_state: ConversationState | None
             ) -> Any:
-                # Modify response if needed
                 return agent_response
     """
 
diff --git a/lib/crewai/src/crewai/a2a/utils/response_model.py b/lib/crewai/src/crewai/a2a/utils/response_model.py
index 4e65ef2b7..1359e2f10 100644
--- a/lib/crewai/src/crewai/a2a/utils/response_model.py
+++ b/lib/crewai/src/crewai/a2a/utils/response_model.py
@@ -77,7 +77,6 @@ def extract_a2a_agent_ids_from_config(
     else:
         configs = a2a_config
 
-    # Filter to only client configs (those with endpoint)
     client_configs: list[A2AClientConfigTypes] = [
         config for config in configs if isinstance(config, (A2AConfig, A2AClientConfig))
     ]

From 8dc2655cbfd1d74ac2814104df1a429f4d7bd4a3 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Mon, 13 Apr 2026 10:55:29 +0800
Subject: [PATCH 39/70] chore: clean up redundant inline docs in agent module

---
 lib/crewai/src/crewai/agent/core.py            | 7 +------
 lib/crewai/src/crewai/agent/planning_config.py | 5 +----
 lib/crewai/src/crewai/agent/utils.py           | 1 -
 3 files changed, 2 insertions(+), 11 deletions(-)

diff --git a/lib/crewai/src/crewai/agent/core.py b/lib/crewai/src/crewai/agent/core.py
index eb73ba719..597b69dc9 100644
--- a/lib/crewai/src/crewai/agent/core.py
+++ b/lib/crewai/src/crewai/agent/core.py
@@ -1341,7 +1341,6 @@ class Agent(BaseAgent):
 
         raw_tools: list[BaseTool] = self.tools or []
 
-        # Inject memory tools for standalone kickoff (crew path handles its own)
         agent_memory = getattr(self, "memory", None)
         if agent_memory is not None:
             from crewai.tools.memory_tools import create_memory_tools
@@ -1399,7 +1398,6 @@ class Agent(BaseAgent):
         if input_files:
             all_files.update(input_files)
 
-        # Inject memory context for standalone kickoff (recall before execution)
         if agent_memory is not None:
             try:
                 crewai_event_bus.emit(
@@ -1485,8 +1483,6 @@ class Agent(BaseAgent):
         Note:
             For explicit async usage outside of Flow, use kickoff_async() directly.
         """
-        # Magic auto-async: if inside event loop (e.g., inside a Flow),
-        # return coroutine for Flow to await
         if is_inside_event_loop():
             return self.kickoff_async(messages, response_format, input_files)
 
@@ -1637,7 +1633,7 @@ class Agent(BaseAgent):
                 if isinstance(conversion_result, BaseModel):
                     formatted_result = conversion_result
             except ConverterError:
-                pass  # Keep raw output if conversion fails
+                pass
         else:
             raw_output = str(output) if not isinstance(output, str) else output
 
@@ -1719,7 +1715,6 @@ class Agent(BaseAgent):
         elif callable(self.guardrail):
             guardrail_callable = self.guardrail
         else:
-            # Should not happen if called from kickoff with guardrail check
             return output
 
         guardrail_result = process_guardrail(
diff --git a/lib/crewai/src/crewai/agent/planning_config.py b/lib/crewai/src/crewai/agent/planning_config.py
index d30b0eb46..cd8124b9c 100644
--- a/lib/crewai/src/crewai/agent/planning_config.py
+++ b/lib/crewai/src/crewai/agent/planning_config.py
@@ -41,7 +41,6 @@ class PlanningConfig(BaseModel):
         from crewai import Agent
         from crewai.agent.planning_config import PlanningConfig
 
-        # Simple usage — fast, linear execution (default)
         agent = Agent(
             role="Researcher",
             goal="Research topics",
@@ -49,7 +48,6 @@ class PlanningConfig(BaseModel):
             planning_config=PlanningConfig(),
         )
 
-        # Balanced — replan only when steps fail
         agent = Agent(
             role="Researcher",
             goal="Research topics",
@@ -59,7 +57,6 @@ class PlanningConfig(BaseModel):
             ),
         )
 
-        # Full adaptive planning with refinement and replanning
         agent = Agent(
             role="Researcher",
             goal="Research topics",
@@ -69,7 +66,7 @@ class PlanningConfig(BaseModel):
                 max_attempts=3,
                 max_steps=10,
                 plan_prompt="Create a focused plan for: {description}",
-                llm="gpt-4o-mini",  # Use cheaper model for planning
+                llm="gpt-4o-mini",
             ),
         )
         ```
diff --git a/lib/crewai/src/crewai/agent/utils.py b/lib/crewai/src/crewai/agent/utils.py
index 31f08903f..93c861835 100644
--- a/lib/crewai/src/crewai/agent/utils.py
+++ b/lib/crewai/src/crewai/agent/utils.py
@@ -39,7 +39,6 @@ def handle_reasoning(agent: Agent, task: Task) -> None:
         agent: The agent performing the task.
         task: The task to execute.
     """
-    # Check if planning is enabled using the planning_enabled property
     if not getattr(agent, "planning_enabled", False):
         return
 

From 1d6f84c7aab08bf460a08180a1fc7f15326f22ab Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Mon, 13 Apr 2026 11:00:42 +0800
Subject: [PATCH 40/70] chore: clean up redundant inline docs in agents module

---
 .../openai_agent_tool_adapter.py              |  5 --
 .../crewai/agents/agent_builder/base_agent.py |  8 ---
 lib/crewai/src/crewai/agents/constants.py     |  2 -
 .../src/crewai/agents/crew_agent_executor.py  | 57 ++-----------------
 lib/crewai/src/crewai/agents/parser.py        | 13 -----
 .../src/crewai/agents/planner_observer.py     | 21 -------
 lib/crewai/src/crewai/agents/step_executor.py | 37 ------------
 7 files changed, 4 insertions(+), 139 deletions(-)

diff --git a/lib/crewai/src/crewai/agents/agent_adapters/openai_agents/openai_agent_tool_adapter.py b/lib/crewai/src/crewai/agents/agent_adapters/openai_agents/openai_agent_tool_adapter.py
index 7543305f0..7e0979ba5 100644
--- a/lib/crewai/src/crewai/agents/agent_adapters/openai_agents/openai_agent_tool_adapter.py
+++ b/lib/crewai/src/crewai/agents/agent_adapters/openai_agents/openai_agent_tool_adapter.py
@@ -99,12 +99,10 @@ class OpenAIAgentToolAdapter(BaseToolAdapter):
                 Returns:
                     Tool execution result.
                 """
-                # Get the parameter name from the schema
                 param_name: str = next(
                     iter(tool.args_schema.model_json_schema()["properties"].keys())
                 )
 
-                # Handle different argument types
                 args_dict: dict[str, Any]
                 if isinstance(arguments, dict):
                     args_dict = arguments
@@ -116,16 +114,13 @@ class OpenAIAgentToolAdapter(BaseToolAdapter):
                 else:
                     args_dict = {param_name: str(arguments)}
 
-                # Run the tool with the processed arguments
                 output: Any | Awaitable[Any] = tool._run(**args_dict)
 
-                # Await if the tool returned a coroutine
                 if inspect.isawaitable(output):
                     result: Any = await output
                 else:
                     result = output
 
-                # Ensure the result is JSON serializable
                 if isinstance(result, (dict, list, str, int, float, bool, type(None))):
                     return result
                 return str(result)
diff --git a/lib/crewai/src/crewai/agents/agent_builder/base_agent.py b/lib/crewai/src/crewai/agents/agent_builder/base_agent.py
index 9d37373e8..a00f9b49f 100644
--- a/lib/crewai/src/crewai/agents/agent_builder/base_agent.py
+++ b/lib/crewai/src/crewai/agents/agent_builder/base_agent.py
@@ -383,7 +383,6 @@ class BaseAgent(BaseModel, ABC, metaclass=AgentMeta):
             if isinstance(tool, BaseTool):
                 processed_tools.append(tool)
             elif all(hasattr(tool, attr) for attr in required_attrs):
-                # Tool has the required attributes, create a Tool instance
                 processed_tools.append(Tool.from_langchain(tool))
             else:
                 raise ValueError(
@@ -448,14 +447,12 @@ class BaseAgent(BaseModel, ABC, metaclass=AgentMeta):
 
     @model_validator(mode="after")
     def validate_and_set_attributes(self) -> Self:
-        # Validate required fields
         for field in ["role", "goal", "backstory"]:
             if getattr(self, field) is None:
                 raise ValueError(
                     f"{field} must be provided either directly or through config"
                 )
 
-        # Set private attributes
         self._logger = Logger(verbose=self.verbose)
         if self.max_rpm and not self._rpm_controller:
             self._rpm_controller = RPMController(
@@ -464,7 +461,6 @@ class BaseAgent(BaseModel, ABC, metaclass=AgentMeta):
         if not self._token_process:
             self._token_process = TokenProcess()
 
-        # Initialize security_config if not provided
         if self.security_config is None:
             self.security_config = SecurityConfig()
 
@@ -566,14 +562,11 @@ class BaseAgent(BaseModel, ABC, metaclass=AgentMeta):
             "actions",
         }
 
-        # Copy llm
         existing_llm = shallow_copy(self.llm)
         copied_knowledge = shallow_copy(self.knowledge)
         copied_knowledge_storage = shallow_copy(self.knowledge_storage)
-        # Properly copy knowledge sources if they exist
         existing_knowledge_sources = None
         if self.knowledge_sources:
-            # Create a shared storage instance for all knowledge sources
             shared_storage = (
                 self.knowledge_sources[0].storage if self.knowledge_sources else None
             )
@@ -585,7 +578,6 @@ class BaseAgent(BaseModel, ABC, metaclass=AgentMeta):
                     if hasattr(source, "model_copy")
                     else shallow_copy(source)
                 )
-                # Ensure all copied sources use the same storage instance
                 copied_source.storage = shared_storage
                 existing_knowledge_sources.append(copied_source)
 
diff --git a/lib/crewai/src/crewai/agents/constants.py b/lib/crewai/src/crewai/agents/constants.py
index 326d53d02..7a180f947 100644
--- a/lib/crewai/src/crewai/agents/constants.py
+++ b/lib/crewai/src/crewai/agents/constants.py
@@ -4,8 +4,6 @@ import re
 from typing import Final
 
 
-# crewai.agents.parser constants
-
 FINAL_ANSWER_ACTION: Final[str] = "Final Answer:"
 MISSING_ACTION_AFTER_THOUGHT_ERROR_MESSAGE: Final[str] = (
     "I did it wrong. Invalid Format: I missed the 'Action:' after 'Thought:'. I will do right next, and don't use a tool I have already used.\n"
diff --git a/lib/crewai/src/crewai/agents/crew_agent_executor.py b/lib/crewai/src/crewai/agents/crew_agent_executor.py
index b98840cae..62369bfb9 100644
--- a/lib/crewai/src/crewai/agents/crew_agent_executor.py
+++ b/lib/crewai/src/crewai/agents/crew_agent_executor.py
@@ -296,7 +296,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
         Returns:
             Final answer from the agent.
         """
-        # Check if model supports native function calling
         use_native_tools = (
             hasattr(self.llm, "supports_function_calling")
             and callable(getattr(self.llm, "supports_function_calling", None))
@@ -307,7 +306,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
         if use_native_tools:
             return self._invoke_loop_native_tools()
 
-        # Fall back to ReAct text-based pattern
         return self._invoke_loop_react()
 
     def _invoke_loop_react(self) -> AgentFinish:
@@ -347,7 +345,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                     executor_context=self,
                     verbose=self.agent.verbose,
                 )
-                # breakpoint()
                 if self.response_model is not None:
                     try:
                         if isinstance(answer, BaseModel):
@@ -365,7 +362,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                                 text=answer,
                             )
                     except ValidationError:
-                        # If validation fails, convert BaseModel to JSON string for parsing
                         answer_str = (
                             answer.model_dump_json()
                             if isinstance(answer, BaseModel)
@@ -375,14 +371,12 @@ class CrewAgentExecutor(BaseAgentExecutor):
                             answer_str, self.use_stop_words
                         )  # type: ignore[assignment]
                 else:
-                    # When no response_model, answer should be a string
                     answer_str = str(answer) if not isinstance(answer, str) else answer
                     formatted_answer = process_llm_response(
                         answer_str, self.use_stop_words
                     )  # type: ignore[assignment]
 
                 if isinstance(formatted_answer, AgentAction):
-                    # Extract agent fingerprint if available
                     fingerprint_context = {}
                     if (
                         self.agent
@@ -426,7 +420,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
 
             except Exception as e:
                 if e.__class__.__module__.startswith("litellm"):
-                    # Do not retry on litellm errors
                     raise e
                 if is_context_length_exceeded(e):
                     handle_context_length(
@@ -443,10 +436,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
             finally:
                 self.iterations += 1
 
-        # During the invoke loop, formatted_answer alternates between AgentAction
-        # (when the agent is using tools) and eventually becomes AgentFinish
-        # (when the agent reaches a final answer). This check confirms we've
-        # reached a final answer and helps type checking understand this transition.
         if not isinstance(formatted_answer, AgentFinish):
             raise RuntimeError(
                 "Agent execution ended without reaching a final answer. "
@@ -465,9 +454,7 @@ class CrewAgentExecutor(BaseAgentExecutor):
         Returns:
             Final answer from the agent.
         """
-        # Convert tools to OpenAI schema format
         if not self.original_tools:
-            # No tools available, fall back to simple LLM call
             return self._invoke_loop_native_no_tools()
 
         openai_tools, available_functions, self._tool_name_mapping = (
@@ -490,10 +477,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
 
                 enforce_rpm_limit(self.request_within_rpm_limit)
 
-                # Call LLM with native tools
-                # Pass available_functions=None so the LLM returns tool_calls
-                # without executing them. The executor handles tool execution
-                # via _handle_native_tool_calls to properly manage message history.
                 answer = get_llm_response(
                     llm=cast("BaseLLM", self.llm),
                     messages=self.messages,
@@ -508,32 +491,26 @@ class CrewAgentExecutor(BaseAgentExecutor):
                     verbose=self.agent.verbose,
                 )
 
-                # Check if the response is a list of tool calls
                 if (
                     isinstance(answer, list)
                     and answer
                     and self._is_tool_call_list(answer)
                 ):
-                    # Handle tool calls - execute tools and add results to messages
                     tool_finish = self._handle_native_tool_calls(
                         answer, available_functions
                     )
-                    # If tool has result_as_answer=True, return immediately
                     if tool_finish is not None:
                         return tool_finish
-                    # Continue loop to let LLM analyze results and decide next steps
                     continue
 
-                # Text or other response - handle as potential final answer
                 if isinstance(answer, str):
-                    # Text response - this is the final answer
                     formatted_answer = AgentFinish(
                         thought="",
                         output=answer,
                         text=answer,
                     )
                     self._invoke_step_callback(formatted_answer)
-                    self._append_message(answer)  # Save final answer to messages
+                    self._append_message(answer)
                     self._show_logs(formatted_answer)
                     return formatted_answer
 
@@ -549,14 +526,13 @@ class CrewAgentExecutor(BaseAgentExecutor):
                     self._show_logs(formatted_answer)
                     return formatted_answer
 
-                # Unexpected response type, treat as final answer
                 formatted_answer = AgentFinish(
                     thought="",
                     output=str(answer),
                     text=str(answer),
                 )
                 self._invoke_step_callback(formatted_answer)
-                self._append_message(str(answer))  # Save final answer to messages
+                self._append_message(str(answer))
                 self._show_logs(formatted_answer)
                 return formatted_answer
 
@@ -627,12 +603,10 @@ class CrewAgentExecutor(BaseAgentExecutor):
         if not response:
             return False
         first_item = response[0]
-        # OpenAI-style
         if hasattr(first_item, "function") or (
             isinstance(first_item, dict) and "function" in first_item
         ):
             return True
-        # Anthropic-style (object with attributes)
         if (
             hasattr(first_item, "type")
             and getattr(first_item, "type", None) == "tool_use"
@@ -640,14 +614,12 @@ class CrewAgentExecutor(BaseAgentExecutor):
             return True
         if hasattr(first_item, "name") and hasattr(first_item, "input"):
             return True
-        # Bedrock-style (dict with name and input keys)
         if (
             isinstance(first_item, dict)
             and "name" in first_item
             and "input" in first_item
         ):
             return True
-        # Gemini-style
         if hasattr(first_item, "function_call") and first_item.function_call:
             return True
         return False
@@ -706,8 +678,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                 for _, func_name, _ in parsed_calls
             )
 
-            # Preserve historical sequential behavior for result_as_answer batches.
-            # Also avoid threading around usage counters for max_usage_count tools.
             if has_result_as_answer_in_batch or has_max_usage_count_in_batch:
                 logger.debug(
                     "Skipping parallel native execution because batch includes result_as_answer or max_usage_count tool"
@@ -773,7 +743,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                 self.messages.append(reasoning_message)
                 return None
 
-        # Sequential behavior: process only first tool call, then force reflection.
         call_id, func_name, func_args = parsed_calls[0]
         self._append_assistant_tool_calls_message([(call_id, func_name, func_args)])
 
@@ -1202,7 +1171,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                                 text=answer,
                             )
                     except ValidationError:
-                        # If validation fails, convert BaseModel to JSON string for parsing
                         answer_str = (
                             answer.model_dump_json()
                             if isinstance(answer, BaseModel)
@@ -1212,7 +1180,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                             answer_str, self.use_stop_words
                         )  # type: ignore[assignment]
                 else:
-                    # When no response_model, answer should be a string
                     answer_str = str(answer) if not isinstance(answer, str) else answer
                     formatted_answer = process_llm_response(
                         answer_str, self.use_stop_words
@@ -1319,10 +1286,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
 
                 enforce_rpm_limit(self.request_within_rpm_limit)
 
-                # Call LLM with native tools
-                # Pass available_functions=None so the LLM returns tool_calls
-                # without executing them. The executor handles tool execution
-                # via _handle_native_tool_calls to properly manage message history.
                 answer = await aget_llm_response(
                     llm=cast("BaseLLM", self.llm),
                     messages=self.messages,
@@ -1336,32 +1299,26 @@ class CrewAgentExecutor(BaseAgentExecutor):
                     executor_context=self,
                     verbose=self.agent.verbose,
                 )
-                # Check if the response is a list of tool calls
                 if (
                     isinstance(answer, list)
                     and answer
                     and self._is_tool_call_list(answer)
                 ):
-                    # Handle tool calls - execute tools and add results to messages
                     tool_finish = self._handle_native_tool_calls(
                         answer, available_functions
                     )
-                    # If tool has result_as_answer=True, return immediately
                     if tool_finish is not None:
                         return tool_finish
-                    # Continue loop to let LLM analyze results and decide next steps
                     continue
 
-                # Text or other response - handle as potential final answer
                 if isinstance(answer, str):
-                    # Text response - this is the final answer
                     formatted_answer = AgentFinish(
                         thought="",
                         output=answer,
                         text=answer,
                     )
                     await self._ainvoke_step_callback(formatted_answer)
-                    self._append_message(answer)  # Save final answer to messages
+                    self._append_message(answer)
                     self._show_logs(formatted_answer)
                     return formatted_answer
 
@@ -1377,14 +1334,13 @@ class CrewAgentExecutor(BaseAgentExecutor):
                     self._show_logs(formatted_answer)
                     return formatted_answer
 
-                # Unexpected response type, treat as final answer
                 formatted_answer = AgentFinish(
                     thought="",
                     output=str(answer),
                     text=str(answer),
                 )
                 await self._ainvoke_step_callback(formatted_answer)
-                self._append_message(str(answer))  # Save final answer to messages
+                self._append_message(str(answer))
                 self._show_logs(formatted_answer)
                 return formatted_answer
 
@@ -1455,7 +1411,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
         Returns:
             Updated action or final answer.
         """
-        # Special case for add_image_tool
         add_image_tool = I18N_DEFAULT.tools("add_image")
         if (
             isinstance(add_image_tool, dict)
@@ -1575,17 +1530,14 @@ class CrewAgentExecutor(BaseAgentExecutor):
         training_handler = CrewTrainingHandler(TRAINING_DATA_FILE)
         training_data = training_handler.load() or {}
 
-        # Initialize or retrieve agent's training data
         agent_training_data = training_data.get(agent_id, {})
 
         if human_feedback is not None:
-            # Save initial output and human feedback
             agent_training_data[train_iteration] = {
                 "initial_output": result.output,
                 "human_feedback": human_feedback,
             }
         else:
-            # Save improved output
             if train_iteration in agent_training_data:
                 agent_training_data[train_iteration]["improved_output"] = result.output
             else:
@@ -1599,7 +1551,6 @@ class CrewAgentExecutor(BaseAgentExecutor):
                     )
                 return
 
-        # Update the training data and save
         training_data[agent_id] = agent_training_data
         training_handler.save(training_data)
 
diff --git a/lib/crewai/src/crewai/agents/parser.py b/lib/crewai/src/crewai/agents/parser.py
index bfe3a28b5..c59719226 100644
--- a/lib/crewai/src/crewai/agents/parser.py
+++ b/lib/crewai/src/crewai/agents/parser.py
@@ -94,11 +94,8 @@ def parse(text: str) -> AgentAction | AgentFinish:
 
     if includes_answer:
         final_answer = text.split(FINAL_ANSWER_ACTION)[-1].strip()
-        # Check whether the final answer ends with triple backticks.
         if final_answer.endswith("```"):
-            # Count occurrences of triple backticks in the final answer.
             count = final_answer.count("```")
-            # If count is odd then it's an unmatched trailing set; remove it.
             if count % 2 != 0:
                 final_answer = final_answer[:-3].rstrip()
         return AgentFinish(thought=thought, output=final_answer, text=text)
@@ -146,7 +143,6 @@ def _extract_thought(text: str) -> str:
     if thought_index == -1:
         return ""
     thought = text[:thought_index].strip()
-    # Remove any triple backticks from the thought string
     return thought.replace("```", "").strip()
 
 
@@ -171,18 +167,9 @@ def _safe_repair_json(tool_input: str) -> str:
     Returns:
         The repaired JSON string or original if repair fails.
     """
-    # Skip repair if the input starts and ends with square brackets
-    # Explanation: The JSON parser has issues handling inputs that are enclosed in square brackets ('[]').
-    # These are typically valid JSON arrays or strings that do not require repair. Attempting to repair such inputs
-    # might lead to unintended alterations, such as wrapping the entire input in additional layers or modifying
-    # the structure in a way that changes its meaning. By skipping the repair for inputs that start and end with
-    # square brackets, we preserve the integrity of these valid JSON structures and avoid unnecessary modifications.
     if tool_input.startswith("[") and tool_input.endswith("]"):
         return tool_input
 
-    # Before repair, handle common LLM issues:
-    # 1. Replace """ with " to avoid JSON parser errors
-
     tool_input = tool_input.replace('"""', '"')
 
     result = repair_json(tool_input)
diff --git a/lib/crewai/src/crewai/agents/planner_observer.py b/lib/crewai/src/crewai/agents/planner_observer.py
index 0705d3013..29d586663 100644
--- a/lib/crewai/src/crewai/agents/planner_observer.py
+++ b/lib/crewai/src/crewai/agents/planner_observer.py
@@ -83,10 +83,6 @@ class PlannerObserver:
             return create_llm(config.llm)
         return self.agent.llm
 
-    # ------------------------------------------------------------------
-    # Public API
-    # ------------------------------------------------------------------
-
     def observe(
         self,
         completed_step: TodoItem,
@@ -182,9 +178,6 @@ class PlannerObserver:
                 ),
             )
 
-            # Don't force a full replan — the step may have succeeded even if the
-            # observer LLM failed to parse the result. Defaulting to "continue" is
-            # far less disruptive than wiping the entire plan on every observer error.
             return StepObservation(
                 step_completed_successfully=True,
                 key_information_learned="",
@@ -221,10 +214,6 @@ class PlannerObserver:
 
         return remaining_todos
 
-    # ------------------------------------------------------------------
-    # Internal: Message building
-    # ------------------------------------------------------------------
-
     def _build_observation_messages(
         self,
         completed_step: TodoItem,
@@ -239,15 +228,11 @@ class PlannerObserver:
             task_desc = self.task.description or ""
             task_goal = self.task.expected_output or ""
         elif self.kickoff_input:
-            # Standalone kickoff path — no Task object, but we have the raw input.
-            # Extract just the ## Task section so the observer sees the actual goal,
-            # not the full enriched instruction with env/tools/verification noise.
             task_desc = extract_task_section(self.kickoff_input)
             task_goal = "Complete the task successfully"
 
         system_prompt = I18N_DEFAULT.retrieve("planning", "observation_system_prompt")
 
-        # Build context of what's been done
         completed_summary = ""
         if all_completed:
             completed_lines = []
@@ -261,7 +246,6 @@ class PlannerObserver:
                 completed_lines
             )
 
-        # Build remaining plan
         remaining_summary = ""
         if remaining_todos:
             remaining_lines = [
@@ -306,17 +290,14 @@ class PlannerObserver:
         if isinstance(response, StepObservation):
             return response
 
-        # JSON string path — most common miss before this fix
         if isinstance(response, str):
             text = response.strip()
             try:
                 return StepObservation.model_validate_json(text)
             except Exception:  # noqa: S110
                 pass
-            # Some LLMs wrap the JSON in markdown fences
             if text.startswith("```"):
                 lines = text.split("\n")
-                # Strip first and last lines (``` markers)
                 inner = "\n".join(
                     lines[1:-1] if lines[-1].strip() == "```" else lines[1:]
                 )
@@ -325,14 +306,12 @@ class PlannerObserver:
                 except Exception:  # noqa: S110
                     pass
 
-        # Dict path
         if isinstance(response, dict):
             try:
                 return StepObservation.model_validate(response)
             except Exception:  # noqa: S110
                 pass
 
-        # Last resort — log what we got so it's diagnosable
         logger.warning(
             "Could not parse observation response (type=%s). "
             "Falling back to default failure observation. Preview: %.200s",
diff --git a/lib/crewai/src/crewai/agents/step_executor.py b/lib/crewai/src/crewai/agents/step_executor.py
index 3348692b6..df834e3e4 100644
--- a/lib/crewai/src/crewai/agents/step_executor.py
+++ b/lib/crewai/src/crewai/agents/step_executor.py
@@ -108,7 +108,6 @@ class StepExecutor:
         self.request_within_rpm_limit = request_within_rpm_limit
         self.callbacks = callbacks or []
 
-        # Native tool support — set up once
         self._use_native_tools = check_native_tool_support(
             self.llm, self.original_tools
         )
@@ -121,10 +120,6 @@ class StepExecutor:
                 _,
             ) = setup_native_tools(self.original_tools)
 
-    # ------------------------------------------------------------------
-    # Public API
-    # ------------------------------------------------------------------
-
     def execute(
         self,
         todo: TodoItem,
@@ -190,10 +185,6 @@ class StepExecutor:
                 execution_time=elapsed,
             )
 
-    # ------------------------------------------------------------------
-    # Internal: Message building
-    # ------------------------------------------------------------------
-
     def _build_isolated_messages(
         self, todo: TodoItem, context: StepExecutionContext
     ) -> list[LLMMessage]:
@@ -237,10 +228,6 @@ class StepExecutor:
         """Build the user prompt for this specific step."""
         parts: list[str] = []
 
-        # Include overall task context so the executor knows the full goal and
-        # required output format/location — critical for knowing WHAT to produce.
-        # We extract only the task body (not tool instructions or verification
-        # sections) to avoid duplicating directives already in the system prompt.
         if context.task_description:
             task_section = extract_task_section(context.task_description)
             if task_section:
@@ -267,7 +254,6 @@ class StepExecutor:
                 )
             )
 
-        # Include dependency results (final results only, no traces)
         if context.dependency_results:
             parts.append(
                 I18N_DEFAULT.retrieve("planning", "step_executor_context_header")
@@ -283,10 +269,6 @@ class StepExecutor:
 
         return "\n".join(parts)
 
-    # ------------------------------------------------------------------
-    # Internal: Multi-turn execution loop
-    # ------------------------------------------------------------------
-
     def _execute_text_parsed(
         self,
         messages: list[LLMMessage],
@@ -306,7 +288,6 @@ class StepExecutor:
         last_tool_result = ""
 
         for _ in range(max_step_iterations):
-            # Check step timeout
             if step_timeout and start_time:
                 elapsed = time.monotonic() - start_time
                 if elapsed >= step_timeout:
@@ -331,17 +312,12 @@ class StepExecutor:
                 tool_calls_made.append(formatted.tool)
                 tool_result = self._execute_text_tool_with_events(formatted)
                 last_tool_result = tool_result
-                # Append the assistant's reasoning + action, then the observation.
-                # _build_observation_message handles vision sentinels so the LLM
-                # receives an image content block instead of raw base64 text.
                 messages.append({"role": "assistant", "content": answer_str})
                 messages.append(self._build_observation_message(tool_result))
                 continue
 
-            # Raw text response with no Final Answer marker — treat as done
             return answer_str
 
-        # Max iterations reached — return the last tool result we accumulated
         return last_tool_result
 
     def _execute_text_tool_with_events(self, formatted: AgentAction) -> str:
@@ -429,10 +405,6 @@ class StepExecutor:
                 return {"input": stripped_input}
         return {"input": str(tool_input)}
 
-    # ------------------------------------------------------------------
-    # Internal: Vision support
-    # ------------------------------------------------------------------
-
     @staticmethod
     def _parse_vision_sentinel(raw: str) -> tuple[str, str] | None:
         """Parse a VISION_IMAGE sentinel into (media_type, base64_data), or None."""
@@ -517,7 +489,6 @@ class StepExecutor:
         accumulated_results: list[str] = []
 
         for _ in range(max_step_iterations):
-            # Check step timeout
             if step_timeout and start_time:
                 elapsed = time.monotonic() - start_time
                 if elapsed >= step_timeout:
@@ -541,19 +512,14 @@ class StepExecutor:
                 return answer.model_dump_json()
 
             if isinstance(answer, list) and answer and is_tool_call_list(answer):
-                # _execute_native_tool_calls appends assistant + tool messages
-                # to `messages` as a side-effect, so the next LLM call will
-                # see the full conversation history including tool outputs.
                 result = self._execute_native_tool_calls(
                     answer, messages, tool_calls_made
                 )
                 accumulated_results.append(result)
                 continue
 
-            # Text answer → LLM decided the step is done
             return str(answer)
 
-        # Max iterations reached — return everything we accumulated
         return "\n".join(filter(None, accumulated_results))
 
     def _execute_native_tool_calls(
@@ -599,9 +565,6 @@ class StepExecutor:
                     parsed = self._parse_vision_sentinel(raw_content)
                     if parsed:
                         media_type, b64_data = parsed
-                        # Replace the sentinel with a standard image_url content block.
-                        # Each provider's _format_messages handles conversion to
-                        # its native format (e.g. Anthropic image blocks).
                         modified: LLMMessage = cast(
                             LLMMessage, dict(call_result.tool_message)
                         )

From ee049999cbf458ff542751463e1c53561d6d6462 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Mon, 13 Apr 2026 20:28:06 +0800
Subject: [PATCH 41/70] docs: add enterprise A2A feature doc and update OSS A2A
 docs

---
 docs/docs.json                         |  30 ++--
 docs/en/enterprise/features/a2a.mdx    | 227 +++++++++++++++++++++++++
 docs/en/learn/a2a-agent-delegation.mdx |  80 ++++++---
 3 files changed, 307 insertions(+), 30 deletions(-)
 create mode 100644 docs/en/enterprise/features/a2a.mdx

diff --git a/docs/docs.json b/docs/docs.json
index c175143ba..3f37157df 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -392,7 +392,8 @@
                       "en/enterprise/features/marketplace",
                       "en/enterprise/features/agent-repositories",
                       "en/enterprise/features/tools-and-integrations",
-                      "en/enterprise/features/pii-trace-redactions"
+                      "en/enterprise/features/pii-trace-redactions",
+                      "en/enterprise/features/a2a"
                     ]
                   },
                   {
@@ -865,7 +866,8 @@
                       "en/enterprise/features/marketplace",
                       "en/enterprise/features/agent-repositories",
                       "en/enterprise/features/tools-and-integrations",
-                      "en/enterprise/features/pii-trace-redactions"
+                      "en/enterprise/features/pii-trace-redactions",
+                      "en/enterprise/features/a2a"
                     ]
                   },
                   {
@@ -1338,7 +1340,8 @@
                       "en/enterprise/features/marketplace",
                       "en/enterprise/features/agent-repositories",
                       "en/enterprise/features/tools-and-integrations",
-                      "en/enterprise/features/pii-trace-redactions"
+                      "en/enterprise/features/pii-trace-redactions",
+                      "en/enterprise/features/a2a"
                     ]
                   },
                   {
@@ -1811,7 +1814,8 @@
                       "en/enterprise/features/marketplace",
                       "en/enterprise/features/agent-repositories",
                       "en/enterprise/features/tools-and-integrations",
-                      "en/enterprise/features/pii-trace-redactions"
+                      "en/enterprise/features/pii-trace-redactions",
+                      "en/enterprise/features/a2a"
                     ]
                   },
                   {
@@ -2283,7 +2287,8 @@
                       "en/enterprise/features/marketplace",
                       "en/enterprise/features/agent-repositories",
                       "en/enterprise/features/tools-and-integrations",
-                      "en/enterprise/features/pii-trace-redactions"
+                      "en/enterprise/features/pii-trace-redactions",
+                      "en/enterprise/features/a2a"
                     ]
                   },
                   {
@@ -2754,7 +2759,8 @@
                       "en/enterprise/features/marketplace",
                       "en/enterprise/features/agent-repositories",
                       "en/enterprise/features/tools-and-integrations",
-                      "en/enterprise/features/pii-trace-redactions"
+                      "en/enterprise/features/pii-trace-redactions",
+                      "en/enterprise/features/a2a"
                     ]
                   },
                   {
@@ -3225,7 +3231,8 @@
                       "en/enterprise/features/marketplace",
                       "en/enterprise/features/agent-repositories",
                       "en/enterprise/features/tools-and-integrations",
-                      "en/enterprise/features/pii-trace-redactions"
+                      "en/enterprise/features/pii-trace-redactions",
+                      "en/enterprise/features/a2a"
                     ]
                   },
                   {
@@ -3698,7 +3705,8 @@
                       "en/enterprise/features/marketplace",
                       "en/enterprise/features/agent-repositories",
                       "en/enterprise/features/tools-and-integrations",
-                      "en/enterprise/features/pii-trace-redactions"
+                      "en/enterprise/features/pii-trace-redactions",
+                      "en/enterprise/features/a2a"
                     ]
                   },
                   {
@@ -4169,7 +4177,8 @@
                       "en/enterprise/features/marketplace",
                       "en/enterprise/features/agent-repositories",
                       "en/enterprise/features/tools-and-integrations",
-                      "en/enterprise/features/pii-trace-redactions"
+                      "en/enterprise/features/pii-trace-redactions",
+                      "en/enterprise/features/a2a"
                     ]
                   },
                   {
@@ -4643,7 +4652,8 @@
                       "en/enterprise/features/marketplace",
                       "en/enterprise/features/agent-repositories",
                       "en/enterprise/features/tools-and-integrations",
-                      "en/enterprise/features/pii-trace-redactions"
+                      "en/enterprise/features/pii-trace-redactions",
+                      "en/enterprise/features/a2a"
                     ]
                   },
                   {
diff --git a/docs/en/enterprise/features/a2a.mdx b/docs/en/enterprise/features/a2a.mdx
new file mode 100644
index 000000000..0518743f4
--- /dev/null
+++ b/docs/en/enterprise/features/a2a.mdx
@@ -0,0 +1,227 @@
+---
+title: A2A on AMP
+description: Production-grade Agent-to-Agent communication with distributed state, multi-scheme authentication, and horizontal scaling
+icon: "network-wired"
+mode: "wide"
+---
+
+<Warning>
+A2A server agents on AMP are in early release. APIs may change in future versions.
+</Warning>
+
+## Overview
+
+CrewAI AMP extends the open-source [A2A protocol implementation](/en/learn/a2a-agent-delegation) with production infrastructure for deploying distributed agents at scale. AMP supports A2A protocol versions 0.2 and 0.3. When you deploy a crew or agent with A2A server configuration to AMP, the platform automatically provisions distributed state management, authentication, multi-transport endpoints, and lifecycle management.
+
+<Note>
+  For A2A protocol fundamentals, client/server configuration, and authentication schemes, see the [A2A Agent Delegation](/en/learn/a2a-agent-delegation) documentation. This page covers what AMP adds on top of the open-source implementation.
+</Note>
+
+### Usage
+
+Add `A2AServerConfig` to any agent in your crew and deploy to AMP. The platform detects agents with server configuration and automatically registers A2A endpoints, generates agent cards, and provisions the infrastructure described below.
+
+```python
+from crewai import Agent, Crew, Task
+from crewai.a2a import A2AServerConfig
+from crewai.a2a.auth import EnterpriseTokenAuth
+
+agent = Agent(
+    role="Data Analyst",
+    goal="Analyze datasets and provide insights",
+    backstory="Expert data scientist with statistical analysis skills",
+    llm="gpt-4o",
+    a2a=A2AServerConfig(
+        auth=EnterpriseTokenAuth()
+    )
+)
+
+task = Task(
+    description="Analyze the provided dataset",
+    expected_output="Statistical summary with key insights",
+    agent=agent
+)
+
+crew = Crew(agents=[agent], tasks=[task])
+```
+
+After [deploying to AMP](/en/enterprise/guides/deploy-to-amp), the platform registers two levels of A2A endpoints:
+
+- **Crew-level**: an aggregate agent card at `/.well-known/agent-card.json` where each agent with `A2AServerConfig` is listed as a skill, with a JSON-RPC endpoint at `/a2a`
+- **Per-agent**: isolated agent cards and JSON-RPC endpoints mounted at `/a2a/agents/{role}/`, each with its own tenancy
+
+Clients can interact with the crew as a whole or target a specific agent directly. To route a request to a specific agent through the crew-level endpoint, include `"target_agent"` in the message metadata with the agent's slugified role name (e.g., `"data-analyst"` for an agent with role `"Data Analyst"`). If no `target_agent` is provided, the request is handled by the first agent in the crew.
+
+See [A2A Agent Delegation](/en/learn/a2a-agent-delegation#server-configuration-options) for the full list of `A2AServerConfig` options.
+
+<Warning>
+  Per the A2A protocol, agent cards are publicly accessible to enable discovery. This includes both the crew-level card at `/.well-known/agent-card.json` and per-agent cards at `/a2a/agents/{role}/.well-known/agent-card.json`. Do not include sensitive information in agent names, descriptions, or skill definitions.
+</Warning>
+
+### File Inputs and Structured Output
+
+A2A on AMP supports passing files and requesting structured output in both directions. Clients can send files as `FilePart`s and request structured responses by embedding a JSON schema in the message. Server agents receive files as `input_files` on the task, and return structured data as `DataPart`s when a schema is provided. See [File Inputs and Structured Output](/en/learn/a2a-agent-delegation#file-inputs-and-structured-output) for details.
+
+### What AMP Adds
+
+<CardGroup cols={2}>
+  <Card title="Distributed State" icon="database">
+    Persistent task, context, and result storage that supports horizontal scaling
+  </Card>
+  <Card title="Enterprise Authentication" icon="shield-halved">
+    OIDC, OAuth2, mTLS, and Enterprise token validation beyond simple bearer tokens
+  </Card>
+  <Card title="gRPC Transport" icon="bolt">
+    Full gRPC server with TLS and authentication
+  </Card>
+  <Card title="Context Lifecycle" icon="clock-rotate-left">
+    Automatic idle detection, expiration, and cleanup of long-running conversations
+  </Card>
+  <Card title="Signed Webhooks" icon="signature">
+    HMAC-SHA256 signed push notifications with replay protection
+  </Card>
+  <Card title="Multi-Transport" icon="arrows-split-up-and-left">
+    REST, JSON-RPC, and gRPC endpoints served simultaneously from a single deployment
+  </Card>
+</CardGroup>
+
+---
+
+## Distributed State Management
+
+In the open-source implementation, task and context state lives in memory on a single process. AMP replaces this with persistent, distributed stores that enable horizontal scaling.
+
+### Storage Layers
+
+| Store | Purpose |
+|---|---|
+| **Task Store** | Persists A2A task state and metadata |
+| **Context Store** | Tracks conversation context, creation time, last activity, and associated tasks |
+| **Result Store** | Caches task results for retrieval |
+| **Push Config Store** | Manages webhook subscriptions per task |
+
+Multiple A2A deployments are automatically isolated from each other, preventing data collisions when sharing infrastructure.
+
+---
+
+## Enterprise Authentication
+
+AMP supports six authentication schemes for incoming A2A requests, configurable per deployment. Authentication works across both HTTP and gRPC transports.
+
+| Scheme | Description | Use Case |
+|---|---|---|
+| **SimpleTokenAuth** | Static bearer token from `AUTH_TOKEN` env var | Development, simple deployments |
+| **EnterpriseTokenAuth** | Token verification via CrewAI PlusAPI with integration token claims | AMP-to-AMP agent communication |
+| **OIDCAuth** | OpenID Connect JWT validation with JWKS endpoint caching | Enterprise SSO integration |
+| **OAuth2ServerAuth** | OAuth2 with configurable scopes | Fine-grained access control |
+| **APIKeyServerAuth** | API key validation via header or query parameter | Third-party integrations |
+| **MTLSServerAuth** | Mutual TLS certificate-based authentication | Zero-trust environments |
+
+The configured auth scheme automatically populates the agent card's `securitySchemes` and `security` fields. Clients discover authentication requirements by fetching the agent card before making requests.
+
+---
+
+## Extended Agent Cards
+
+AMP supports role-based skill visibility through extended agent cards. Unauthenticated users see the standard agent card with public skills. Authenticated users receive an extended card with additional capabilities.
+
+This enables patterns like:
+- Public agents that expose basic skills to anyone, with advanced skills available to authenticated clients
+- Internal agents that advertise different capabilities based on the caller's identity
+
+---
+
+## gRPC Transport
+
+If enabled, AMP provides full gRPC support alongside the default JSON-RPC transport.
+
+- **TLS termination** with configurable certificate and key paths
+- **gRPC reflection** for debugging with tools like `grpcurl`
+- **Authentication** using the same schemes available for HTTP
+- **Extension validation** ensuring clients support required protocol extensions
+- **Version negotiation** across A2A protocol versions 0.2 and 0.3
+
+For deployments exposing multiple agents, AMP automatically allocates per-agent gRPC ports and coordinates TLS, startup, and shutdown across all servers.
+
+---
+
+## Context Lifecycle Management
+
+AMP tracks the lifecycle of A2A conversation contexts and automatically manages cleanup.
+
+### Lifecycle States
+
+| State | Condition | Action |
+|---|---|---|
+| **Active** | Context has recent activity | None |
+| **Idle** | No activity for a configured period | Marked idle, event emitted |
+| **Expired** | Context exceeds its maximum lifetime | Marked expired, associated tasks cleaned up, event emitted |
+
+A background cleanup task runs hourly to scan for idle and expired contexts. All state transitions emit CrewAI events that integrate with the platform's observability features.
+
+---
+
+## Signed Push Notifications
+
+When an A2A agent sends push notifications to a client webhook, AMP signs each request with HMAC-SHA256 to ensure integrity and prevent tampering.
+
+### Signature Headers
+
+| Header | Purpose |
+|---|---|
+| `X-A2A-Signature` | HMAC-SHA256 signature in `sha256={hex_digest}` format |
+| `X-A2A-Signature-Timestamp` | Unix timestamp bound to the signature |
+| `X-A2A-Notification-Token` | Optional notification auth token |
+
+### Security Properties
+
+- **Integrity**: payload cannot be modified without invalidating the signature
+- **Replay protection**: signatures are timestamp-bound with a configurable tolerance window
+- **Retry with backoff**: failed deliveries retry with exponential backoff
+
+---
+
+## Distributed Event Streaming
+
+In the open-source implementation, SSE streaming works within a single process. AMP propagates SSE events across instances so that clients receive updates even when the instance holding the streaming connection differs from the instance executing the task.
+
+---
+
+## Multi-Transport Endpoints
+
+AMP serves REST and JSON-RPC by default. gRPC is available as an additional transport if enabled.
+
+| Transport | Path Convention | Description |
+|---|---|---|
+| **REST** | `/v1/message:send`, `/v1/message:stream`, `/v1/tasks` | Google API conventions |
+| **JSON-RPC** | Standard A2A JSON-RPC endpoint | Default A2A protocol transport |
+| **gRPC** | Per-agent port allocation | Optional, high-performance binary protocol |
+
+All active transports share the same authentication, version negotiation, and extension validation. Agent cards are generated from agent and crew metadata — roles, goals, and tools become skills and descriptions — and automatically include interfaces for each active transport. They can also be manually configured via `A2AServerConfig`.
+
+---
+
+## Version and Extension Negotiation
+
+AMP validates A2A protocol versions and extensions at the transport layer.
+
+### Version Negotiation
+
+- Clients send the `A2A-Version` header with their preferred version
+- AMP validates against supported versions (0.2, 0.3) and falls back to 0.3 if unspecified
+- The negotiated version is returned in the response headers
+
+### Extension Validation
+
+- Clients declare supported extensions via the `X-A2A-Extensions` header
+- AMP validates that clients support all extensions the agent requires
+- Requests from clients missing required extensions receive an `UnsupportedExtensionError`
+
+---
+
+## Next Steps
+
+- [A2A Agent Delegation](/en/learn/a2a-agent-delegation) — A2A protocol fundamentals and configuration
+- [A2UI](/en/learn/a2ui) — Interactive UI rendering over A2A
+- [Deploy to AMP](/en/enterprise/guides/deploy-to-amp) — General deployment guide
+- [Webhook Streaming](/en/enterprise/features/webhook-streaming) — Event streaming for deployed automations
diff --git a/docs/en/learn/a2a-agent-delegation.mdx b/docs/en/learn/a2a-agent-delegation.mdx
index 942ca8bd0..4918e8754 100644
--- a/docs/en/learn/a2a-agent-delegation.mdx
+++ b/docs/en/learn/a2a-agent-delegation.mdx
@@ -7,6 +7,10 @@ mode: "wide"
 
 ## A2A Agent Delegation
 
+<Info>
+  Deploying A2A agents to production? See [A2A on AMP](/en/enterprise/features/a2a) for distributed state, enterprise authentication, gRPC transport, and horizontal scaling.
+</Info>
+
 CrewAI treats [A2A protocol](https://a2a-protocol.org/latest/) as a first-class delegation primitive, enabling agents to delegate tasks, request information, and collaborate with remote agents, as well as act as A2A-compliant server agents.
 In client mode, agents autonomously choose between local execution and remote delegation based on task requirements.
 
@@ -96,24 +100,28 @@ The `A2AClientConfig` class accepts the following parameters:
   Update mechanism for receiving task status. Options: `StreamingConfig`, `PollingConfig`, or `PushNotificationConfig`.
 </ParamField>
 
-<ParamField path="transport_protocol" type="Literal['JSONRPC', 'GRPC', 'HTTP+JSON']" default="JSONRPC">
-  Transport protocol for A2A communication. Options: `JSONRPC` (default), `GRPC`, or `HTTP+JSON`.
-</ParamField>
-
 <ParamField path="accepted_output_modes" type="list[str]" default='["application/json"]'>
   Media types the client can accept in responses.
 </ParamField>
 
-<ParamField path="supported_transports" type="list[str]" default='["JSONRPC"]'>
-  Ordered list of transport protocols the client supports.
-</ParamField>
-
-<ParamField path="use_client_preference" type="bool" default="False">
-  Whether to prioritize client transport preferences over server.
-</ParamField>
-
 <ParamField path="extensions" type="list[str]" default="[]">
-  Extension URIs the client supports.
+  A2A protocol extension URIs the client supports.
+</ParamField>
+
+<ParamField path="client_extensions" type="list[A2AExtension]" default="[]">
+  Client-side processing hooks for tool injection, prompt augmentation, and response modification.
+</ParamField>
+
+<ParamField path="transport" type="ClientTransportConfig" default="ClientTransportConfig()">
+  Transport configuration including preferred transport, supported transports for negotiation, and protocol-specific settings (gRPC message sizes, keepalive, etc.).
+</ParamField>
+
+<ParamField path="transport_protocol" type="Literal['JSONRPC', 'GRPC', 'HTTP+JSON']" default="None">
+  **Deprecated**: Use `transport=ClientTransportConfig(preferred=...)` instead.
+</ParamField>
+
+<ParamField path="supported_transports" type="list[str]" default="None">
+  **Deprecated**: Use `transport=ClientTransportConfig(supported=...)` instead.
 </ParamField>
 
 ## Authentication
@@ -405,11 +413,7 @@ agent = Agent(
   Preferred endpoint URL. If set, overrides the URL passed to `to_agent_card()`.
 </ParamField>
 
-<ParamField path="preferred_transport" type="Literal['JSONRPC', 'GRPC', 'HTTP+JSON']" default="JSONRPC">
-  Transport protocol for the preferred endpoint.
-</ParamField>
-
-<ParamField path="protocol_version" type="str" default="0.3">
+<ParamField path="protocol_version" type="str" default="0.3.0">
   A2A protocol version this agent supports.
 </ParamField>
 
@@ -441,8 +445,36 @@ agent = Agent(
   Whether agent provides extended card to authenticated users.
 </ParamField>
 
-<ParamField path="signatures" type="list[AgentCardSignature]" default="[]">
-  JSON Web Signatures for the AgentCard.
+<ParamField path="extended_skills" type="list[AgentSkill]" default="[]">
+  Additional skills visible only to authenticated users in the extended agent card.
+</ParamField>
+
+<ParamField path="signing_config" type="AgentCardSigningConfig" default="None">
+  Configuration for signing the AgentCard with JWS. Supports RS256, ES256, PS256, and related algorithms.
+</ParamField>
+
+<ParamField path="server_extensions" type="list[ServerExtension]" default="[]">
+  Server-side A2A protocol extensions with `on_request`/`on_response` hooks that modify agent behavior.
+</ParamField>
+
+<ParamField path="push_notifications" type="ServerPushNotificationConfig" default="None">
+  Configuration for outgoing push notifications, including HMAC-SHA256 signing secret.
+</ParamField>
+
+<ParamField path="transport" type="ServerTransportConfig" default="ServerTransportConfig()">
+  Transport configuration including preferred transport, gRPC server settings, JSON-RPC paths, and HTTP+JSON settings.
+</ParamField>
+
+<ParamField path="auth" type="ServerAuthScheme" default="None">
+  Authentication scheme for incoming A2A requests. Defaults to `SimpleTokenAuth` using the `AUTH_TOKEN` environment variable.
+</ParamField>
+
+<ParamField path="preferred_transport" type="Literal['JSONRPC', 'GRPC', 'HTTP+JSON']" default="None">
+  **Deprecated**: Use `transport=ServerTransportConfig(preferred=...)` instead.
+</ParamField>
+
+<ParamField path="signatures" type="list[AgentCardSignature]" default="None">
+  **Deprecated**: Use `signing_config=AgentCardSigningConfig(...)` instead.
 </ParamField>
 
 ### Combined Client and Server
@@ -468,6 +500,14 @@ agent = Agent(
 )
 ```
 
+### File Inputs and Structured Output
+
+A2A supports passing files and requesting structured output in both directions.
+
+**Client side**: When delegating to a remote A2A agent, files from the task's `input_files` are sent as `FilePart`s in the outgoing message. If `response_model` is set on the `A2AClientConfig`, the Pydantic model's JSON schema is embedded in the message metadata, requesting structured output from the remote agent.
+
+**Server side**: Incoming `FilePart`s are extracted and passed to the agent's task as `input_files`. If the client included a JSON schema, the server creates a response model from it and applies it to the task. When the agent returns structured data, the response is sent back as a `DataPart` rather than plain text.
+
 ## Best Practices
 
 <CardGroup cols={2}>

From a4e7b322c56374fa005598ec10faad26689a03b1 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Mon, 13 Apr 2026 20:53:31 +0800
Subject: [PATCH 42/70] docs: clean up enterprise A2A language

---
 docs/en/enterprise/features/a2a.mdx | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/en/enterprise/features/a2a.mdx b/docs/en/enterprise/features/a2a.mdx
index 0518743f4..e66cbe340 100644
--- a/docs/en/enterprise/features/a2a.mdx
+++ b/docs/en/enterprise/features/a2a.mdx
@@ -1,6 +1,6 @@
 ---
 title: A2A on AMP
-description: Production-grade Agent-to-Agent communication with distributed state, multi-scheme authentication, and horizontal scaling
+description: Production-grade Agent-to-Agent communication with distributed state and multi-scheme authentication
 icon: "network-wired"
 mode: "wide"
 ---
@@ -66,7 +66,7 @@ A2A on AMP supports passing files and requesting structured output in both direc
 
 <CardGroup cols={2}>
   <Card title="Distributed State" icon="database">
-    Persistent task, context, and result storage that supports horizontal scaling
+    Persistent task, context, and result storage
   </Card>
   <Card title="Enterprise Authentication" icon="shield-halved">
     OIDC, OAuth2, mTLS, and Enterprise token validation beyond simple bearer tokens
@@ -89,7 +89,7 @@ A2A on AMP supports passing files and requesting structured output in both direc
 
 ## Distributed State Management
 
-In the open-source implementation, task and context state lives in memory on a single process. AMP replaces this with persistent, distributed stores that enable horizontal scaling.
+In the open-source implementation, task and context state lives in memory on a single process. AMP replaces this with persistent, distributed stores.
 
 ### Storage Layers
 

From c8694fbed27343901eea6a68e3efc68a8d1e9f88 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Mon, 13 Apr 2026 21:04:37 +0800
Subject: [PATCH 43/70] fix: override pypdf and uv to patched versions for
 CVE-2026-40260 and GHSA-pjjw-68hj-v9mw

---
 pyproject.toml | 6 +++++-
 uv.lock        | 5 ++++-
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index c26cf048a..0a4303370 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -162,7 +162,7 @@ info = "Commits must follow Conventional Commits 1.0.0."
 
 
 [tool.uv]
-exclude-newer = "2026-04-10"  # pinned for CVE-2026-39892; restore to "3 days" after 2026-04-11
+exclude-newer = "3 days"
 
 # composio-core pins rich<14 but textual requires rich>=14.
 # onnxruntime 1.24+ dropped Python 3.10 wheels; cap it so qdrant[fastembed] resolves on 3.10.
@@ -170,6 +170,8 @@ exclude-newer = "2026-04-10"  # pinned for CVE-2026-39892; restore to "3 days" a
 # langchain-core <1.2.28 has GHSA-926x-3r5x-gfhw (incomplete f-string validation).
 # transformers 4.57.6 has CVE-2026-1839; force 5.4+ (docling 2.84 allows huggingface-hub>=1).
 # cryptography 46.0.6 has CVE-2026-39892; force 46.0.7+.
+# pypdf <6.10.0 has CVE-2026-40260; force 6.10.0+.
+# uv <0.11.6 has GHSA-pjjw-68hj-v9mw; force 0.11.6+.
 override-dependencies = [
     "rich>=13.7.1",
     "onnxruntime<1.24; python_version < '3.11'",
@@ -178,6 +180,8 @@ override-dependencies = [
     "urllib3>=2.6.3",
     "transformers>=5.4.0; python_version >= '3.10'",
     "cryptography>=46.0.7",
+    "pypdf>=6.10.0,<7",
+    "uv>=0.11.6,<1",
 ]
 
 [tool.uv.workspace]
diff --git a/uv.lock b/uv.lock
index 714d04b61..756e39b90 100644
--- a/uv.lock
+++ b/uv.lock
@@ -13,7 +13,8 @@ resolution-markers = [
 ]
 
 [options]
-exclude-newer = "2026-04-10T16:00:00Z"
+exclude-newer = "2026-04-10T12:25:00.712108Z"
+exclude-newer-span = "P3D"
 
 [manifest]
 members = [
@@ -27,9 +28,11 @@ overrides = [
     { name = "langchain-core", specifier = ">=1.2.28,<2" },
     { name = "onnxruntime", marker = "python_full_version < '3.11'", specifier = "<1.24" },
     { name = "pillow", specifier = ">=12.1.1" },
+    { name = "pypdf", specifier = ">=6.10.0,<7" },
     { name = "rich", specifier = ">=13.7.1" },
     { name = "transformers", marker = "python_full_version >= '3.10'", specifier = ">=5.4.0" },
     { name = "urllib3", specifier = ">=2.6.3" },
+    { name = "uv", specifier = ">=0.11.6,<1" },
 ]
 
 [manifest.dependency-groups]

From 0b0521b31513c7e5185c95a0cf077e3bd6bec7fa Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Mon, 13 Apr 2026 21:21:18 +0800
Subject: [PATCH 44/70] chore: improve typing in task module

---
 lib/crewai/src/crewai/llm.py  | 161 ++++++++++++++++++++--------------
 lib/crewai/src/crewai/task.py |  28 +++---
 2 files changed, 109 insertions(+), 80 deletions(-)

diff --git a/lib/crewai/src/crewai/llm.py b/lib/crewai/src/crewai/llm.py
index e6f5cc68b..db126954e 100644
--- a/lib/crewai/src/crewai/llm.py
+++ b/lib/crewai/src/crewai/llm.py
@@ -51,6 +51,7 @@ from crewai.utilities.exceptions.context_window_exceeding_exception import (
 )
 from crewai.utilities.logger_utils import suppress_warnings
 from crewai.utilities.string_utils import sanitize_tool_name
+from crewai.utilities.token_counter_callback import TokenCalcHandler
 
 
 try:
@@ -75,8 +76,13 @@ try:
     from litellm.types.utils import (
         ChatCompletionDeltaToolCall,
         Choices,
+        Delta as LiteLLMDelta,
         Function,
+        Message,
         ModelResponse,
+        ModelResponseBase,
+        ModelResponseStream,
+        StreamingChoices as LiteLLMStreamingChoices,
     )
     from litellm.utils import supports_response_schema
 
@@ -85,6 +91,11 @@ except ImportError:
     LITELLM_AVAILABLE = False
     litellm = None  # type: ignore[assignment]
     Choices = None  # type: ignore[assignment, misc]
+    LiteLLMDelta = None  # type: ignore[assignment, misc]
+    Message = None  # type: ignore[assignment, misc]
+    ModelResponseBase = None  # type: ignore[assignment, misc]
+    ModelResponseStream = None  # type: ignore[assignment, misc]
+    LiteLLMStreamingChoices = None  # type: ignore[assignment, misc]
     get_supported_openai_params = None  # type: ignore[assignment]
     ChatCompletionDeltaToolCall = None  # type: ignore[assignment, misc]
     Function = None  # type: ignore[assignment, misc]
@@ -709,7 +720,7 @@ class LLM(BaseLLM):
                 chunk_content = None
                 response_id = None
 
-                if hasattr(chunk, "id"):
+                if isinstance(chunk, ModelResponseBase):
                     response_id = chunk.id
 
                 # Safely extract content from various chunk formats
@@ -718,18 +729,16 @@ class LLM(BaseLLM):
                     choices = None
                     if isinstance(chunk, dict) and "choices" in chunk:
                         choices = chunk["choices"]
-                    elif hasattr(chunk, "choices"):
-                        # Check if choices is not a type but an actual attribute with value
-                        if not isinstance(chunk.choices, type):
-                            choices = chunk.choices
+                    elif isinstance(chunk, ModelResponseStream):
+                        choices = chunk.choices
 
                     # Try to extract usage information if available
+                    # NOTE: usage is a pydantic extra field on ModelResponseBase,
+                    # so it must be accessed via model_extra.
                     if isinstance(chunk, dict) and "usage" in chunk:
                         usage_info = chunk["usage"]
-                    elif hasattr(chunk, "usage"):
-                        # Check if usage is not a type but an actual attribute with value
-                        if not isinstance(chunk.usage, type):
-                            usage_info = chunk.usage
+                    elif isinstance(chunk, ModelResponseBase) and chunk.model_extra:
+                        usage_info = chunk.model_extra.get("usage") or usage_info
 
                     if choices and len(choices) > 0:
                         choice = choices[0]
@@ -738,7 +747,7 @@ class LLM(BaseLLM):
                         delta = None
                         if isinstance(choice, dict) and "delta" in choice:
                             delta = choice["delta"]
-                        elif hasattr(choice, "delta"):
+                        elif isinstance(choice, LiteLLMStreamingChoices):
                             delta = choice.delta
 
                         # Extract content from delta
@@ -748,7 +757,7 @@ class LLM(BaseLLM):
                                 if "content" in delta and delta["content"] is not None:
                                     chunk_content = delta["content"]
                             # Handle object format
-                            elif hasattr(delta, "content"):
+                            elif isinstance(delta, LiteLLMDelta):
                                 chunk_content = delta.content
 
                             # Handle case where content might be None or empty
@@ -821,9 +830,8 @@ class LLM(BaseLLM):
                         choices = None
                         if isinstance(last_chunk, dict) and "choices" in last_chunk:
                             choices = last_chunk["choices"]
-                        elif hasattr(last_chunk, "choices"):
-                            if not isinstance(last_chunk.choices, type):
-                                choices = last_chunk.choices
+                        elif isinstance(last_chunk, ModelResponseStream):
+                            choices = last_chunk.choices
 
                         if choices and len(choices) > 0:
                             choice = choices[0]
@@ -832,14 +840,14 @@ class LLM(BaseLLM):
                             message = None
                             if isinstance(choice, dict) and "message" in choice:
                                 message = choice["message"]
-                            elif hasattr(choice, "message"):
+                            elif isinstance(choice, Choices):
                                 message = choice.message
 
                             if message:
                                 content = None
                                 if isinstance(message, dict) and "content" in message:
                                     content = message["content"]
-                                elif hasattr(message, "content"):
+                                elif isinstance(message, Message):
                                     content = message.content
 
                                 if content:
@@ -866,24 +874,23 @@ class LLM(BaseLLM):
                     choices = None
                     if isinstance(last_chunk, dict) and "choices" in last_chunk:
                         choices = last_chunk["choices"]
-                    elif hasattr(last_chunk, "choices"):
-                        if not isinstance(last_chunk.choices, type):
-                            choices = last_chunk.choices
+                    elif isinstance(last_chunk, ModelResponseStream):
+                        choices = last_chunk.choices
 
                     if choices and len(choices) > 0:
                         choice = choices[0]
 
-                        message = None
-                        if isinstance(choice, dict) and "message" in choice:
-                            message = choice["message"]
-                        elif hasattr(choice, "message"):
-                            message = choice.message
+                        delta = None
+                        if isinstance(choice, dict) and "delta" in choice:
+                            delta = choice["delta"]
+                        elif isinstance(choice, LiteLLMStreamingChoices):
+                            delta = choice.delta
 
-                        if message:
-                            if isinstance(message, dict) and "tool_calls" in message:
-                                tool_calls = message["tool_calls"]
-                            elif hasattr(message, "tool_calls"):
-                                tool_calls = message.tool_calls
+                        if delta:
+                            if isinstance(delta, dict) and "tool_calls" in delta:
+                                tool_calls = delta["tool_calls"]
+                            elif isinstance(delta, LiteLLMDelta):
+                                tool_calls = delta.tool_calls
             except Exception as e:
                 logging.debug(f"Error checking for tool calls: {e}")
 
@@ -1037,7 +1044,7 @@ class LLM(BaseLLM):
         """
         if callbacks and len(callbacks) > 0:
             for callback in callbacks:
-                if hasattr(callback, "log_success_event"):
+                if isinstance(callback, TokenCalcHandler):
                     # Use the usage_info we've been tracking
                     if not usage_info:
                         # Try to get usage from the last chunk if we haven't already
@@ -1048,9 +1055,14 @@ class LLM(BaseLLM):
                                     and "usage" in last_chunk
                                 ):
                                     usage_info = last_chunk["usage"]
-                                elif hasattr(last_chunk, "usage"):
-                                    if not isinstance(last_chunk.usage, type):
-                                        usage_info = last_chunk.usage
+                                elif (
+                                    isinstance(last_chunk, ModelResponseBase)
+                                    and last_chunk.model_extra
+                                ):
+                                    usage_info = (
+                                        last_chunk.model_extra.get("usage")
+                                        or usage_info
+                                    )
                         except Exception as e:
                             logging.debug(f"Error extracting usage info: {e}")
 
@@ -1123,13 +1135,10 @@ class LLM(BaseLLM):
                 params["response_model"] = response_model
             response = litellm.completion(**params)
 
-            if (
-                hasattr(response, "usage")
-                and not isinstance(response.usage, type)
-                and response.usage
-            ):
-                usage_info = response.usage
-                self._track_token_usage_internal(usage_info)
+            if isinstance(response, ModelResponseBase) and response.model_extra:
+                usage_info = response.model_extra.get("usage")
+                if usage_info:
+                    self._track_token_usage_internal(usage_info)
 
         except LLMContextLengthExceededError:
             # Re-raise our own context length error
@@ -1141,7 +1150,11 @@ class LLM(BaseLLM):
                 raise LLMContextLengthExceededError(error_msg) from e
             raise
 
-        response_usage = self._usage_to_dict(getattr(response, "usage", None))
+        response_usage = self._usage_to_dict(
+            response.model_extra.get("usage")
+            if isinstance(response, ModelResponseBase) and response.model_extra
+            else None
+        )
 
         # --- 2) Handle structured output response (when response_model is provided)
         if response_model is not None:
@@ -1166,8 +1179,13 @@ class LLM(BaseLLM):
         # --- 3) Handle callbacks with usage info
         if callbacks and len(callbacks) > 0:
             for callback in callbacks:
-                if hasattr(callback, "log_success_event"):
-                    usage_info = getattr(response, "usage", None)
+                if isinstance(callback, TokenCalcHandler):
+                    usage_info = (
+                        response.model_extra.get("usage")
+                        if isinstance(response, ModelResponseBase)
+                        and response.model_extra
+                        else None
+                    )
                     if usage_info:
                         callback.log_success_event(
                             kwargs=params,
@@ -1176,7 +1194,7 @@ class LLM(BaseLLM):
                             end_time=0,
                         )
         # --- 4) Check for tool calls
-        tool_calls = getattr(response_message, "tool_calls", [])
+        tool_calls = response_message.tool_calls or []
 
         # --- 5) If no tool calls or no available functions, return the text response directly as long as there is a text response
         if (not tool_calls or not available_functions) and text_response:
@@ -1269,13 +1287,10 @@ class LLM(BaseLLM):
                 params["response_model"] = response_model
             response = await litellm.acompletion(**params)
 
-            if (
-                hasattr(response, "usage")
-                and not isinstance(response.usage, type)
-                and response.usage
-            ):
-                usage_info = response.usage
-                self._track_token_usage_internal(usage_info)
+            if isinstance(response, ModelResponseBase) and response.model_extra:
+                usage_info = response.model_extra.get("usage")
+                if usage_info:
+                    self._track_token_usage_internal(usage_info)
 
         except LLMContextLengthExceededError:
             # Re-raise our own context length error
@@ -1287,7 +1302,11 @@ class LLM(BaseLLM):
                 raise LLMContextLengthExceededError(error_msg) from e
             raise
 
-        response_usage = self._usage_to_dict(getattr(response, "usage", None))
+        response_usage = self._usage_to_dict(
+            response.model_extra.get("usage")
+            if isinstance(response, ModelResponseBase) and response.model_extra
+            else None
+        )
 
         if response_model is not None:
             if isinstance(response, BaseModel):
@@ -1309,8 +1328,13 @@ class LLM(BaseLLM):
 
         if callbacks and len(callbacks) > 0:
             for callback in callbacks:
-                if hasattr(callback, "log_success_event"):
-                    usage_info = getattr(response, "usage", None)
+                if isinstance(callback, TokenCalcHandler):
+                    usage_info = (
+                        response.model_extra.get("usage")
+                        if isinstance(response, ModelResponseBase)
+                        and response.model_extra
+                        else None
+                    )
                     if usage_info:
                         callback.log_success_event(
                             kwargs=params,
@@ -1319,7 +1343,7 @@ class LLM(BaseLLM):
                             end_time=0,
                         )
 
-        tool_calls = getattr(response_message, "tool_calls", [])
+        tool_calls = response_message.tool_calls or []
 
         if (not tool_calls or not available_functions) and text_response:
             self._handle_emit_call_events(
@@ -1394,18 +1418,19 @@ class LLM(BaseLLM):
             async for chunk in await litellm.acompletion(**params):
                 chunk_count += 1
                 chunk_content = None
-                response_id = chunk.id if hasattr(chunk, "id") else None
+                response_id = chunk.id if isinstance(chunk, ModelResponseBase) else None
 
                 try:
                     choices = None
                     if isinstance(chunk, dict) and "choices" in chunk:
                         choices = chunk["choices"]
-                    elif hasattr(chunk, "choices"):
-                        if not isinstance(chunk.choices, type):
-                            choices = chunk.choices
+                    elif isinstance(chunk, ModelResponseStream):
+                        choices = chunk.choices
 
-                    if hasattr(chunk, "usage") and chunk.usage is not None:
-                        usage_info = chunk.usage
+                    if isinstance(chunk, ModelResponseBase) and chunk.model_extra:
+                        chunk_usage = chunk.model_extra.get("usage")
+                        if chunk_usage is not None:
+                            usage_info = chunk_usage
 
                     if choices and len(choices) > 0:
                         first_choice = choices[0]
@@ -1413,19 +1438,19 @@ class LLM(BaseLLM):
 
                         if isinstance(first_choice, dict):
                             delta = first_choice.get("delta", {})
-                        elif hasattr(first_choice, "delta"):
+                        elif isinstance(first_choice, LiteLLMStreamingChoices):
                             delta = first_choice.delta
 
                         if delta:
                             if isinstance(delta, dict):
                                 chunk_content = delta.get("content")
-                            elif hasattr(delta, "content"):
+                            elif isinstance(delta, LiteLLMDelta):
                                 chunk_content = delta.content
 
                             tool_calls: list[ChatCompletionDeltaToolCall] | None = None
                             if isinstance(delta, dict):
                                 tool_calls = delta.get("tool_calls")
-                            elif hasattr(delta, "tool_calls"):
+                            elif isinstance(delta, LiteLLMDelta):
                                 tool_calls = delta.tool_calls
 
                             if tool_calls:
@@ -1461,7 +1486,7 @@ class LLM(BaseLLM):
 
             if callbacks and len(callbacks) > 0 and usage_info:
                 for callback in callbacks:
-                    if hasattr(callback, "log_success_event"):
+                    if isinstance(callback, TokenCalcHandler):
                         callback.log_success_event(
                             kwargs=params,
                             response_obj={"usage": usage_info},
@@ -1920,7 +1945,7 @@ class LLM(BaseLLM):
             return None
         if isinstance(usage, dict):
             return usage
-        if hasattr(usage, "model_dump"):
+        if isinstance(usage, BaseModel):
             result: dict[str, Any] = usage.model_dump()
             return result
         if hasattr(usage, "__dict__"):
@@ -1984,7 +2009,7 @@ class LLM(BaseLLM):
                 )
             return messages
 
-        provider = getattr(self, "provider", None) or self.model
+        provider = self.provider or self.model
 
         for msg in messages:
             files = msg.get("files")
@@ -2035,7 +2060,7 @@ class LLM(BaseLLM):
                 )
             return messages
 
-        provider = getattr(self, "provider", None) or self.model
+        provider = self.provider or self.model
 
         for msg in messages:
             files = msg.get("files")
diff --git a/lib/crewai/src/crewai/task.py b/lib/crewai/src/crewai/task.py
index 0a159cb0e..e12caa2af 100644
--- a/lib/crewai/src/crewai/task.py
+++ b/lib/crewai/src/crewai/task.py
@@ -45,6 +45,7 @@ from crewai.events.types.task_events import (
     TaskStartedEvent,
 )
 from crewai.llms.base_llm import BaseLLM
+from crewai.llms.providers.openai.completion import OpenAICompletion
 from crewai.security import Fingerprint, SecurityConfig
 from crewai.tasks.output_format import OutputFormat
 from crewai.tasks.task_output import TaskOutput
@@ -301,12 +302,14 @@ class Task(BaseModel):
 
     @model_validator(mode="after")
     def validate_required_fields(self) -> Self:
-        required_fields = ["description", "expected_output"]
-        for field in required_fields:
-            if getattr(self, field) is None:
-                raise ValueError(
-                    f"{field} must be provided either directly or through config"
-                )
+        if self.description is None:
+            raise ValueError(
+                "description must be provided either directly or through config"
+            )
+        if self.expected_output is None:
+            raise ValueError(
+                "expected_output must be provided either directly or through config"
+            )
         return self
 
     @model_validator(mode="after")
@@ -838,8 +841,8 @@ class Task(BaseModel):
         should_inject = self.allow_crewai_trigger_context
 
         if should_inject and self.agent:
-            crew = getattr(self.agent, "crew", None)
-            if crew and hasattr(crew, "_inputs") and crew._inputs:
+            crew = self.agent.crew
+            if crew and not isinstance(crew, str) and crew._inputs:
                 trigger_payload = crew._inputs.get("crewai_trigger_payload")
                 if trigger_payload is not None:
                     description += f"\n\nTrigger Payload: {trigger_payload}"
@@ -852,11 +855,12 @@ class Task(BaseModel):
                     isinstance(self.agent.llm, BaseLLM)
                     and self.agent.llm.supports_multimodal()
                 ):
-                    provider: str = str(
-                        getattr(self.agent.llm, "provider", None)
-                        or getattr(self.agent.llm, "model", "openai")
+                    provider: str = self.agent.llm.provider or self.agent.llm.model
+                    api: str | None = (
+                        self.agent.llm.api
+                        if isinstance(self.agent.llm, OpenAICompletion)
+                        else None
                     )
-                    api: str | None = getattr(self.agent.llm, "api", None)
                     supported_types = get_supported_content_types(provider, api)
 
                 def is_auto_injected(content_type: str) -> bool:

From 9708b9497964665770cdfe12a7d88d688bd84d0b Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Mon, 13 Apr 2026 21:30:14 +0800
Subject: [PATCH 45/70] feat: bump versions to 1.14.2a3

---
 lib/crewai-files/src/crewai_files/__init__.py           | 2 +-
 lib/crewai-tools/pyproject.toml                         | 2 +-
 lib/crewai-tools/src/crewai_tools/__init__.py           | 2 +-
 lib/crewai/pyproject.toml                               | 2 +-
 lib/crewai/src/crewai/__init__.py                       | 2 +-
 lib/crewai/src/crewai/cli/templates/crew/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/flow/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/tool/pyproject.toml | 2 +-
 lib/devtools/src/crewai_devtools/__init__.py            | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/lib/crewai-files/src/crewai_files/__init__.py b/lib/crewai-files/src/crewai_files/__init__.py
index 824b6a5d2..9a3e288db 100644
--- a/lib/crewai-files/src/crewai_files/__init__.py
+++ b/lib/crewai-files/src/crewai_files/__init__.py
@@ -152,4 +152,4 @@ __all__ = [
     "wrap_file_source",
 ]
 
-__version__ = "1.14.2a2"
+__version__ = "1.14.2a3"
diff --git a/lib/crewai-tools/pyproject.toml b/lib/crewai-tools/pyproject.toml
index de4320acd..bc7bfd6a3 100644
--- a/lib/crewai-tools/pyproject.toml
+++ b/lib/crewai-tools/pyproject.toml
@@ -10,7 +10,7 @@ requires-python = ">=3.10, <3.14"
 dependencies = [
     "pytube~=15.0.0",
     "requests>=2.33.0,<3",
-    "crewai==1.14.2a2",
+    "crewai==1.14.2a3",
     "tiktoken~=0.8.0",
     "beautifulsoup4~=4.13.4",
     "python-docx~=1.2.0",
diff --git a/lib/crewai-tools/src/crewai_tools/__init__.py b/lib/crewai-tools/src/crewai_tools/__init__.py
index 9d26aea1d..b0578804f 100644
--- a/lib/crewai-tools/src/crewai_tools/__init__.py
+++ b/lib/crewai-tools/src/crewai_tools/__init__.py
@@ -305,4 +305,4 @@ __all__ = [
     "ZapierActionTools",
 ]
 
-__version__ = "1.14.2a2"
+__version__ = "1.14.2a3"
diff --git a/lib/crewai/pyproject.toml b/lib/crewai/pyproject.toml
index 528f4ea2c..ca637643a 100644
--- a/lib/crewai/pyproject.toml
+++ b/lib/crewai/pyproject.toml
@@ -55,7 +55,7 @@ Repository = "https://github.com/crewAIInc/crewAI"
 
 [project.optional-dependencies]
 tools = [
-    "crewai-tools==1.14.2a2",
+    "crewai-tools==1.14.2a3",
 ]
 embeddings = [
     "tiktoken~=0.8.0"
diff --git a/lib/crewai/src/crewai/__init__.py b/lib/crewai/src/crewai/__init__.py
index d680ca1a3..1fec34a75 100644
--- a/lib/crewai/src/crewai/__init__.py
+++ b/lib/crewai/src/crewai/__init__.py
@@ -46,7 +46,7 @@ def _suppress_pydantic_deprecation_warnings() -> None:
 
 _suppress_pydantic_deprecation_warnings()
 
-__version__ = "1.14.2a2"
+__version__ = "1.14.2a3"
 _telemetry_submitted = False
 
 
diff --git a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
index caaadafb8..516326e31 100644
--- a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a2"
+    "crewai[tools]==1.14.2a3"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
index 6d3ab608b..66c457e84 100644
--- a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a2"
+    "crewai[tools]==1.14.2a3"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
index 0bb9ed6b4..b5e0c85f6 100644
--- a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
@@ -5,7 +5,7 @@ description = "Power up your crews with {{folder_name}}"
 readme = "README.md"
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a2"
+    "crewai[tools]==1.14.2a3"
 ]
 
 [tool.crewai]
diff --git a/lib/devtools/src/crewai_devtools/__init__.py b/lib/devtools/src/crewai_devtools/__init__.py
index 18c3e995d..9d98ece5d 100644
--- a/lib/devtools/src/crewai_devtools/__init__.py
+++ b/lib/devtools/src/crewai_devtools/__init__.py
@@ -1,3 +1,3 @@
 """CrewAI development tools."""
 
-__version__ = "1.14.2a2"
+__version__ = "1.14.2a3"

From 58bbd0a4008f500d831799283bae08c1a0acabf3 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Mon, 13 Apr 2026 21:38:12 +0800
Subject: [PATCH 46/70] docs: update changelog and version for v1.14.2a3

---
 docs/ar/changelog.mdx    | 30 ++++++++++++++++++++++++++++++
 docs/en/changelog.mdx    | 30 ++++++++++++++++++++++++++++++
 docs/ko/changelog.mdx    | 30 ++++++++++++++++++++++++++++++
 docs/pt-BR/changelog.mdx | 30 ++++++++++++++++++++++++++++++
 4 files changed, 120 insertions(+)

diff --git a/docs/ar/changelog.mdx b/docs/ar/changelog.mdx
index 73957dfd5..d4353d210 100644
--- a/docs/ar/changelog.mdx
+++ b/docs/ar/changelog.mdx
@@ -4,6 +4,36 @@ description: "تحديثات المنتج والتحسينات وإصلاحات
 icon: "clock"
 mode: "wide"
 ---
+<Update label="13 أبريل 2026">
+  ## v1.14.2a3
+
+  [عرض الإصدار على GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a3)
+
+  ## ما الذي تغير
+
+  ### الميزات
+  - إضافة واجهة سطر الأوامر للتحقق من النشر
+  - تحسين سهولة استخدام تهيئة LLM
+
+  ### إصلاحات الأخطاء
+  - تجاوز pypdf و uv إلى إصدارات مصححة لـ CVE-2026-40260 و GHSA-pjjw-68hj-v9mw
+  - ترقية requests إلى >=2.33.0 لمعالجة ثغرة ملف مؤقت CVE
+  - الحفاظ على معلمات استدعاء أداة Bedrock من خلال إزالة القيمة الافتراضية الصحيحة
+  - تنظيف مخططات الأدوات لوضع صارم
+  - إصلاح اختبار تسلسل تضمين MemoryRecord
+
+  ### الوثائق
+  - تنظيف لغة A2A الخاصة بالمؤسسات
+  - إضافة وثائق ميزات A2A الخاصة بالمؤسسات
+  - تحديث وثائق A2A الخاصة بالمصادر المفتوحة
+  - تحديث سجل التغييرات والإصدار لـ v1.14.2a2
+
+  ## المساهمون
+
+  @Yanhu007, @greysonlalonde
+
+</Update>
+
 <Update label="10 أبريل 2026">
   ## v1.14.2a2
 
diff --git a/docs/en/changelog.mdx b/docs/en/changelog.mdx
index b8e474d50..340d33633 100644
--- a/docs/en/changelog.mdx
+++ b/docs/en/changelog.mdx
@@ -4,6 +4,36 @@ description: "Product updates, improvements, and bug fixes for CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="Apr 13, 2026">
+  ## v1.14.2a3
+
+  [View release on GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a3)
+
+  ## What's Changed
+
+  ### Features
+  - Add deploy validation CLI
+  - Improve LLM initialization ergonomics
+
+  ### Bug Fixes
+  - Override pypdf and uv to patched versions for CVE-2026-40260 and GHSA-pjjw-68hj-v9mw
+  - Upgrade requests to >=2.33.0 for CVE temp file vulnerability
+  - Preserve Bedrock tool call arguments by removing truthy default
+  - Sanitize tool schemas for strict mode
+  - Deflake MemoryRecord embedding serialization test
+
+  ### Documentation
+  - Clean up enterprise A2A language
+  - Add enterprise A2A feature documentation
+  - Update OSS A2A documentation
+  - Update changelog and version for v1.14.2a2
+
+  ## Contributors
+
+  @Yanhu007, @greysonlalonde
+
+</Update>
+
 <Update label="Apr 10, 2026">
   ## v1.14.2a2
 
diff --git a/docs/ko/changelog.mdx b/docs/ko/changelog.mdx
index ff9ea38ac..e4c00fcf6 100644
--- a/docs/ko/changelog.mdx
+++ b/docs/ko/changelog.mdx
@@ -4,6 +4,36 @@ description: "CrewAI의 제품 업데이트, 개선 사항 및 버그 수정"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="2026년 4월 13일">
+  ## v1.14.2a3
+
+  [GitHub 릴리스 보기](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a3)
+
+  ## 변경 사항
+
+  ### 기능
+  - 배포 검증 CLI 추가
+  - LLM 초기화 사용성 개선
+
+  ### 버그 수정
+  - CVE-2026-40260 및 GHSA-pjjw-68hj-v9mw에 대한 패치된 버전으로 pypdf 및 uv 재정의
+  - CVE 임시 파일 취약점에 대해 requests를 >=2.33.0으로 업그레이드
+  - 진리값 기본값을 제거하여 Bedrock 도구 호출 인수 보존
+  - 엄격 모드를 위한 도구 스키마 정리
+  - MemoryRecord 임베딩 직렬화 테스트의 불안정성 제거
+
+  ### 문서
+  - 기업 A2A 언어 정리
+  - 기업 A2A 기능 문서 추가
+  - OSS A2A 문서 업데이트
+  - v1.14.2a2에 대한 변경 로그 및 버전 업데이트
+
+  ## 기여자
+
+  @Yanhu007, @greysonlalonde
+
+</Update>
+
 <Update label="2026년 4월 10일">
   ## v1.14.2a2
 
diff --git a/docs/pt-BR/changelog.mdx b/docs/pt-BR/changelog.mdx
index 3eafc268a..52dc9af0b 100644
--- a/docs/pt-BR/changelog.mdx
+++ b/docs/pt-BR/changelog.mdx
@@ -4,6 +4,36 @@ description: "Atualizações de produto, melhorias e correções do CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="13 abr 2026">
+  ## v1.14.2a3
+
+  [Ver release no GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a3)
+
+  ## O que Mudou
+
+  ### Recursos
+  - Adicionar CLI de validação de deploy
+  - Melhorar a ergonomia de inicialização do LLM
+
+  ### Correções de Bugs
+  - Substituir pypdf e uv por versões corrigidas para CVE-2026-40260 e GHSA-pjjw-68hj-v9mw
+  - Atualizar requests para >=2.33.0 devido à vulnerabilidade de arquivo temporário CVE
+  - Preservar os argumentos de chamada da ferramenta Bedrock removendo o padrão truthy
+  - Sanitizar esquemas de ferramentas para modo estrito
+  - Remover flakiness do teste de serialização de embedding MemoryRecord
+
+  ### Documentação
+  - Limpar a linguagem do A2A empresarial
+  - Adicionar documentação de recursos do A2A empresarial
+  - Atualizar documentação do A2A OSS
+  - Atualizar changelog e versão para v1.14.2a2
+
+  ## Contribuidores
+
+  @Yanhu007, @greysonlalonde
+
+</Update>
+
 <Update label="10 abr 2026">
   ## v1.14.2a2
 

From 8e2a529d949f9ddcc77600c05f066db27b20ee2e Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Tue, 14 Apr 2026 00:51:11 +0800
Subject: [PATCH 47/70] chore: add deprecation decorator to LiteAgent

---
 lib/crewai/src/crewai/lite_agent.py        | 22 ++++++----------------
 lib/crewai/tests/agents/test_lite_agent.py |  2 +-
 2 files changed, 7 insertions(+), 17 deletions(-)

diff --git a/lib/crewai/src/crewai/lite_agent.py b/lib/crewai/src/crewai/lite_agent.py
index 07813b60f..5ddddc89e 100644
--- a/lib/crewai/src/crewai/lite_agent.py
+++ b/lib/crewai/src/crewai/lite_agent.py
@@ -16,7 +16,6 @@ from typing import (
     get_origin,
 )
 import uuid
-import warnings
 
 from pydantic import (
     UUID4,
@@ -26,7 +25,7 @@ from pydantic import (
     field_validator,
     model_validator,
 )
-from typing_extensions import Self
+from typing_extensions import Self, deprecated
 
 
 if TYPE_CHECKING:
@@ -173,9 +172,12 @@ def _kickoff_with_a2a_support(
     )
 
 
+@deprecated(
+    "LiteAgent is deprecated and will be removed in v2.0.0.",
+    category=FutureWarning,
+)
 class LiteAgent(FlowTrackable, BaseModel):
-    """
-    A lightweight agent that can process messages and use tools.
+    """A lightweight agent that can process messages and use tools.
 
     .. deprecated::
         LiteAgent is deprecated and will be removed in a future version.
@@ -278,18 +280,6 @@ class LiteAgent(FlowTrackable, BaseModel):
     )
     _memory: Any = PrivateAttr(default=None)
 
-    @model_validator(mode="after")
-    def emit_deprecation_warning(self) -> Self:
-        """Emit deprecation warning for LiteAgent usage."""
-        warnings.warn(
-            "LiteAgent is deprecated and will be removed in a future version. "
-            "Use Agent().kickoff(messages) instead, which provides the same "
-            "functionality with additional features like memory and knowledge support.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
-        return self
-
     @model_validator(mode="after")
     def setup_llm(self) -> Self:
         """Set up the LLM and other components after initialization."""
diff --git a/lib/crewai/tests/agents/test_lite_agent.py b/lib/crewai/tests/agents/test_lite_agent.py
index b42e2c1ec..37d115228 100644
--- a/lib/crewai/tests/agents/test_lite_agent.py
+++ b/lib/crewai/tests/agents/test_lite_agent.py
@@ -1051,7 +1051,7 @@ def test_lite_agent_verbose_false_suppresses_printer_output():
         successful_requests=1,
     )
 
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(FutureWarning):
         agent = LiteAgent(
             role="Test Agent",
             goal="Test goal",

From 655e75038b5bca8ec6527c342ea8164c0cac2294 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Tue, 14 Apr 2026 01:26:29 +0800
Subject: [PATCH 48/70] feat: add resume hints to devtools release on failure

---
 lib/devtools/src/crewai_devtools/cli.py | 233 +++++++++++++++---------
 1 file changed, 146 insertions(+), 87 deletions(-)

diff --git a/lib/devtools/src/crewai_devtools/cli.py b/lib/devtools/src/crewai_devtools/cli.py
index c155026d9..eca54063b 100644
--- a/lib/devtools/src/crewai_devtools/cli.py
+++ b/lib/devtools/src/crewai_devtools/cli.py
@@ -29,6 +29,33 @@ load_dotenv()
 console = Console()
 
 
+def _resume_hint(message: str) -> None:
+    """Print a boxed resume hint after a failure."""
+    console.print()
+    console.print(
+        Panel(
+            message,
+            title="[bold yellow]How to resume[/bold yellow]",
+            border_style="yellow",
+            padding=(1, 2),
+        )
+    )
+
+
+def _print_release_error(e: BaseException) -> None:
+    """Print a release error with stderr if available."""
+    if isinstance(e, KeyboardInterrupt):
+        raise
+    if isinstance(e, SystemExit):
+        return
+    if isinstance(e, subprocess.CalledProcessError):
+        console.print(f"[red]Error running command:[/red] {e}")
+        if e.stderr:
+            console.print(e.stderr)
+    else:
+        console.print(f"[red]Error:[/red] {e}")
+
+
 def run_command(cmd: list[str], cwd: Path | None = None) -> str:
     """Run a shell command and return output.
 
@@ -264,11 +291,9 @@ def add_docs_version(docs_json_path: Path, version: str) -> bool:
         if not versions:
             continue
 
-        # Skip if this version already exists for this language
         if any(v.get("version") == version_label for v in versions):
             continue
 
-        # Find the current default and copy its tabs
         default_version = next(
             (v for v in versions if v.get("default")),
             versions[0],
@@ -280,10 +305,7 @@ def add_docs_version(docs_json_path: Path, version: str) -> bool:
             "tabs": default_version.get("tabs", []),
         }
 
-        # Remove default flag from old default
         default_version.pop("default", None)
-
-        # Insert new version at the beginning
         versions.insert(0, new_version)
         updated = True
 
@@ -477,7 +499,7 @@ def _is_crewai_dep(spec: str) -> bool:
     """Return True if *spec* is a ``crewai`` or ``crewai[...]`` dependency."""
     if not spec.startswith("crewai"):
         return False
-    rest = spec[6:]  # after "crewai"
+    rest = spec[6:]
     return len(rest) > 0 and rest[0] in ("[", "=", ">", "<", "~", "!")
 
 
@@ -499,7 +521,6 @@ def _pin_crewai_deps(content: str, version: str) -> str:
         deps = doc.get("project", {}).get(key)
         if deps is None:
             continue
-        # optional-dependencies is a table of lists; dependencies is a list
         dep_lists = deps.values() if isinstance(deps, Mapping) else [deps]
         for dep_list in dep_lists:
             for i, dep in enumerate(dep_list):
@@ -638,7 +659,6 @@ def get_github_contributors(commit_range: str) -> list[str]:
         List of GitHub usernames sorted alphabetically.
     """
     try:
-        # Get GitHub token from gh CLI
         try:
             gh_token = run_command(["gh", "auth", "token"])
         except subprocess.CalledProcessError:
@@ -680,11 +700,6 @@ def get_github_contributors(commit_range: str) -> list[str]:
         return []
 
 
-# ---------------------------------------------------------------------------
-# Shared workflow helpers
-# ---------------------------------------------------------------------------
-
-
 def _poll_pr_until_merged(
     branch_name: str, label: str, repo: str | None = None
 ) -> None:
@@ -764,7 +779,6 @@ def _update_all_versions(
             "[yellow]Warning:[/yellow] No __version__ attributes found to update"
         )
 
-    # Update CLI template pyproject.toml files
     templates_dir = lib_dir / "crewai" / "src" / "crewai" / "cli" / "templates"
     if templates_dir.exists():
         if dry_run:
@@ -1163,13 +1177,11 @@ def _repin_crewai_install(run_value: str, version: str) -> str:
     while marker in remainder:
         before, _, after = remainder.partition(marker)
         result.append(before)
-        # after looks like: a2a]==1.14.0" ...
         bracket_end = after.index("]")
         extras = after[:bracket_end]
         rest = after[bracket_end + 1 :]
         if rest.startswith("=="):
-            # Find end of version — next quote or whitespace
-            ver_start = 2  # len("==")
+            ver_start = 2
             ver_end = ver_start
             while ver_end < len(rest) and rest[ver_end] not in ('"', "'", " ", "\n"):
                 ver_end += 1
@@ -1331,7 +1343,6 @@ def _release_enterprise(version: str, is_prerelease: bool, dry_run: bool) -> Non
         run_command(["gh", "repo", "clone", enterprise_repo, str(repo_dir)])
         console.print(f"[green]✓[/green] Cloned {enterprise_repo}")
 
-        # --- bump versions ---
         for rel_dir in _ENTERPRISE_VERSION_DIRS:
             pkg_dir = repo_dir / rel_dir
             if not pkg_dir.exists():
@@ -1361,14 +1372,12 @@ def _release_enterprise(version: str, is_prerelease: bool, dry_run: bool) -> Non
                         f"{pyproject.relative_to(repo_dir)}"
                     )
 
-        # --- update crewai[tools] pin ---
         enterprise_pyproject = repo_dir / enterprise_dep_path
         if _update_enterprise_crewai_dep(enterprise_pyproject, version):
             console.print(
                 f"[green]✓[/green] Updated crewai[tools] dep in {enterprise_dep_path}"
             )
 
-        # --- update crewai pins in CI workflows ---
         for wf in _update_enterprise_workflows(repo_dir, version):
             console.print(
                 f"[green]✓[/green] Updated crewai pin in {wf.relative_to(repo_dir)}"
@@ -1408,7 +1417,6 @@ def _release_enterprise(version: str, is_prerelease: bool, dry_run: bool) -> Non
                 time.sleep(_PYPI_POLL_INTERVAL)
         console.print("[green]✓[/green] Workspace synced")
 
-        # --- branch, commit, push, PR ---
         branch_name = f"feat/bump-version-{version}"
         run_command(["git", "checkout", "-b", branch_name], cwd=repo_dir)
         run_command(["git", "add", "."], cwd=repo_dir)
@@ -1442,7 +1450,6 @@ def _release_enterprise(version: str, is_prerelease: bool, dry_run: bool) -> Non
 
         _poll_pr_until_merged(branch_name, "enterprise bump PR", repo=enterprise_repo)
 
-        # --- tag and release ---
         run_command(["git", "checkout", "main"], cwd=repo_dir)
         run_command(["git", "pull"], cwd=repo_dir)
 
@@ -1484,7 +1491,6 @@ def _trigger_pypi_publish(tag_name: str, wait: bool = False) -> None:
         tag_name: The release tag to publish.
         wait: Block until the workflow run completes.
     """
-    # Capture the latest run ID before triggering so we can detect the new one
     prev_run_id = ""
     if wait:
         try:
@@ -1559,11 +1565,6 @@ def _trigger_pypi_publish(tag_name: str, wait: bool = False) -> None:
         console.print("[green]✓[/green] PyPI publish workflow completed")
 
 
-# ---------------------------------------------------------------------------
-# CLI commands
-# ---------------------------------------------------------------------------
-
-
 @click.group()
 def cli() -> None:
     """Development tools for version bumping and git automation."""
@@ -1831,62 +1832,80 @@ def release(
         skip_enterprise: Skip the enterprise release phase.
         skip_to_enterprise: Skip phases 1 & 2, run only the enterprise release phase.
     """
-    try:
-        check_gh_installed()
+    flags: list[str] = []
+    if no_edit:
+        flags.append("--no-edit")
+    if skip_enterprise:
+        flags.append("--skip-enterprise")
+    flag_suffix = (" " + " ".join(flags)) if flags else ""
+    enterprise_hint = (
+        ""
+        if skip_enterprise
+        else f"\n\nThen release enterprise:\n\n"
+        f"  devtools release {version} --skip-to-enterprise"
+    )
 
-        if skip_enterprise and skip_to_enterprise:
+    check_gh_installed()
+
+    if skip_enterprise and skip_to_enterprise:
+        console.print(
+            "[red]Error:[/red] Cannot use both --skip-enterprise "
+            "and --skip-to-enterprise"
+        )
+        sys.exit(1)
+
+    if not skip_enterprise or skip_to_enterprise:
+        missing: list[str] = []
+        if not _ENTERPRISE_REPO:
+            missing.append("ENTERPRISE_REPO")
+        if not _ENTERPRISE_VERSION_DIRS:
+            missing.append("ENTERPRISE_VERSION_DIRS")
+        if not _ENTERPRISE_CREWAI_DEP_PATH:
+            missing.append("ENTERPRISE_CREWAI_DEP_PATH")
+        if missing:
             console.print(
-                "[red]Error:[/red] Cannot use both --skip-enterprise "
-                "and --skip-to-enterprise"
+                f"[red]Error:[/red] Missing required environment variable(s): "
+                f"{', '.join(missing)}\n"
+                f"Set them or pass --skip-enterprise to skip the enterprise release."
             )
             sys.exit(1)
 
-        if not skip_enterprise or skip_to_enterprise:
-            missing: list[str] = []
-            if not _ENTERPRISE_REPO:
-                missing.append("ENTERPRISE_REPO")
-            if not _ENTERPRISE_VERSION_DIRS:
-                missing.append("ENTERPRISE_VERSION_DIRS")
-            if not _ENTERPRISE_CREWAI_DEP_PATH:
-                missing.append("ENTERPRISE_CREWAI_DEP_PATH")
-            if missing:
-                console.print(
-                    f"[red]Error:[/red] Missing required environment variable(s): "
-                    f"{', '.join(missing)}\n"
-                    f"Set them or pass --skip-enterprise to skip the enterprise release."
-                )
-                sys.exit(1)
+    cwd = Path.cwd()
+    lib_dir = cwd / "lib"
 
-        cwd = Path.cwd()
-        lib_dir = cwd / "lib"
+    is_prerelease = _is_prerelease(version)
 
-        is_prerelease = _is_prerelease(version)
-
-        if skip_to_enterprise:
+    if skip_to_enterprise:
+        try:
             _release_enterprise(version, is_prerelease, dry_run)
-            console.print(
-                f"\n[green]✓[/green] Enterprise release [bold]{version}[/bold] complete!"
+        except BaseException as e:
+            _print_release_error(e)
+            _resume_hint(
+                f"Fix the issue, then re-run:\n\n"
+                f"  devtools release {version} --skip-to-enterprise"
             )
-            return
-
-        if not dry_run:
-            console.print("Checking git status...")
-            check_git_clean()
-            console.print("[green]✓[/green] Working directory is clean")
-        else:
-            console.print("[dim][DRY RUN][/dim] Would check git status")
-
-        packages = get_packages(lib_dir)
-
-        console.print(f"\nFound {len(packages)} package(s) to update:")
-        for pkg in packages:
-            console.print(f"  - {pkg.name}")
-
-        # --- Phase 1: Bump versions ---
+            sys.exit(1)
         console.print(
-            f"\n[bold cyan]Phase 1: Bumping versions to {version}[/bold cyan]"
+            f"\n[green]✓[/green] Enterprise release [bold]{version}[/bold] complete!"
         )
+        return
 
+    if not dry_run:
+        console.print("Checking git status...")
+        check_git_clean()
+        console.print("[green]✓[/green] Working directory is clean")
+    else:
+        console.print("[dim][DRY RUN][/dim] Would check git status")
+
+    packages = get_packages(lib_dir)
+
+    console.print(f"\nFound {len(packages)} package(s) to update:")
+    for pkg in packages:
+        console.print(f"  - {pkg.name}")
+
+    console.print(f"\n[bold cyan]Phase 1: Bumping versions to {version}[/bold cyan]")
+
+    try:
         _update_all_versions(cwd, lib_dir, version, packages, dry_run)
 
         branch_name = f"feat/bump-version-{version}"
@@ -1930,12 +1949,17 @@ def release(
             console.print(
                 "[dim][DRY RUN][/dim] Would push branch, create PR, and wait for merge"
             )
-
-        # --- Phase 2: Tag and release ---
-        console.print(
-            f"\n[bold cyan]Phase 2: Tagging and releasing {version}[/bold cyan]"
+    except BaseException as e:
+        _print_release_error(e)
+        _resume_hint(
+            f"Phase 1 failed. Fix the issue, then re-run:\n\n"
+            f"  devtools release {version}{flag_suffix}"
         )
+        sys.exit(1)
 
+    console.print(f"\n[bold cyan]Phase 2: Tagging and releasing {version}[/bold cyan]")
+
+    try:
         tag_name = version
 
         if not dry_run:
@@ -1962,22 +1986,57 @@ def release(
 
         if not dry_run:
             _create_tag_and_release(tag_name, release_notes, is_prerelease)
+    except BaseException as e:
+        _print_release_error(e)
+        _resume_hint(
+            "Phase 2 failed before PyPI publish. The bump PR is already merged.\n"
+            "Fix the issue, then resume with:\n\n"
+            "  devtools tag"
+            f"\n\nAfter tagging, publish to PyPI and update deployment test:\n\n"
+            f"  gh workflow run publish.yml -f release_tag={version}"
+            f"{enterprise_hint}"
+        )
+        sys.exit(1)
+
+    try:
+        if not dry_run:
             _trigger_pypi_publish(tag_name, wait=True)
+    except BaseException as e:
+        _print_release_error(e)
+        _resume_hint(
+            f"Phase 2 failed at PyPI publish. Tag and GitHub release already exist.\n"
+            f"Retry PyPI publish manually:\n\n"
+            f"  gh workflow run publish.yml -f release_tag={version}"
+            f"{enterprise_hint}"
+        )
+        sys.exit(1)
+
+    try:
+        if not dry_run:
             _update_deployment_test_repo(version, is_prerelease)
+    except BaseException as e:
+        _print_release_error(e)
+        _resume_hint(
+            f"Phase 2 failed updating deployment test repo. "
+            f"Tag, release, and PyPI are done.\n"
+            f"Fix the issue and update {_DEPLOYMENT_TEST_REPO} manually."
+            f"{enterprise_hint}"
+        )
+        sys.exit(1)
 
-        if not skip_enterprise:
+    if not skip_enterprise:
+        try:
             _release_enterprise(version, is_prerelease, dry_run)
+        except BaseException as e:
+            _print_release_error(e)
+            _resume_hint(
+                f"Phase 3 (enterprise) failed. Phases 1 & 2 completed successfully.\n"
+                f"Fix the issue, then resume:\n\n"
+                f"  devtools release {version} --skip-to-enterprise"
+            )
+            sys.exit(1)
 
-        console.print(f"\n[green]✓[/green] Release [bold]{version}[/bold] complete!")
-
-    except subprocess.CalledProcessError as e:
-        console.print(f"[red]Error running command:[/red] {e}")
-        if e.stderr:
-            console.print(e.stderr)
-        sys.exit(1)
-    except Exception as e:
-        console.print(f"[red]Error:[/red] {e}")
-        sys.exit(1)
+    console.print(f"\n[green]✓[/green] Release [bold]{version}[/bold] complete!")
 
 
 cli.add_command(bump)

From 58208fdbae2e3467b5c27446bb88993a74bebdf3 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Tue, 14 Apr 2026 02:19:47 +0800
Subject: [PATCH 49/70] fix: bump openai lower bound to >=2.0.0

---
 lib/crewai/pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/crewai/pyproject.toml b/lib/crewai/pyproject.toml
index ca637643a..5ccb5a453 100644
--- a/lib/crewai/pyproject.toml
+++ b/lib/crewai/pyproject.toml
@@ -10,7 +10,7 @@ requires-python = ">=3.10, <3.14"
 dependencies = [
     # Core Dependencies
     "pydantic~=2.11.9",
-    "openai>=1.83.0,<3",
+    "openai>=2.0.0,<3",
     "instructor>=1.3.3",
     # Text Processing
     "pdfplumber~=0.11.4",

From 0dba95e16679ca7a06ad17c557b63a0fd95254fd Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Tue, 14 Apr 2026 02:38:05 +0800
Subject: [PATCH 50/70] fix: bump pytest to 9.0.3 for GHSA-6w46-j5rx-g56g

pytest <9.0.3 has an insecure tmpdir vulnerability (CVE / GHSA-6w46-j5rx-g56g).
Bump pytest-split to 0.11.0 to satisfy the new pytest>=9 requirement.
---
 pyproject.toml |  4 ++--
 uv.lock        | 20 ++++++++++----------
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 0a4303370..881d7a887 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -12,7 +12,7 @@ dev = [
     "mypy==1.19.1",
     "pre-commit==4.5.1",
     "bandit==1.9.2",
-    "pytest==8.4.2",
+    "pytest==9.0.3",
     "pytest-asyncio==1.3.0",
     "pytest-subprocess==1.5.3",
     "vcrpy==7.0.0", # pinned, less versions break pytest-recording
@@ -20,7 +20,7 @@ dev = [
     "pytest-randomly==4.0.1",
     "pytest-timeout==2.4.0",
     "pytest-xdist==3.8.0",
-    "pytest-split==0.10.0",
+    "pytest-split==0.11.0",
     "types-requests~=2.31.0.6",
     "types-pyyaml==6.0.*",
     "types-regex==2026.1.15.*",
diff --git a/uv.lock b/uv.lock
index 756e39b90..d07aee183 100644
--- a/uv.lock
+++ b/uv.lock
@@ -13,7 +13,7 @@ resolution-markers = [
 ]
 
 [options]
-exclude-newer = "2026-04-10T12:25:00.712108Z"
+exclude-newer = "2026-04-10T18:30:59.748668Z"
 exclude-newer-span = "P3D"
 
 [manifest]
@@ -43,11 +43,11 @@ dev = [
     { name = "mypy", specifier = "==1.19.1" },
     { name = "pip-audit", specifier = "==2.9.0" },
     { name = "pre-commit", specifier = "==4.5.1" },
-    { name = "pytest", specifier = "==8.4.2" },
+    { name = "pytest", specifier = "==9.0.3" },
     { name = "pytest-asyncio", specifier = "==1.3.0" },
     { name = "pytest-randomly", specifier = "==4.0.1" },
     { name = "pytest-recording", specifier = "==0.13.4" },
-    { name = "pytest-split", specifier = "==0.10.0" },
+    { name = "pytest-split", specifier = "==0.11.0" },
     { name = "pytest-subprocess", specifier = "==1.5.3" },
     { name = "pytest-timeout", specifier = "==2.4.0" },
     { name = "pytest-xdist", specifier = "==3.8.0" },
@@ -1355,7 +1355,7 @@ requires-dist = [
     { name = "litellm", marker = "extra == 'litellm'", specifier = "~=1.83.0" },
     { name = "mcp", specifier = "~=1.26.0" },
     { name = "mem0ai", marker = "extra == 'mem0'", specifier = "~=0.1.94" },
-    { name = "openai", specifier = ">=1.83.0,<3" },
+    { name = "openai", specifier = ">=2.0.0,<3" },
     { name = "openpyxl", specifier = "~=3.1.5" },
     { name = "openpyxl", marker = "extra == 'openpyxl'", specifier = "~=3.1.5" },
     { name = "opentelemetry-api", specifier = "~=1.34.0" },
@@ -6817,7 +6817,7 @@ sdist = { url = "https://files.pythonhosted.org/packages/12/a0/d0638470df605ce26
 
 [[package]]
 name = "pytest"
-version = "8.4.2"
+version = "9.0.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "colorama", marker = "sys_platform == 'win32'" },
@@ -6828,9 +6828,9 @@ dependencies = [
     { name = "pygments" },
     { name = "tomli", marker = "python_full_version < '3.11'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/a3/5c/00a0e072241553e1a7496d638deababa67c5058571567b92a7eaa258397c/pytest-8.4.2.tar.gz", hash = "sha256:86c0d0b93306b961d58d62a4db4879f27fe25513d4b969df351abdddb3c30e01", size = 1519618, upload-time = "2025-09-04T14:34:22.711Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/7d/0d/549bd94f1a0a402dc8cf64563a117c0f3765662e2e668477624baeec44d5/pytest-9.0.3.tar.gz", hash = "sha256:b86ada508af81d19edeb213c681b1d48246c1a91d304c6c81a427674c17eb91c", size = 1572165, upload-time = "2026-04-07T17:16:18.027Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a8/a4/20da314d277121d6534b3a980b29035dcd51e6744bd79075a6ce8fa4eb8d/pytest-8.4.2-py3-none-any.whl", hash = "sha256:872f880de3fc3a5bdc88a11b39c9710c3497a547cfa9320bc3c5e62fbf272e79", size = 365750, upload-time = "2025-09-04T14:34:20.226Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/24/a372aaf5c9b7208e7112038812994107bc65a84cd00e0354a88c2c77a617/pytest-9.0.3-py3-none-any.whl", hash = "sha256:2c5efc453d45394fdd706ade797c0a81091eccd1d6e4bccfcd476e2b8e0ab5d9", size = 375249, upload-time = "2026-04-07T17:16:16.13Z" },
 ]
 
 [[package]]
@@ -6874,14 +6874,14 @@ wheels = [
 
 [[package]]
 name = "pytest-split"
-version = "0.10.0"
+version = "0.11.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "pytest" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/46/d7/e30ba44adf83f15aee3f636daea54efadf735769edc0f0a7d98163f61038/pytest_split-0.10.0.tar.gz", hash = "sha256:adf80ba9fef7be89500d571e705b4f963dfa05038edf35e4925817e6b34ea66f", size = 13903, upload-time = "2024-10-16T15:45:19.783Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/2f/16/8af4c5f2ceb3640bb1f78dfdf5c184556b10dfe9369feaaad7ff1c13f329/pytest_split-0.11.0.tar.gz", hash = "sha256:8ebdb29cc72cc962e8eb1ec07db1eeb98ab25e215ed8e3216f6b9fc7ce0ec2b5", size = 13421, upload-time = "2026-02-03T09:14:31.469Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/d6/a7/cad88e9c1109a5c2a320d608daa32e5ee008ccbc766310f54b1cd6b3d69c/pytest_split-0.10.0-py3-none-any.whl", hash = "sha256:466096b086a7147bcd423c6e6c2e57fc62af1c5ea2e256b4ed50fc030fc3dddc", size = 11961, upload-time = "2024-10-16T15:45:18.289Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/a1/d4423657caaa8be9b31e491592b49cebdcfd434d3e74512ce71f6ec39905/pytest_split-0.11.0-py3-none-any.whl", hash = "sha256:899d7c0f5730da91e2daf283860eb73b503259cb416851a65599368849c7f382", size = 11911, upload-time = "2026-02-03T09:14:33.708Z" },
 ]
 
 [[package]]

From 94e7d86df19005d03a58c701ab395f38970f4fb5 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Wed, 15 Apr 2026 02:22:50 +0800
Subject: [PATCH 51/70] fix: stop forwarding strict mode to Bedrock Converse
 API

Forwarding strict and sanitizing tool schemas for strict mode causes
Bedrock Converse requests to hang until timeout. Drop strict forwarding
and schema sanitization from the Bedrock provider.
---
 .../llms/providers/bedrock/completion.py      | 19 ++-----------------
 1 file changed, 2 insertions(+), 17 deletions(-)

diff --git a/lib/crewai/src/crewai/llms/providers/bedrock/completion.py b/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
index 5932b66f0..54c222c85 100644
--- a/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
+++ b/lib/crewai/src/crewai/llms/providers/bedrock/completion.py
@@ -17,10 +17,7 @@ from crewai.utilities.agent_utils import is_context_length_exceeded
 from crewai.utilities.exceptions.context_window_exceeding_exception import (
     LLMContextLengthExceededError,
 )
-from crewai.utilities.pydantic_schema_utils import (
-    generate_model_description,
-    sanitize_tool_params_for_bedrock_strict,
-)
+from crewai.utilities.pydantic_schema_utils import generate_model_description
 from crewai.utilities.types import LLMMessage
 
 
@@ -173,7 +170,6 @@ class ToolSpec(TypedDict, total=False):
     name: Required[str]
     description: Required[str]
     inputSchema: ToolInputSchema
-    strict: bool
 
 
 class ConverseToolTypeDef(TypedDict):
@@ -1988,21 +1984,10 @@ class BedrockCompletion(BaseLLM):
                     "description": description,
                 }
 
-                func_info = tool.get("function", {})
-                strict_enabled = bool(func_info.get("strict"))
-
                 if parameters and isinstance(parameters, dict):
-                    schema_params = (
-                        sanitize_tool_params_for_bedrock_strict(parameters)
-                        if strict_enabled
-                        else parameters
-                    )
-                    input_schema: ToolInputSchema = {"json": schema_params}
+                    input_schema: ToolInputSchema = {"json": parameters}
                     tool_spec["inputSchema"] = input_schema
 
-                if strict_enabled:
-                    tool_spec["strict"] = True
-
                 converse_tool: ConverseToolTypeDef = {"toolSpec": tool_spec}
 
                 converse_tools.append(converse_tool)

From ad5e66d1d0bf0df77c3bbe592fd93bf962ff71bb Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Wed, 15 Apr 2026 02:29:06 +0800
Subject: [PATCH 52/70] feat: bump versions to 1.14.2a4

---
 lib/crewai-files/src/crewai_files/__init__.py           | 2 +-
 lib/crewai-tools/pyproject.toml                         | 2 +-
 lib/crewai-tools/src/crewai_tools/__init__.py           | 2 +-
 lib/crewai/pyproject.toml                               | 2 +-
 lib/crewai/src/crewai/__init__.py                       | 2 +-
 lib/crewai/src/crewai/cli/templates/crew/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/flow/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/tool/pyproject.toml | 2 +-
 lib/devtools/src/crewai_devtools/__init__.py            | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/lib/crewai-files/src/crewai_files/__init__.py b/lib/crewai-files/src/crewai_files/__init__.py
index 9a3e288db..e31d070e0 100644
--- a/lib/crewai-files/src/crewai_files/__init__.py
+++ b/lib/crewai-files/src/crewai_files/__init__.py
@@ -152,4 +152,4 @@ __all__ = [
     "wrap_file_source",
 ]
 
-__version__ = "1.14.2a3"
+__version__ = "1.14.2a4"
diff --git a/lib/crewai-tools/pyproject.toml b/lib/crewai-tools/pyproject.toml
index bc7bfd6a3..f1cba20b1 100644
--- a/lib/crewai-tools/pyproject.toml
+++ b/lib/crewai-tools/pyproject.toml
@@ -10,7 +10,7 @@ requires-python = ">=3.10, <3.14"
 dependencies = [
     "pytube~=15.0.0",
     "requests>=2.33.0,<3",
-    "crewai==1.14.2a3",
+    "crewai==1.14.2a4",
     "tiktoken~=0.8.0",
     "beautifulsoup4~=4.13.4",
     "python-docx~=1.2.0",
diff --git a/lib/crewai-tools/src/crewai_tools/__init__.py b/lib/crewai-tools/src/crewai_tools/__init__.py
index b0578804f..091fed900 100644
--- a/lib/crewai-tools/src/crewai_tools/__init__.py
+++ b/lib/crewai-tools/src/crewai_tools/__init__.py
@@ -305,4 +305,4 @@ __all__ = [
     "ZapierActionTools",
 ]
 
-__version__ = "1.14.2a3"
+__version__ = "1.14.2a4"
diff --git a/lib/crewai/pyproject.toml b/lib/crewai/pyproject.toml
index 5ccb5a453..5049559fe 100644
--- a/lib/crewai/pyproject.toml
+++ b/lib/crewai/pyproject.toml
@@ -55,7 +55,7 @@ Repository = "https://github.com/crewAIInc/crewAI"
 
 [project.optional-dependencies]
 tools = [
-    "crewai-tools==1.14.2a3",
+    "crewai-tools==1.14.2a4",
 ]
 embeddings = [
     "tiktoken~=0.8.0"
diff --git a/lib/crewai/src/crewai/__init__.py b/lib/crewai/src/crewai/__init__.py
index 1fec34a75..d2215fbae 100644
--- a/lib/crewai/src/crewai/__init__.py
+++ b/lib/crewai/src/crewai/__init__.py
@@ -46,7 +46,7 @@ def _suppress_pydantic_deprecation_warnings() -> None:
 
 _suppress_pydantic_deprecation_warnings()
 
-__version__ = "1.14.2a3"
+__version__ = "1.14.2a4"
 _telemetry_submitted = False
 
 
diff --git a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
index 516326e31..fc465c102 100644
--- a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a3"
+    "crewai[tools]==1.14.2a4"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
index 66c457e84..86f208cb5 100644
--- a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a3"
+    "crewai[tools]==1.14.2a4"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
index b5e0c85f6..cb3441d56 100644
--- a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
@@ -5,7 +5,7 @@ description = "Power up your crews with {{folder_name}}"
 readme = "README.md"
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a3"
+    "crewai[tools]==1.14.2a4"
 ]
 
 [tool.crewai]
diff --git a/lib/devtools/src/crewai_devtools/__init__.py b/lib/devtools/src/crewai_devtools/__init__.py
index 9d98ece5d..16c934202 100644
--- a/lib/devtools/src/crewai_devtools/__init__.py
+++ b/lib/devtools/src/crewai_devtools/__init__.py
@@ -1,3 +1,3 @@
 """CrewAI development tools."""
 
-__version__ = "1.14.2a3"
+__version__ = "1.14.2a4"

From 5b6f89fe64c9ba206417079d8c1ea5891db45f8b Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Wed, 15 Apr 2026 02:34:32 +0800
Subject: [PATCH 53/70] docs: update changelog and version for v1.14.2a4

---
 docs/ar/changelog.mdx    | 24 ++++++++++++++++++++++++
 docs/en/changelog.mdx    | 24 ++++++++++++++++++++++++
 docs/ko/changelog.mdx    | 24 ++++++++++++++++++++++++
 docs/pt-BR/changelog.mdx | 24 ++++++++++++++++++++++++
 4 files changed, 96 insertions(+)

diff --git a/docs/ar/changelog.mdx b/docs/ar/changelog.mdx
index d4353d210..b151cf950 100644
--- a/docs/ar/changelog.mdx
+++ b/docs/ar/changelog.mdx
@@ -4,6 +4,30 @@ description: "تحديثات المنتج والتحسينات وإصلاحات
 icon: "clock"
 mode: "wide"
 ---
+<Update label="15 أبريل 2026">
+  ## v1.14.2a4
+
+  [عرض الإصدار على GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a4)
+
+  ## ما الذي تغير
+
+  ### الميزات
+  - إضافة تلميحات استئناف إلى إصدار أدوات المطورين عند الفشل
+
+  ### إصلاحات الأخطاء
+  - إصلاح توجيه وضع الصرامة إلى واجهة برمجة تطبيقات Bedrock Converse
+  - إصلاح إصدار pytest إلى 9.0.3 لثغرة الأمان GHSA-6w46-j5rx-g56g
+  - رفع الحد الأدنى لـ OpenAI إلى >=2.0.0
+
+  ### الوثائق
+  - تحديث سجل التغييرات والإصدار لـ v1.14.2a3
+
+  ## المساهمون
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="13 أبريل 2026">
   ## v1.14.2a3
 
diff --git a/docs/en/changelog.mdx b/docs/en/changelog.mdx
index 340d33633..24c62b85f 100644
--- a/docs/en/changelog.mdx
+++ b/docs/en/changelog.mdx
@@ -4,6 +4,30 @@ description: "Product updates, improvements, and bug fixes for CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="Apr 15, 2026">
+  ## v1.14.2a4
+
+  [View release on GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a4)
+
+  ## What's Changed
+
+  ### Features
+  - Add resume hints to devtools release on failure
+
+  ### Bug Fixes
+  - Fix strict mode forwarding to Bedrock Converse API
+  - Fix pytest version to 9.0.3 for security vulnerability GHSA-6w46-j5rx-g56g
+  - Bump OpenAI lower bound to >=2.0.0
+
+  ### Documentation
+  - Update changelog and version for v1.14.2a3
+
+  ## Contributors
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="Apr 13, 2026">
   ## v1.14.2a3
 
diff --git a/docs/ko/changelog.mdx b/docs/ko/changelog.mdx
index e4c00fcf6..79c260bb4 100644
--- a/docs/ko/changelog.mdx
+++ b/docs/ko/changelog.mdx
@@ -4,6 +4,30 @@ description: "CrewAI의 제품 업데이트, 개선 사항 및 버그 수정"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="2026년 4월 15일">
+  ## v1.14.2a4
+
+  [GitHub 릴리스 보기](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a4)
+
+  ## 변경 사항
+
+  ### 기능
+  - 실패 시 devtools 릴리스에 이력서 힌트 추가
+
+  ### 버그 수정
+  - Bedrock Converse API로의 엄격 모드 포워딩 수정
+  - 보안 취약점 GHSA-6w46-j5rx-g56g에 대해 pytest 버전을 9.0.3으로 수정
+  - OpenAI 하한을 >=2.0.0으로 상향 조정
+
+  ### 문서
+  - v1.14.2a3에 대한 변경 로그 및 버전 업데이트
+
+  ## 기여자
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="2026년 4월 13일">
   ## v1.14.2a3
 
diff --git a/docs/pt-BR/changelog.mdx b/docs/pt-BR/changelog.mdx
index 52dc9af0b..a8b9bc4c2 100644
--- a/docs/pt-BR/changelog.mdx
+++ b/docs/pt-BR/changelog.mdx
@@ -4,6 +4,30 @@ description: "Atualizações de produto, melhorias e correções do CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="15 abr 2026">
+  ## v1.14.2a4
+
+  [Ver release no GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a4)
+
+  ## O que Mudou
+
+  ### Recursos
+  - Adicionar dicas de retomar ao release do devtools em caso de falha
+
+  ### Correções de Bugs
+  - Corrigir o encaminhamento do modo estrito para a API Bedrock Converse
+  - Corrigir a versão do pytest para 9.0.3 devido à vulnerabilidade de segurança GHSA-6w46-j5rx-g56g
+  - Aumentar o limite inferior do OpenAI para >=2.0.0
+
+  ### Documentação
+  - Atualizar o changelog e a versão para v1.14.2a3
+
+  ## Contribuidores
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="13 abr 2026">
   ## v1.14.2a3
 

From 3a7c55051238aaad5cef3c908c70299552813ca8 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Wed, 15 Apr 2026 22:40:48 +0800
Subject: [PATCH 54/70] feat: bump versions to 1.14.2a5

---
 lib/crewai-files/src/crewai_files/__init__.py           | 2 +-
 lib/crewai-tools/pyproject.toml                         | 2 +-
 lib/crewai-tools/src/crewai_tools/__init__.py           | 2 +-
 lib/crewai/pyproject.toml                               | 2 +-
 lib/crewai/src/crewai/__init__.py                       | 2 +-
 lib/crewai/src/crewai/cli/templates/crew/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/flow/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/tool/pyproject.toml | 2 +-
 lib/devtools/src/crewai_devtools/__init__.py            | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/lib/crewai-files/src/crewai_files/__init__.py b/lib/crewai-files/src/crewai_files/__init__.py
index e31d070e0..e23afdc53 100644
--- a/lib/crewai-files/src/crewai_files/__init__.py
+++ b/lib/crewai-files/src/crewai_files/__init__.py
@@ -152,4 +152,4 @@ __all__ = [
     "wrap_file_source",
 ]
 
-__version__ = "1.14.2a4"
+__version__ = "1.14.2a5"
diff --git a/lib/crewai-tools/pyproject.toml b/lib/crewai-tools/pyproject.toml
index f1cba20b1..11f3e3174 100644
--- a/lib/crewai-tools/pyproject.toml
+++ b/lib/crewai-tools/pyproject.toml
@@ -10,7 +10,7 @@ requires-python = ">=3.10, <3.14"
 dependencies = [
     "pytube~=15.0.0",
     "requests>=2.33.0,<3",
-    "crewai==1.14.2a4",
+    "crewai==1.14.2a5",
     "tiktoken~=0.8.0",
     "beautifulsoup4~=4.13.4",
     "python-docx~=1.2.0",
diff --git a/lib/crewai-tools/src/crewai_tools/__init__.py b/lib/crewai-tools/src/crewai_tools/__init__.py
index 091fed900..9da9c4ec0 100644
--- a/lib/crewai-tools/src/crewai_tools/__init__.py
+++ b/lib/crewai-tools/src/crewai_tools/__init__.py
@@ -305,4 +305,4 @@ __all__ = [
     "ZapierActionTools",
 ]
 
-__version__ = "1.14.2a4"
+__version__ = "1.14.2a5"
diff --git a/lib/crewai/pyproject.toml b/lib/crewai/pyproject.toml
index 5049559fe..96c27d599 100644
--- a/lib/crewai/pyproject.toml
+++ b/lib/crewai/pyproject.toml
@@ -55,7 +55,7 @@ Repository = "https://github.com/crewAIInc/crewAI"
 
 [project.optional-dependencies]
 tools = [
-    "crewai-tools==1.14.2a4",
+    "crewai-tools==1.14.2a5",
 ]
 embeddings = [
     "tiktoken~=0.8.0"
diff --git a/lib/crewai/src/crewai/__init__.py b/lib/crewai/src/crewai/__init__.py
index d2215fbae..fc688bd1e 100644
--- a/lib/crewai/src/crewai/__init__.py
+++ b/lib/crewai/src/crewai/__init__.py
@@ -46,7 +46,7 @@ def _suppress_pydantic_deprecation_warnings() -> None:
 
 _suppress_pydantic_deprecation_warnings()
 
-__version__ = "1.14.2a4"
+__version__ = "1.14.2a5"
 _telemetry_submitted = False
 
 
diff --git a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
index fc465c102..13d2463c6 100644
--- a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a4"
+    "crewai[tools]==1.14.2a5"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
index 86f208cb5..af57d4c3a 100644
--- a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a4"
+    "crewai[tools]==1.14.2a5"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
index cb3441d56..f1c4f71a4 100644
--- a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
@@ -5,7 +5,7 @@ description = "Power up your crews with {{folder_name}}"
 readme = "README.md"
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a4"
+    "crewai[tools]==1.14.2a5"
 ]
 
 [tool.crewai]
diff --git a/lib/devtools/src/crewai_devtools/__init__.py b/lib/devtools/src/crewai_devtools/__init__.py
index 16c934202..07ed6976e 100644
--- a/lib/devtools/src/crewai_devtools/__init__.py
+++ b/lib/devtools/src/crewai_devtools/__init__.py
@@ -1,3 +1,3 @@
 """CrewAI development tools."""
 
-__version__ = "1.14.2a4"
+__version__ = "1.14.2a5"

From 1c90d574abb9f28dd09de8ded437bcad19fa97dc Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Wed, 15 Apr 2026 22:45:15 +0800
Subject: [PATCH 55/70] docs: update changelog and version for v1.14.2a5

---
 docs/ar/changelog.mdx    | 16 ++++++++++++++++
 docs/en/changelog.mdx    | 16 ++++++++++++++++
 docs/ko/changelog.mdx    | 16 ++++++++++++++++
 docs/pt-BR/changelog.mdx | 16 ++++++++++++++++
 4 files changed, 64 insertions(+)

diff --git a/docs/ar/changelog.mdx b/docs/ar/changelog.mdx
index b151cf950..90fa9c9bf 100644
--- a/docs/ar/changelog.mdx
+++ b/docs/ar/changelog.mdx
@@ -4,6 +4,22 @@ description: "تحديثات المنتج والتحسينات وإصلاحات
 icon: "clock"
 mode: "wide"
 ---
+<Update label="15 أبريل 2026">
+  ## v1.14.2a5
+
+  [عرض الإصدار على GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a5)
+
+  ## ما الذي تغير
+
+  ### الوثائق
+  - تحديث سجل التغييرات والإصدار لـ v1.14.2a4
+
+  ## المساهمون
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="15 أبريل 2026">
   ## v1.14.2a4
 
diff --git a/docs/en/changelog.mdx b/docs/en/changelog.mdx
index 24c62b85f..b60985baa 100644
--- a/docs/en/changelog.mdx
+++ b/docs/en/changelog.mdx
@@ -4,6 +4,22 @@ description: "Product updates, improvements, and bug fixes for CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="Apr 15, 2026">
+  ## v1.14.2a5
+
+  [View release on GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a5)
+
+  ## What's Changed
+
+  ### Documentation
+  - Update changelog and version for v1.14.2a4
+
+  ## Contributors
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="Apr 15, 2026">
   ## v1.14.2a4
 
diff --git a/docs/ko/changelog.mdx b/docs/ko/changelog.mdx
index 79c260bb4..1d953c52c 100644
--- a/docs/ko/changelog.mdx
+++ b/docs/ko/changelog.mdx
@@ -4,6 +4,22 @@ description: "CrewAI의 제품 업데이트, 개선 사항 및 버그 수정"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="2026년 4월 15일">
+  ## v1.14.2a5
+
+  [GitHub 릴리스 보기](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a5)
+
+  ## 변경 사항
+
+  ### 문서
+  - v1.14.2a4의 변경 로그 및 버전 업데이트
+
+  ## 기여자
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="2026년 4월 15일">
   ## v1.14.2a4
 
diff --git a/docs/pt-BR/changelog.mdx b/docs/pt-BR/changelog.mdx
index a8b9bc4c2..7c6a5c5b0 100644
--- a/docs/pt-BR/changelog.mdx
+++ b/docs/pt-BR/changelog.mdx
@@ -4,6 +4,22 @@ description: "Atualizações de produto, melhorias e correções do CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="15 abr 2026">
+  ## v1.14.2a5
+
+  [Ver release no GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2a5)
+
+  ## O que Mudou
+
+  ### Documentação
+  - Atualizar changelog e versão para v1.14.2a4
+
+  ## Contribuidores
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="15 abr 2026">
   ## v1.14.2a4
 

From 18d0fd6b80d50abf1cb78d5829e6e9ca780f8257 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 16 Apr 2026 04:11:08 +0800
Subject: [PATCH 56/70] fix: bump pypdf to 6.10.1 to patch GHSA-jj6c-8h6c-hppx

Fixes GHSA-jj6c-8h6c-hppx
---
 pyproject.toml |  6 +++---
 uv.lock        | 12 ++++++------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 881d7a887..74f2645ca 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -162,7 +162,7 @@ info = "Commits must follow Conventional Commits 1.0.0."
 
 
 [tool.uv]
-exclude-newer = "3 days"
+exclude-newer = "1 day"
 
 # composio-core pins rich<14 but textual requires rich>=14.
 # onnxruntime 1.24+ dropped Python 3.10 wheels; cap it so qdrant[fastembed] resolves on 3.10.
@@ -170,7 +170,7 @@ exclude-newer = "3 days"
 # langchain-core <1.2.28 has GHSA-926x-3r5x-gfhw (incomplete f-string validation).
 # transformers 4.57.6 has CVE-2026-1839; force 5.4+ (docling 2.84 allows huggingface-hub>=1).
 # cryptography 46.0.6 has CVE-2026-39892; force 46.0.7+.
-# pypdf <6.10.0 has CVE-2026-40260; force 6.10.0+.
+# pypdf <6.10.1 has CVE-2026-40260 and GHSA-jj6c-8h6c-hppx; force 6.10.1+.
 # uv <0.11.6 has GHSA-pjjw-68hj-v9mw; force 0.11.6+.
 override-dependencies = [
     "rich>=13.7.1",
@@ -180,7 +180,7 @@ override-dependencies = [
     "urllib3>=2.6.3",
     "transformers>=5.4.0; python_version >= '3.10'",
     "cryptography>=46.0.7",
-    "pypdf>=6.10.0,<7",
+    "pypdf>=6.10.1,<7",
     "uv>=0.11.6,<1",
 ]
 
diff --git a/uv.lock b/uv.lock
index d07aee183..ee32d7aaa 100644
--- a/uv.lock
+++ b/uv.lock
@@ -13,8 +13,8 @@ resolution-markers = [
 ]
 
 [options]
-exclude-newer = "2026-04-10T18:30:59.748668Z"
-exclude-newer-span = "P3D"
+exclude-newer = "2026-04-14T20:05:08.458275Z"
+exclude-newer-span = "P1D"
 
 [manifest]
 members = [
@@ -28,7 +28,7 @@ overrides = [
     { name = "langchain-core", specifier = ">=1.2.28,<2" },
     { name = "onnxruntime", marker = "python_full_version < '3.11'", specifier = "<1.24" },
     { name = "pillow", specifier = ">=12.1.1" },
-    { name = "pypdf", specifier = ">=6.10.0,<7" },
+    { name = "pypdf", specifier = ">=6.10.1,<7" },
     { name = "rich", specifier = ">=13.7.1" },
     { name = "transformers", marker = "python_full_version >= '3.10'", specifier = ">=5.4.0" },
     { name = "urllib3", specifier = ">=2.6.3" },
@@ -6727,14 +6727,14 @@ wheels = [
 
 [[package]]
 name = "pypdf"
-version = "6.10.0"
+version = "6.10.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/b8/9f/ca96abf18683ca12602065e4ed2bec9050b672c87d317f1079abc7b6d993/pypdf-6.10.0.tar.gz", hash = "sha256:4c5a48ba258c37024ec2505f7e8fd858525f5502784a2e1c8d415604af29f6ef", size = 5314833, upload-time = "2026-04-10T09:34:57.102Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/66/79/f2730c42ec7891a75a2fcea2eb4f356872bcbc671b711418060424796612/pypdf-6.10.1.tar.gz", hash = "sha256:62e6ca7f65aaa28b3d192addb44f97296e4be1748f57ed0f4efb2d4915841880", size = 5315704, upload-time = "2026-04-14T12:55:20.996Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/55/f2/7ebe366f633f30a6ad105f650f44f24f98cb1335c4157d21ae47138b3482/pypdf-6.10.0-py3-none-any.whl", hash = "sha256:90005e959e1596c6e6c84c8b0ad383285b3e17011751cedd17f2ce8fcdfc86de", size = 334459, upload-time = "2026-04-10T09:34:54.966Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/04/e3aa7f1f14dbc53429cae34666261eb935d99bd61d24756ab94d7e0309da/pypdf-6.10.1-py3-none-any.whl", hash = "sha256:6331940d3bfe75b7e6601d35db7adabab5fc1d716efaeb384e3c0c3957d033de", size = 335606, upload-time = "2026-04-14T12:55:18.941Z" },
 ]
 
 [[package]]

From 74d061e994d4907073e22990ded0a10cb9da8494 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 16 Apr 2026 04:25:35 +0800
Subject: [PATCH 57/70] fix: bump python-multipart to 0.0.26 to patch
 GHSA-mj87-hwqh-73pj

Fixes GHSA-mj87-hwqh-73pj
---
 pyproject.toml | 2 ++
 uv.lock        | 9 +++++----
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 74f2645ca..40fc25cbe 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -172,6 +172,7 @@ exclude-newer = "1 day"
 # cryptography 46.0.6 has CVE-2026-39892; force 46.0.7+.
 # pypdf <6.10.1 has CVE-2026-40260 and GHSA-jj6c-8h6c-hppx; force 6.10.1+.
 # uv <0.11.6 has GHSA-pjjw-68hj-v9mw; force 0.11.6+.
+# python-multipart <0.0.26 has GHSA-mj87-hwqh-73pj; force 0.0.26+.
 override-dependencies = [
     "rich>=13.7.1",
     "onnxruntime<1.24; python_version < '3.11'",
@@ -182,6 +183,7 @@ override-dependencies = [
     "cryptography>=46.0.7",
     "pypdf>=6.10.1,<7",
     "uv>=0.11.6,<1",
+    "python-multipart>=0.0.26,<1",
 ]
 
 [tool.uv.workspace]
diff --git a/uv.lock b/uv.lock
index ee32d7aaa..4668670fd 100644
--- a/uv.lock
+++ b/uv.lock
@@ -13,7 +13,7 @@ resolution-markers = [
 ]
 
 [options]
-exclude-newer = "2026-04-14T20:05:08.458275Z"
+exclude-newer = "2026-04-14T20:20:18.36862Z"
 exclude-newer-span = "P1D"
 
 [manifest]
@@ -29,6 +29,7 @@ overrides = [
     { name = "onnxruntime", marker = "python_full_version < '3.11'", specifier = "<1.24" },
     { name = "pillow", specifier = ">=12.1.1" },
     { name = "pypdf", specifier = ">=6.10.1,<7" },
+    { name = "python-multipart", specifier = ">=0.0.26,<1" },
     { name = "rich", specifier = ">=13.7.1" },
     { name = "transformers", marker = "python_full_version >= '3.10'", specifier = ">=5.4.0" },
     { name = "urllib3", specifier = ">=2.6.3" },
@@ -6988,11 +6989,11 @@ wheels = [
 
 [[package]]
 name = "python-multipart"
-version = "0.0.24"
+version = "0.0.26"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/8a/45/e23b5dc14ddb9918ae4a625379506b17b6f8fc56ca1d82db62462f59aea6/python_multipart-0.0.24.tar.gz", hash = "sha256:9574c97e1c026e00bc30340ef7c7d76739512ab4dfd428fec8c330fa6a5cc3c8", size = 37695, upload-time = "2026-04-05T20:49:13.829Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/88/71/b145a380824a960ebd60e1014256dbb7d2253f2316ff2d73dfd8928ec2c3/python_multipart-0.0.26.tar.gz", hash = "sha256:08fadc45918cd615e26846437f50c5d6d23304da32c341f289a617127b081f17", size = 43501, upload-time = "2026-04-10T14:09:59.473Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a3/73/89930efabd4da63cea44a3f438aeb753d600123570e6d6264e763617a9ce/python_multipart-0.0.24-py3-none-any.whl", hash = "sha256:9b110a98db707df01a53c194f0af075e736a770dc5058089650d70b4a182f950", size = 24420, upload-time = "2026-04-05T20:49:12.555Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/22/f1925cdda983ab66fc8ec6ec8014b959262747e58bdca26a4e3d1da29d56/python_multipart-0.0.26-py3-none-any.whl", hash = "sha256:c0b169f8c4484c13b0dcf2ef0ec3a4adb255c4b7d18d8e420477d2b1dd03f185", size = 28847, upload-time = "2026-04-10T14:09:58.131Z" },
 ]
 
 [[package]]

From 29b5531f7871feb7b1dc1c419a3e21c65bb39c62 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 16 Apr 2026 05:03:00 +0800
Subject: [PATCH 58/70] fix: handle cyclic JSON schemas in MCP tool resolution

---
 lib/crewai/src/crewai/mcp/tool_resolver.py    |  15 +-
 .../crewai/utilities/pydantic_schema_utils.py | 265 +++++++++++++++---
 2 files changed, 245 insertions(+), 35 deletions(-)

diff --git a/lib/crewai/src/crewai/mcp/tool_resolver.py b/lib/crewai/src/crewai/mcp/tool_resolver.py
index 92b1e488c..a394741fd 100644
--- a/lib/crewai/src/crewai/mcp/tool_resolver.py
+++ b/lib/crewai/src/crewai/mcp/tool_resolver.py
@@ -417,9 +417,18 @@ class MCPToolResolver:
 
                 args_schema = None
                 if tool_def.get("inputSchema"):
-                    args_schema = self._json_schema_to_pydantic(
-                        tool_name, tool_def["inputSchema"]
-                    )
+                    try:
+                        args_schema = self._json_schema_to_pydantic(
+                            tool_name, tool_def["inputSchema"]
+                        )
+                    except Exception as e:
+                        self._logger.log(
+                            "warning",
+                            f"Failed to build args schema for MCP tool "
+                            f"'{tool_name}': {e}. Registering tool without a "
+                            "typed schema.",
+                        )
+                        args_schema = None
 
                 tool_schema = {
                     "description": tool_def.get("description", ""),
diff --git a/lib/crewai/src/crewai/utilities/pydantic_schema_utils.py b/lib/crewai/src/crewai/utilities/pydantic_schema_utils.py
index 4c69c9bf6..180181fa7 100644
--- a/lib/crewai/src/crewai/utilities/pydantic_schema_utils.py
+++ b/lib/crewai/src/crewai/utilities/pydantic_schema_utils.py
@@ -19,7 +19,18 @@ from collections.abc import Callable
 from copy import deepcopy
 import datetime
 import logging
-from typing import TYPE_CHECKING, Annotated, Any, Final, Literal, TypedDict, Union, cast
+from typing import (
+    TYPE_CHECKING,
+    Annotated,
+    Any,
+    Final,
+    ForwardRef,
+    Literal,
+    Optional,
+    TypedDict,
+    Union,
+    cast,
+)
 import uuid
 
 import jsonref  # type: ignore[import-untyped]
@@ -99,15 +110,22 @@ def resolve_refs(schema: dict[str, Any]) -> dict[str, Any]:
     """
     defs = schema.get("$defs", {})
     schema_copy = deepcopy(schema)
+    expanding: set[str] = set()
 
     def _resolve(node: Any) -> Any:
         if isinstance(node, dict):
             ref = node.get("$ref")
             if isinstance(ref, str) and ref.startswith("#/$defs/"):
                 def_name = ref.replace("#/$defs/", "")
-                if def_name in defs:
+                if def_name not in defs:
+                    raise KeyError(f"Definition '{def_name}' not found in $defs.")
+                if def_name in expanding:
+                    return {}
+                expanding.add(def_name)
+                try:
                     return _resolve(deepcopy(defs[def_name]))
-                raise KeyError(f"Definition '{def_name}' not found in $defs.")
+                finally:
+                    expanding.discard(def_name)
             return {k: _resolve(v) for k, v in node.items()}
 
         if isinstance(node, list):
@@ -119,7 +137,11 @@ def resolve_refs(schema: dict[str, Any]) -> dict[str, Any]:
 
 
 def add_key_in_dict_recursively(
-    d: dict[str, Any], key: str, value: Any, criteria: Callable[[dict[str, Any]], bool]
+    d: dict[str, Any],
+    key: str,
+    value: Any,
+    criteria: Callable[[dict[str, Any]], bool],
+    _seen: set[int] | None = None,
 ) -> dict[str, Any]:
     """Recursively adds a key/value pair to all nested dicts matching `criteria`.
 
@@ -128,22 +150,31 @@ def add_key_in_dict_recursively(
         key: The key to add.
         value: The value to add.
         criteria: A function that returns True for dicts that should receive the key.
+        _seen: Internal set of visited ``id()``s, used to guard cyclic schemas.
 
     Returns:
         The modified dictionary.
     """
+    if _seen is None:
+        _seen = set()
     if isinstance(d, dict):
+        if id(d) in _seen:
+            return d
+        _seen.add(id(d))
         if criteria(d) and key not in d:
             d[key] = value
         for v in d.values():
-            add_key_in_dict_recursively(v, key, value, criteria)
+            add_key_in_dict_recursively(v, key, value, criteria, _seen)
     elif isinstance(d, list):
+        if id(d) in _seen:
+            return d
+        _seen.add(id(d))
         for i in d:
-            add_key_in_dict_recursively(i, key, value, criteria)
+            add_key_in_dict_recursively(i, key, value, criteria, _seen)
     return d
 
 
-def force_additional_properties_false(d: Any) -> Any:
+def force_additional_properties_false(d: Any, _seen: set[int] | None = None) -> Any:
     """Force additionalProperties=false on all object-type dicts recursively.
 
     OpenAI strict mode requires all objects to have additionalProperties=false.
@@ -154,11 +185,17 @@ def force_additional_properties_false(d: Any) -> Any:
 
     Args:
         d: The dictionary/list to modify.
+        _seen: Internal set of visited ``id()``s, used to guard cyclic schemas.
 
     Returns:
         The modified dictionary/list.
     """
+    if _seen is None:
+        _seen = set()
     if isinstance(d, dict):
+        if id(d) in _seen:
+            return d
+        _seen.add(id(d))
         if d.get("type") == "object":
             d["additionalProperties"] = False
             if "properties" not in d:
@@ -166,10 +203,13 @@ def force_additional_properties_false(d: Any) -> Any:
             if "required" not in d:
                 d["required"] = []
         for v in d.values():
-            force_additional_properties_false(v)
+            force_additional_properties_false(v, _seen)
     elif isinstance(d, list):
+        if id(d) in _seen:
+            return d
+        _seen.add(id(d))
         for i in d:
-            force_additional_properties_false(i)
+            force_additional_properties_false(i, _seen)
     return d
 
 
@@ -183,7 +223,7 @@ OPENAI_SUPPORTED_FORMATS: Final[
 }
 
 
-def strip_unsupported_formats(d: Any) -> Any:
+def strip_unsupported_formats(d: Any, _seen: set[int] | None = None) -> Any:
     """Remove format annotations that OpenAI strict mode doesn't support.
 
     OpenAI only supports: date-time, date, time, duration.
@@ -191,11 +231,17 @@ def strip_unsupported_formats(d: Any) -> Any:
 
     Args:
         d: The dictionary/list to modify.
+        _seen: Internal set of visited ``id()``s, used to guard cyclic schemas.
 
     Returns:
         The modified dictionary/list.
     """
+    if _seen is None:
+        _seen = set()
     if isinstance(d, dict):
+        if id(d) in _seen:
+            return d
+        _seen.add(id(d))
         format_value = d.get("format")
         if (
             isinstance(format_value, str)
@@ -203,14 +249,17 @@ def strip_unsupported_formats(d: Any) -> Any:
         ):
             del d["format"]
         for v in d.values():
-            strip_unsupported_formats(v)
+            strip_unsupported_formats(v, _seen)
     elif isinstance(d, list):
+        if id(d) in _seen:
+            return d
+        _seen.add(id(d))
         for i in d:
-            strip_unsupported_formats(i)
+            strip_unsupported_formats(i, _seen)
     return d
 
 
-def ensure_type_in_schemas(d: Any) -> Any:
+def ensure_type_in_schemas(d: Any, _seen: set[int] | None = None) -> Any:
     """Ensure all schema objects in anyOf/oneOf have a 'type' key.
 
     OpenAI strict mode requires every schema to have a 'type' key.
@@ -218,11 +267,17 @@ def ensure_type_in_schemas(d: Any) -> Any:
 
     Args:
         d: The dictionary/list to modify.
+        _seen: Internal set of visited ``id()``s, used to guard cyclic schemas.
 
     Returns:
         The modified dictionary/list.
     """
+    if _seen is None:
+        _seen = set()
     if isinstance(d, dict):
+        if id(d) in _seen:
+            return d
+        _seen.add(id(d))
         for key in ("anyOf", "oneOf"):
             if key in d:
                 schema_list = d[key]
@@ -230,12 +285,15 @@ def ensure_type_in_schemas(d: Any) -> Any:
                     if isinstance(schema, dict) and schema == {}:
                         schema_list[i] = {"type": "object"}
                     else:
-                        ensure_type_in_schemas(schema)
+                        ensure_type_in_schemas(schema, _seen)
         for v in d.values():
-            ensure_type_in_schemas(v)
+            ensure_type_in_schemas(v, _seen)
     elif isinstance(d, list):
+        if id(d) in _seen:
+            return d
+        _seen.add(id(d))
         for item in d:
-            ensure_type_in_schemas(item)
+            ensure_type_in_schemas(item, _seen)
     return d
 
 
@@ -318,7 +376,9 @@ def add_const_to_oneof_variants(schema: dict[str, Any]) -> dict[str, Any]:
     return _process_oneof(deepcopy(schema))
 
 
-def convert_oneof_to_anyof(schema: dict[str, Any]) -> dict[str, Any]:
+def convert_oneof_to_anyof(
+    schema: dict[str, Any], _seen: set[int] | None = None
+) -> dict[str, Any]:
     """Convert oneOf to anyOf for OpenAI compatibility.
 
     OpenAI's Structured Outputs support anyOf better than oneOf.
@@ -326,26 +386,37 @@ def convert_oneof_to_anyof(schema: dict[str, Any]) -> dict[str, Any]:
 
     Args:
         schema: JSON schema dictionary.
+        _seen: Internal set of visited ``id()``s, used to guard cyclic schemas.
 
     Returns:
         Modified schema with anyOf instead of oneOf.
     """
+    if _seen is None:
+        _seen = set()
     if isinstance(schema, dict):
+        if id(schema) in _seen:
+            return schema
+        _seen.add(id(schema))
         if "oneOf" in schema:
             schema["anyOf"] = schema.pop("oneOf")
 
         for value in schema.values():
             if isinstance(value, dict):
-                convert_oneof_to_anyof(value)
+                convert_oneof_to_anyof(value, _seen)
             elif isinstance(value, list):
+                if id(value) in _seen:
+                    continue
+                _seen.add(id(value))
                 for item in value:
                     if isinstance(item, dict):
-                        convert_oneof_to_anyof(item)
+                        convert_oneof_to_anyof(item, _seen)
 
     return schema
 
 
-def ensure_all_properties_required(schema: dict[str, Any]) -> dict[str, Any]:
+def ensure_all_properties_required(
+    schema: dict[str, Any], _seen: set[int] | None = None
+) -> dict[str, Any]:
     """Ensure all properties are in the required array for OpenAI strict mode.
 
     OpenAI's strict structured outputs require all properties to be listed
@@ -354,11 +425,17 @@ def ensure_all_properties_required(schema: dict[str, Any]) -> dict[str, Any]:
 
     Args:
         schema: JSON schema dictionary.
+        _seen: Internal set of visited ``id()``s, used to guard cyclic schemas.
 
     Returns:
         Modified schema with all properties marked as required.
     """
+    if _seen is None:
+        _seen = set()
     if isinstance(schema, dict):
+        if id(schema) in _seen:
+            return schema
+        _seen.add(id(schema))
         if schema.get("type") == "object" and "properties" in schema:
             properties = schema["properties"]
             if properties:
@@ -366,16 +443,21 @@ def ensure_all_properties_required(schema: dict[str, Any]) -> dict[str, Any]:
 
         for value in schema.values():
             if isinstance(value, dict):
-                ensure_all_properties_required(value)
+                ensure_all_properties_required(value, _seen)
             elif isinstance(value, list):
+                if id(value) in _seen:
+                    continue
+                _seen.add(id(value))
                 for item in value:
                     if isinstance(item, dict):
-                        ensure_all_properties_required(item)
+                        ensure_all_properties_required(item, _seen)
 
     return schema
 
 
-def strip_null_from_types(schema: dict[str, Any]) -> dict[str, Any]:
+def strip_null_from_types(
+    schema: dict[str, Any], _seen: set[int] | None = None
+) -> dict[str, Any]:
     """Remove null type from anyOf/type arrays.
 
     Pydantic generates `T | None` for optional fields, which creates schemas with
@@ -384,11 +466,17 @@ def strip_null_from_types(schema: dict[str, Any]) -> dict[str, Any]:
 
     Args:
         schema: JSON schema dictionary.
+        _seen: Internal set of visited ``id()``s, used to guard cyclic schemas.
 
     Returns:
         Modified schema with null types removed.
     """
+    if _seen is None:
+        _seen = set()
     if isinstance(schema, dict):
+        if id(schema) in _seen:
+            return schema
+        _seen.add(id(schema))
         if "anyOf" in schema:
             any_of = schema["anyOf"]
             non_null = [opt for opt in any_of if opt.get("type") != "null"]
@@ -408,11 +496,14 @@ def strip_null_from_types(schema: dict[str, Any]) -> dict[str, Any]:
 
         for value in schema.values():
             if isinstance(value, dict):
-                strip_null_from_types(value)
+                strip_null_from_types(value, _seen)
             elif isinstance(value, list):
+                if id(value) in _seen:
+                    continue
+                _seen.add(id(value))
                 for item in value:
                     if isinstance(item, dict):
-                        strip_null_from_types(item)
+                        strip_null_from_types(item, _seen)
 
     return schema
 
@@ -451,16 +542,26 @@ _CLAUDE_STRICT_UNSUPPORTED: Final[tuple[str, ...]] = (
 )
 
 
-def _strip_keys_recursive(d: Any, keys: tuple[str, ...]) -> Any:
+def _strip_keys_recursive(
+    d: Any, keys: tuple[str, ...], _seen: set[int] | None = None
+) -> Any:
     """Recursively delete a fixed set of keys from a schema."""
+    if _seen is None:
+        _seen = set()
     if isinstance(d, dict):
+        if id(d) in _seen:
+            return d
+        _seen.add(id(d))
         for key in keys:
             d.pop(key, None)
         for v in d.values():
-            _strip_keys_recursive(v, keys)
+            _strip_keys_recursive(v, keys, _seen)
     elif isinstance(d, list):
+        if id(d) in _seen:
+            return d
+        _seen.add(id(d))
         for i in d:
-            _strip_keys_recursive(i, keys)
+            _strip_keys_recursive(i, keys, _seen)
     return d
 
 
@@ -719,12 +820,70 @@ def create_model_from_schema(  # type: ignore[no-any-unimported]
     json_schema = force_additional_properties_false(json_schema)
     effective_root = force_additional_properties_false(effective_root)
 
+    in_progress: dict[int, Any] = {}
+    model = _build_model_from_schema(
+        json_schema,
+        effective_root,
+        model_name=model_name,
+        enrich_descriptions=enrich_descriptions,
+        in_progress=in_progress,
+        __config__=__config__,
+        __base__=__base__,
+        __module__=__module__,
+        __validators__=__validators__,
+        __cls_kwargs__=__cls_kwargs__,
+    )
+
+    types_namespace: dict[str, Any] = {
+        entry.__name__: entry
+        for entry in in_progress.values()
+        if isinstance(entry, type) and issubclass(entry, BaseModel)
+    }
+    for entry in in_progress.values():
+        if (
+            isinstance(entry, type)
+            and issubclass(entry, BaseModel)
+            and not getattr(entry, "__pydantic_complete__", True)
+        ):
+            try:
+                entry.model_rebuild(_types_namespace=types_namespace)
+            except Exception as e:
+                logger.debug("model_rebuild failed for %s: %s", entry.__name__, e)
+    return model
+
+
+def _build_model_from_schema(  # type: ignore[no-any-unimported]
+    json_schema: dict[str, Any],
+    effective_root: dict[str, Any],
+    *,
+    model_name: str | None,
+    enrich_descriptions: bool,
+    in_progress: dict[int, Any],
+    __config__: ConfigDict | None = None,
+    __base__: type[BaseModel] | None = None,
+    __module__: str = __name__,
+    __validators__: dict[str, AnyClassMethod] | None = None,
+    __cls_kwargs__: dict[str, Any] | None = None,
+) -> type[BaseModel]:
+    """Inner builder shared by the public entry point and recursive nested-object creation.
+
+    Preprocessing via ``jsonref.replace_refs`` and the sanitization walkers is
+    run once by the public entry; this helper walks the already-normalized
+    schema and emits Pydantic models. ``in_progress`` maps ``id(schema)`` to
+    the model being built for that schema, so a cyclic ``$ref`` graph
+    degrades to a ``ForwardRef`` back-edge instead of blowing the stack.
+    """
+    original_id = id(json_schema)
     if "allOf" in json_schema:
         json_schema = _merge_all_of_schemas(json_schema["allOf"], effective_root)
-        if "title" not in json_schema and "title" in (root_schema or {}):
-            json_schema["title"] = (root_schema or {}).get("title")
 
     effective_name = model_name or json_schema.get("title") or "DynamicModel"
+
+    schema_id = id(json_schema)
+    in_progress[original_id] = effective_name
+    if schema_id != original_id:
+        in_progress[schema_id] = effective_name
+
     field_definitions = {
         name: _json_schema_to_pydantic_field(
             name,
@@ -732,13 +891,14 @@ def create_model_from_schema(  # type: ignore[no-any-unimported]
             json_schema.get("required", []),
             effective_root,
             enrich_descriptions=enrich_descriptions,
+            in_progress=in_progress,
         )
         for name, prop in (json_schema.get("properties", {}) or {}).items()
     }
 
     effective_config = __config__ or ConfigDict(extra="forbid")
 
-    return create_model_base(
+    model = create_model_base(
         effective_name,
         __config__=effective_config,
         __base__=__base__,
@@ -747,6 +907,10 @@ def create_model_from_schema(  # type: ignore[no-any-unimported]
         __cls_kwargs__=__cls_kwargs__,
         **field_definitions,
     )
+    in_progress[original_id] = model
+    if schema_id != original_id:
+        in_progress[schema_id] = model
+    return model
 
 
 def _json_schema_to_pydantic_field(
@@ -756,6 +920,7 @@ def _json_schema_to_pydantic_field(
     root_schema: dict[str, Any],
     *,
     enrich_descriptions: bool = False,
+    in_progress: dict[int, Any] | None = None,
 ) -> Any:
     """Convert a JSON schema property to a Pydantic field definition.
 
@@ -774,6 +939,7 @@ def _json_schema_to_pydantic_field(
         root_schema,
         name_=name.title(),
         enrich_descriptions=enrich_descriptions,
+        in_progress=in_progress,
     )
     is_required = name in required
 
@@ -833,7 +999,7 @@ def _json_schema_to_pydantic_field(
             field_params["pattern"] = json_schema["pattern"]
 
     if not is_required:
-        type_ = type_ | None
+        type_ = Optional[type_]  # noqa: UP045 - ForwardRef does not support `|`
 
     if schema_extra:
         field_params["json_schema_extra"] = schema_extra
@@ -906,6 +1072,7 @@ def _json_schema_to_pydantic_type(
     *,
     name_: str | None = None,
     enrich_descriptions: bool = False,
+    in_progress: dict[int, Any] | None = None,
 ) -> Any:
     """Convert a JSON schema to a Python/Pydantic type.
 
@@ -914,10 +1081,23 @@ def _json_schema_to_pydantic_type(
         root_schema: The root schema for resolving $ref.
         name_: Optional name for nested models.
         enrich_descriptions: Propagated to nested model creation.
+        in_progress: Map of ``id(schema_dict)`` to the Pydantic model
+            currently being built for that schema, or to a placeholder name
+            as a plain ``str`` while the model is still being constructed.
+            Populated by :func:`_build_model_from_schema`. Enables cycle
+            detection so a self-referential ``$ref`` graph resolves to a
+            :class:`ForwardRef` back-edge rather than recursing forever.
 
     Returns:
         A Python type corresponding to the JSON schema.
     """
+    if in_progress is not None:
+        cached = in_progress.get(id(json_schema))
+        if isinstance(cached, str):
+            return ForwardRef(cached)
+        if cached is not None:
+            return cached
+
     ref = json_schema.get("$ref")
     if ref:
         ref_schema = _resolve_ref(ref, root_schema)
@@ -926,6 +1106,7 @@ def _json_schema_to_pydantic_type(
             root_schema,
             name_=name_,
             enrich_descriptions=enrich_descriptions,
+            in_progress=in_progress,
         )
 
     enum_values = json_schema.get("enum")
@@ -945,6 +1126,7 @@ def _json_schema_to_pydantic_type(
                 root_schema,
                 name_=f"{name_ or 'Union'}Option{i}",
                 enrich_descriptions=enrich_descriptions,
+                in_progress=in_progress,
             )
             for i, schema in enumerate(any_of_schemas)
         ]
@@ -958,6 +1140,15 @@ def _json_schema_to_pydantic_type(
                 root_schema,
                 name_=name_,
                 enrich_descriptions=enrich_descriptions,
+                in_progress=in_progress,
+            )
+        if in_progress is not None:
+            return _build_model_from_schema(
+                json_schema,
+                root_schema,
+                model_name=name_,
+                enrich_descriptions=enrich_descriptions,
+                in_progress=in_progress,
             )
         merged = _merge_all_of_schemas(all_of_schemas, root_schema)
         return _json_schema_to_pydantic_type(
@@ -965,6 +1156,7 @@ def _json_schema_to_pydantic_type(
             root_schema,
             name_=name_,
             enrich_descriptions=enrich_descriptions,
+            in_progress=in_progress,
         )
 
     type_ = json_schema.get("type")
@@ -985,12 +1177,21 @@ def _json_schema_to_pydantic_type(
                 root_schema,
                 name_=name_,
                 enrich_descriptions=enrich_descriptions,
+                in_progress=in_progress,
             )
             return list[item_type]  # type: ignore[valid-type]
         return list
     if type_ == "object":
         properties = json_schema.get("properties")
         if properties:
+            if in_progress is not None:
+                return _build_model_from_schema(
+                    json_schema,
+                    root_schema,
+                    model_name=name_,
+                    enrich_descriptions=enrich_descriptions,
+                    in_progress=in_progress,
+                )
             json_schema_ = json_schema.copy()
             if json_schema_.get("title") is None:
                 json_schema_["title"] = name_ or "DynamicModel"

From aa28eeab6a1fe16bfcbbe43cec91a02073d9e360 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 16 Apr 2026 05:18:24 +0800
Subject: [PATCH 59/70] feat: bump versions to 1.14.2rc1

---
 lib/crewai-files/src/crewai_files/__init__.py           | 2 +-
 lib/crewai-tools/pyproject.toml                         | 2 +-
 lib/crewai-tools/src/crewai_tools/__init__.py           | 2 +-
 lib/crewai/pyproject.toml                               | 2 +-
 lib/crewai/src/crewai/__init__.py                       | 2 +-
 lib/crewai/src/crewai/cli/templates/crew/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/flow/pyproject.toml | 2 +-
 lib/crewai/src/crewai/cli/templates/tool/pyproject.toml | 2 +-
 lib/devtools/src/crewai_devtools/__init__.py            | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/lib/crewai-files/src/crewai_files/__init__.py b/lib/crewai-files/src/crewai_files/__init__.py
index e23afdc53..9cfa885c2 100644
--- a/lib/crewai-files/src/crewai_files/__init__.py
+++ b/lib/crewai-files/src/crewai_files/__init__.py
@@ -152,4 +152,4 @@ __all__ = [
     "wrap_file_source",
 ]
 
-__version__ = "1.14.2a5"
+__version__ = "1.14.2rc1"
diff --git a/lib/crewai-tools/pyproject.toml b/lib/crewai-tools/pyproject.toml
index 11f3e3174..5547d96ef 100644
--- a/lib/crewai-tools/pyproject.toml
+++ b/lib/crewai-tools/pyproject.toml
@@ -10,7 +10,7 @@ requires-python = ">=3.10, <3.14"
 dependencies = [
     "pytube~=15.0.0",
     "requests>=2.33.0,<3",
-    "crewai==1.14.2a5",
+    "crewai==1.14.2rc1",
     "tiktoken~=0.8.0",
     "beautifulsoup4~=4.13.4",
     "python-docx~=1.2.0",
diff --git a/lib/crewai-tools/src/crewai_tools/__init__.py b/lib/crewai-tools/src/crewai_tools/__init__.py
index 9da9c4ec0..d9ce4e9c2 100644
--- a/lib/crewai-tools/src/crewai_tools/__init__.py
+++ b/lib/crewai-tools/src/crewai_tools/__init__.py
@@ -305,4 +305,4 @@ __all__ = [
     "ZapierActionTools",
 ]
 
-__version__ = "1.14.2a5"
+__version__ = "1.14.2rc1"
diff --git a/lib/crewai/pyproject.toml b/lib/crewai/pyproject.toml
index 96c27d599..350e1b65f 100644
--- a/lib/crewai/pyproject.toml
+++ b/lib/crewai/pyproject.toml
@@ -55,7 +55,7 @@ Repository = "https://github.com/crewAIInc/crewAI"
 
 [project.optional-dependencies]
 tools = [
-    "crewai-tools==1.14.2a5",
+    "crewai-tools==1.14.2rc1",
 ]
 embeddings = [
     "tiktoken~=0.8.0"
diff --git a/lib/crewai/src/crewai/__init__.py b/lib/crewai/src/crewai/__init__.py
index fc688bd1e..14ef26727 100644
--- a/lib/crewai/src/crewai/__init__.py
+++ b/lib/crewai/src/crewai/__init__.py
@@ -46,7 +46,7 @@ def _suppress_pydantic_deprecation_warnings() -> None:
 
 _suppress_pydantic_deprecation_warnings()
 
-__version__ = "1.14.2a5"
+__version__ = "1.14.2rc1"
 _telemetry_submitted = False
 
 
diff --git a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
index 13d2463c6..01ce3f12b 100644
--- a/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/crew/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a5"
+    "crewai[tools]==1.14.2rc1"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
index af57d4c3a..b91fcbaf1 100644
--- a/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/flow/pyproject.toml
@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a5"
+    "crewai[tools]==1.14.2rc1"
 ]
 
 [project.scripts]
diff --git a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
index f1c4f71a4..1089ad5c0 100644
--- a/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
+++ b/lib/crewai/src/crewai/cli/templates/tool/pyproject.toml
@@ -5,7 +5,7 @@ description = "Power up your crews with {{folder_name}}"
 readme = "README.md"
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]==1.14.2a5"
+    "crewai[tools]==1.14.2rc1"
 ]
 
 [tool.crewai]
diff --git a/lib/devtools/src/crewai_devtools/__init__.py b/lib/devtools/src/crewai_devtools/__init__.py
index 07ed6976e..db857f660 100644
--- a/lib/devtools/src/crewai_devtools/__init__.py
+++ b/lib/devtools/src/crewai_devtools/__init__.py
@@ -1,3 +1,3 @@
 """CrewAI development tools."""
 
-__version__ = "1.14.2a5"
+__version__ = "1.14.2rc1"

From 0bb6faa9d314cdba9fc17e74655795a3a2dbadf4 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 16 Apr 2026 05:24:57 +0800
Subject: [PATCH 60/70] docs: update changelog and version for v1.14.2rc1

---
 docs/ar/changelog.mdx    | 21 +++++++++++++++++++++
 docs/en/changelog.mdx    | 21 +++++++++++++++++++++
 docs/ko/changelog.mdx    | 21 +++++++++++++++++++++
 docs/pt-BR/changelog.mdx | 21 +++++++++++++++++++++
 4 files changed, 84 insertions(+)

diff --git a/docs/ar/changelog.mdx b/docs/ar/changelog.mdx
index 90fa9c9bf..7b4ad9f17 100644
--- a/docs/ar/changelog.mdx
+++ b/docs/ar/changelog.mdx
@@ -4,6 +4,27 @@ description: "تحديثات المنتج والتحسينات وإصلاحات
 icon: "clock"
 mode: "wide"
 ---
+<Update label="16 أبريل 2026">
+  ## v1.14.2rc1
+
+  [عرض الإصدار على GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2rc1)
+
+  ## ما الذي تغير
+
+  ### إصلاحات الأخطاء
+  - إصلاح معالجة مخططات JSON الدائرية في أداة MCP
+  - إصلاح ثغرة أمنية من خلال تحديث python-multipart إلى 0.0.26
+  - إصلاح ثغرة أمنية من خلال تحديث pypdf إلى 6.10.1
+
+  ### الوثائق
+  - تحديث سجل التغييرات والإصدار لـ v1.14.2a5
+
+  ## المساهمون
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="15 أبريل 2026">
   ## v1.14.2a5
 
diff --git a/docs/en/changelog.mdx b/docs/en/changelog.mdx
index b60985baa..d1a72c2ca 100644
--- a/docs/en/changelog.mdx
+++ b/docs/en/changelog.mdx
@@ -4,6 +4,27 @@ description: "Product updates, improvements, and bug fixes for CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="Apr 16, 2026">
+  ## v1.14.2rc1
+
+  [View release on GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2rc1)
+
+  ## What's Changed
+
+  ### Bug Fixes
+  - Fix handling of cyclic JSON schemas in MCP tool resolution
+  - Fix vulnerability by bumping python-multipart to 0.0.26
+  - Fix vulnerability by bumping pypdf to 6.10.1
+
+  ### Documentation
+  - Update changelog and version for v1.14.2a5
+
+  ## Contributors
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="Apr 15, 2026">
   ## v1.14.2a5
 
diff --git a/docs/ko/changelog.mdx b/docs/ko/changelog.mdx
index 1d953c52c..5cb685f3c 100644
--- a/docs/ko/changelog.mdx
+++ b/docs/ko/changelog.mdx
@@ -4,6 +4,27 @@ description: "CrewAI의 제품 업데이트, 개선 사항 및 버그 수정"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="2026년 4월 16일">
+  ## v1.14.2rc1
+
+  [GitHub 릴리스 보기](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2rc1)
+
+  ## 변경 사항
+
+  ### 버그 수정
+  - MCP 도구 해상도에서 순환 JSON 스키마 처리 수정
+  - python-multipart를 0.0.26으로 업데이트하여 취약점 수정
+  - pypdf를 6.10.1로 업데이트하여 취약점 수정
+
+  ### 문서
+  - v1.14.2a5에 대한 변경 로그 및 버전 업데이트
+
+  ## 기여자
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="2026년 4월 15일">
   ## v1.14.2a5
 
diff --git a/docs/pt-BR/changelog.mdx b/docs/pt-BR/changelog.mdx
index 7c6a5c5b0..02ab715fb 100644
--- a/docs/pt-BR/changelog.mdx
+++ b/docs/pt-BR/changelog.mdx
@@ -4,6 +4,27 @@ description: "Atualizações de produto, melhorias e correções do CrewAI"
 icon: "clock"
 mode: "wide"
 ---
+<Update label="16 abr 2026">
+  ## v1.14.2rc1
+
+  [Ver release no GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.14.2rc1)
+
+  ## O que Mudou
+
+  ### Correções de Bugs
+  - Corrigir o manuseio de esquemas JSON cíclicos na resolução da ferramenta MCP
+  - Corrigir vulnerabilidade atualizando python-multipart para 0.0.26
+  - Corrigir vulnerabilidade atualizando pypdf para 6.10.1
+
+  ### Documentação
+  - Atualizar o changelog e a versão para v1.14.2a5
+
+  ## Contribuidores
+
+  @greysonlalonde
+
+</Update>
+
 <Update label="15 abr 2026">
   ## v1.14.2a5
 

From 749fe85325e3cf6df79e7bc39e67992b62ba724c Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Thu, 16 Apr 2026 23:55:30 +0800
Subject: [PATCH 61/70] fix: bump langsmith to 0.7.31 to patch
 GHSA-rr7j-v2q5-chgv

langsmith <0.7.31 bypasses output redaction for streaming token
events, leaking sensitive LLM outputs into LangSmith storage.
---
 pyproject.toml | 2 ++
 uv.lock        | 9 +++++----
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 40fc25cbe..f3d5f7f8f 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -173,6 +173,7 @@ exclude-newer = "1 day"
 # pypdf <6.10.1 has CVE-2026-40260 and GHSA-jj6c-8h6c-hppx; force 6.10.1+.
 # uv <0.11.6 has GHSA-pjjw-68hj-v9mw; force 0.11.6+.
 # python-multipart <0.0.26 has GHSA-mj87-hwqh-73pj; force 0.0.26+.
+# langsmith <0.7.31 has GHSA-rr7j-v2q5-chgv (streaming token redaction bypass); force 0.7.31+.
 override-dependencies = [
     "rich>=13.7.1",
     "onnxruntime<1.24; python_version < '3.11'",
@@ -184,6 +185,7 @@ override-dependencies = [
     "pypdf>=6.10.1,<7",
     "uv>=0.11.6,<1",
     "python-multipart>=0.0.26,<1",
+    "langsmith>=0.7.31,<0.8",
 ]
 
 [tool.uv.workspace]
diff --git a/uv.lock b/uv.lock
index 4668670fd..a89b53544 100644
--- a/uv.lock
+++ b/uv.lock
@@ -13,7 +13,7 @@ resolution-markers = [
 ]
 
 [options]
-exclude-newer = "2026-04-14T20:20:18.36862Z"
+exclude-newer = "2026-04-15T15:14:38.695171Z"
 exclude-newer-span = "P1D"
 
 [manifest]
@@ -26,6 +26,7 @@ members = [
 overrides = [
     { name = "cryptography", specifier = ">=46.0.7" },
     { name = "langchain-core", specifier = ">=1.2.28,<2" },
+    { name = "langsmith", specifier = ">=0.7.31,<0.8" },
     { name = "onnxruntime", marker = "python_full_version < '3.11'", specifier = "<1.24" },
     { name = "pillow", specifier = ">=12.1.1" },
     { name = "pypdf", specifier = ">=6.10.1,<7" },
@@ -3596,7 +3597,7 @@ sdist = { url = "https://files.pythonhosted.org/packages/0e/72/a3add0e4eec4eb9e2
 
 [[package]]
 name = "langsmith"
-version = "0.7.30"
+version = "0.7.31"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
@@ -3609,9 +3610,9 @@ dependencies = [
     { name = "xxhash" },
     { name = "zstandard" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/46/e7/d27d952ce9824d684a3bb500a06541a2d55734bc4d849cdfcca2dfd4d93a/langsmith-0.7.30.tar.gz", hash = "sha256:d9df7ba5e42f818b63bda78776c8f2fc853388be3ae77b117e5d183a149321a2", size = 1106040, upload-time = "2026-04-09T21:12:01.892Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/e6/11/696019490992db5c87774dc20515529ef42a01e1d770fb754ed6d9b12fb0/langsmith-0.7.31.tar.gz", hash = "sha256:331ee4f7c26bb5be4022b9859b7d7b122cbf8c9d01d9f530114c1914b0349ffb", size = 1178480, upload-time = "2026-04-14T17:55:41.242Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/37/19/96250cf58070c5563446651b03bb76c2eb5afbf08e754840ab639532d8c6/langsmith-0.7.30-py3-none-any.whl", hash = "sha256:43dd9f8d290e4d406606d6cc0bd62f5d1050963f05fe0ab6ffe50acf41f2f55a", size = 372682, upload-time = "2026-04-09T21:12:00.481Z" },
+    { url = "https://files.pythonhosted.org/packages/1d/a1/a013cf458c301cda86a213dd153ce0a01c93f1ab5833f951e6a44c9763ce/langsmith-0.7.31-py3-none-any.whl", hash = "sha256:0291d49203f6e80dda011af1afda61eb0595a4d697adb684590a8805e1d61fb6", size = 373276, upload-time = "2026-04-14T17:55:39.677Z" },
 ]
 
 [[package]]

From 63fc2e7588294b346daef9dcb216273541399b9f Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Fri, 17 Apr 2026 00:06:02 +0800
Subject: [PATCH 62/70] fix: complete recursive MCP schema handling

resolve_refs now returns type-preserving stubs instead of {} for
circular $refs, and create_model_from_schema catches JsonRefError
to fall back to lazy top-level-only inlining.
---
 .../crewai/utilities/pydantic_schema_utils.py |  30 ++++-
 .../utilities/test_pydantic_schema_utils.py   | 107 ++++++++++++++++++
 2 files changed, 135 insertions(+), 2 deletions(-)

diff --git a/lib/crewai/src/crewai/utilities/pydantic_schema_utils.py b/lib/crewai/src/crewai/utilities/pydantic_schema_utils.py
index 180181fa7..a45c1635a 100644
--- a/lib/crewai/src/crewai/utilities/pydantic_schema_utils.py
+++ b/lib/crewai/src/crewai/utilities/pydantic_schema_utils.py
@@ -120,7 +120,11 @@ def resolve_refs(schema: dict[str, Any]) -> dict[str, Any]:
                 if def_name not in defs:
                     raise KeyError(f"Definition '{def_name}' not found in $defs.")
                 if def_name in expanding:
-                    return {}
+                    def_schema = defs[def_name]
+                    stub: dict[str, Any] = {"type": def_schema.get("type", "object")}
+                    if "description" in def_schema:
+                        stub["description"] = def_schema["description"]
+                    return stub
                 expanding.add(def_name)
                 try:
                     return _resolve(deepcopy(defs[def_name]))
@@ -759,6 +763,25 @@ def build_rich_field_description(prop_schema: dict[str, Any]) -> str:
     return ". ".join(parts) if parts else ""
 
 
+def _inline_top_level_ref(schema: dict[str, Any]) -> dict[str, Any]:
+    """Resolve only the top-level ``$ref``, preserving ``$defs`` for lazy inner resolution.
+
+    Used as a fallback when ``jsonref.replace_refs`` fails on circular schemas.
+    Inner ``$ref`` pointers are left intact so that :func:`_resolve_ref` can
+    resolve them during model construction, with cycle detection via ``in_progress``.
+    """
+    schema = deepcopy(schema)
+    ref = schema.get("$ref")
+    if isinstance(ref, str) and ref.startswith("#/$defs/"):
+        def_name = ref[len("#/$defs/") :]
+        defs = schema.get("$defs", {})
+        if def_name in defs:
+            resolved: dict[str, Any] = deepcopy(defs[def_name])
+            resolved.setdefault("$defs", defs)
+            return resolved
+    return schema
+
+
 def create_model_from_schema(  # type: ignore[no-any-unimported]
     json_schema: dict[str, Any],
     *,
@@ -813,7 +836,10 @@ def create_model_from_schema(  # type: ignore[no-any-unimported]
         >>> person.name
         'John'
     """
-    json_schema = dict(jsonref.replace_refs(json_schema, proxies=False))
+    try:
+        json_schema = dict(jsonref.replace_refs(json_schema, proxies=False))
+    except (jsonref.JsonRefError, RecursionError):
+        json_schema = _inline_top_level_ref(json_schema)
 
     effective_root = root_schema or json_schema
 
diff --git a/lib/crewai/tests/utilities/test_pydantic_schema_utils.py b/lib/crewai/tests/utilities/test_pydantic_schema_utils.py
index 98a5e6aa5..70a900c7f 100644
--- a/lib/crewai/tests/utilities/test_pydantic_schema_utils.py
+++ b/lib/crewai/tests/utilities/test_pydantic_schema_utils.py
@@ -882,3 +882,110 @@ class TestEndToEndMCPSchema:
         )
         assert obj.filters.date_from == datetime.date(2025, 1, 1)
         assert obj.filters.categories == ["news", "tech"]
+
+
+# ---------------------------------------------------------------------------
+# Recursive / circular $ref schemas (GH-5490)
+# ---------------------------------------------------------------------------
+
+RECURSIVE_NODE_SCHEMA: dict = {
+    "$defs": {
+        "Node": {
+            "type": "object",
+            "properties": {
+                "name": {"type": "string"},
+                "children": {
+                    "type": "array",
+                    "items": {"$ref": "#/$defs/Node"},
+                },
+            },
+            "required": ["name"],
+        }
+    },
+    "$ref": "#/$defs/Node",
+}
+
+MUTUAL_RECURSION_SCHEMA: dict = {
+    "$defs": {
+        "A": {
+            "type": "object",
+            "properties": {
+                "val": {"type": "string"},
+                "b": {"$ref": "#/$defs/B"},
+            },
+            "required": ["val"],
+        },
+        "B": {
+            "type": "object",
+            "properties": {
+                "val": {"type": "integer"},
+                "a": {"$ref": "#/$defs/A"},
+            },
+            "required": ["val"],
+        },
+    },
+    "$ref": "#/$defs/A",
+}
+
+
+class TestResolveRefsRecursive:
+    def test_circular_ref_preserves_type(self) -> None:
+        from crewai.utilities.pydantic_schema_utils import resolve_refs
+
+        resolved = resolve_refs(deepcopy(RECURSIVE_NODE_SCHEMA))
+        items = resolved["properties"]["children"]["items"]
+        assert items != {}, "Circular ref should not degrade to {}"
+        assert items.get("type") == "object"
+
+    def test_non_recursive_schema_still_resolves(self) -> None:
+        from crewai.utilities.pydantic_schema_utils import resolve_refs
+
+        schema = {
+            "$defs": {"Foo": {"type": "object", "properties": {"x": {"type": "integer"}}}},
+            "$ref": "#/$defs/Foo",
+        }
+        resolved = resolve_refs(schema)
+        assert resolved["properties"]["x"]["type"] == "integer"
+
+
+class TestSanitizeRecursiveSchemas:
+    def test_anthropic_strict_preserves_recursive_type(self) -> None:
+        from crewai.utilities.pydantic_schema_utils import sanitize_tool_params_for_anthropic_strict
+
+        san = sanitize_tool_params_for_anthropic_strict(deepcopy(RECURSIVE_NODE_SCHEMA))
+        items = san["properties"]["children"]["items"]
+        assert items != {}
+        assert items.get("type") == "object"
+
+    def test_openai_strict_preserves_recursive_type(self) -> None:
+        from crewai.utilities.pydantic_schema_utils import sanitize_tool_params_for_openai_strict
+
+        san = sanitize_tool_params_for_openai_strict(deepcopy(RECURSIVE_NODE_SCHEMA))
+        items = san["properties"]["children"]["items"]
+        assert items != {}
+        assert items.get("type") == "object"
+
+
+class TestCreateModelFromSchemaRecursive:
+    def test_model_creation_succeeds(self) -> None:
+        model = create_model_from_schema(deepcopy(RECURSIVE_NODE_SCHEMA), model_name="Node")
+        assert model is not None
+        assert model.__name__ == "Node"
+
+    def test_model_accepts_valid_recursive_data(self) -> None:
+        model = create_model_from_schema(deepcopy(RECURSIVE_NODE_SCHEMA), model_name="Node")
+        instance = model(name="root", children=[{"name": "child", "children": []}])
+        assert instance.name == "root"
+        assert len(instance.children) == 1
+
+    def test_model_rejects_missing_required_field(self) -> None:
+        import pytest
+
+        model = create_model_from_schema(deepcopy(RECURSIVE_NODE_SCHEMA), model_name="Node")
+        with pytest.raises(Exception):
+            model(children=[])
+
+    def test_mutual_recursion_schema(self) -> None:
+        model = create_model_from_schema(deepcopy(MUTUAL_RECURSION_SCHEMA), model_name="A")
+        instance = model(val="hello", b={"val": 42})
+        assert instance.val == "hello"

From 32ec4414bfeb97ba873cd4617e530180e64f5635 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Fri, 17 Apr 2026 00:13:35 +0800
Subject: [PATCH 63/70] fix: use recursive glob for JSON checkpoint discovery

Branch-aware checkpoint storage writes under subdirectories (e.g.
main/, fork/exp1/) but _list_json and _info_json_latest used flat
globs that missed them.
---
 lib/crewai/src/crewai/cli/checkpoint_cli.py | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/lib/crewai/src/crewai/cli/checkpoint_cli.py b/lib/crewai/src/crewai/cli/checkpoint_cli.py
index fa6e003aa..1745c224f 100644
--- a/lib/crewai/src/crewai/cli/checkpoint_cli.py
+++ b/lib/crewai/src/crewai/cli/checkpoint_cli.py
@@ -173,9 +173,11 @@ def _entity_summary(entities: list[dict[str, Any]]) -> str:
 
 
 def _list_json(location: str) -> list[dict[str, Any]]:
-    pattern = os.path.join(location, "*.json")
+    pattern = os.path.join(location, "**", "*.json")
     results = []
-    for path in sorted(glob.glob(pattern), key=os.path.getmtime, reverse=True):
+    for path in sorted(
+        glob.glob(pattern, recursive=True), key=os.path.getmtime, reverse=True
+    ):
         name = os.path.basename(path)
         try:
             with open(path) as f:
@@ -192,8 +194,10 @@ def _list_json(location: str) -> list[dict[str, Any]]:
 
 
 def _info_json_latest(location: str) -> dict[str, Any] | None:
-    pattern = os.path.join(location, "*.json")
-    files = sorted(glob.glob(pattern), key=os.path.getmtime, reverse=True)
+    pattern = os.path.join(location, "**", "*.json")
+    files = sorted(
+        glob.glob(pattern, recursive=True), key=os.path.getmtime, reverse=True
+    )
     if not files:
         return None
     path = files[0]

From 105a9778cca31eb137874496bcfbf855231682c5 Mon Sep 17 00:00:00 2001
From: Lorenze Jay <63378463+lorenzejay@users.noreply.github.com>
Date: Thu, 16 Apr 2026 10:18:15 -0700
Subject: [PATCH 64/70] feat: add template management commands for project
 templates (#5444)

* feat: add template management commands for project templates

- Introduced  command group to browse and install project templates.
- Added  command to display available templates.
- Implemented  command to install a selected template into the current directory.
- Created  class to handle template-related operations, including fetching templates from GitHub and managing installations.
- Enhanced telemetry to track template installations.

* linted

* adressing comments

* comment addressed
---
 lib/crewai/src/crewai/cli/cli.py              |  28 ++
 .../crewai/cli/remote_template/__init__.py    |   0
 .../src/crewai/cli/remote_template/main.py    | 250 ++++++++++++++++
 lib/crewai/src/crewai/telemetry/telemetry.py  |  17 ++
 .../tests/cli/remote_template/__init__.py     |   0
 .../tests/cli/remote_template/test_main.py    | 283 ++++++++++++++++++
 6 files changed, 578 insertions(+)
 create mode 100644 lib/crewai/src/crewai/cli/remote_template/__init__.py
 create mode 100644 lib/crewai/src/crewai/cli/remote_template/main.py
 create mode 100644 lib/crewai/tests/cli/remote_template/__init__.py
 create mode 100644 lib/crewai/tests/cli/remote_template/test_main.py

diff --git a/lib/crewai/src/crewai/cli/cli.py b/lib/crewai/src/crewai/cli/cli.py
index 2e10d5162..bc2a9ee26 100644
--- a/lib/crewai/src/crewai/cli/cli.py
+++ b/lib/crewai/src/crewai/cli/cli.py
@@ -18,6 +18,7 @@ from crewai.cli.install_crew import install_crew
 from crewai.cli.kickoff_flow import kickoff_flow
 from crewai.cli.organization.main import OrganizationCommand
 from crewai.cli.plot_flow import plot_flow
+from crewai.cli.remote_template.main import TemplateCommand
 from crewai.cli.replay_from_task import replay_task_command
 from crewai.cli.reset_memories_command import reset_memories_command
 from crewai.cli.run_crew import run_crew
@@ -496,6 +497,33 @@ def tool_publish(is_public: bool, force: bool) -> None:
     tool_cmd.publish(is_public, force)
 
 
+@crewai.group()
+def template() -> None:
+    """Browse and install project templates."""
+
+
+@template.command(name="list")
+def template_list() -> None:
+    """List available templates and select one to install."""
+    template_cmd = TemplateCommand()
+    template_cmd.list_templates()
+
+
+@template.command(name="add")
+@click.argument("name")
+@click.option(
+    "-o",
+    "--output-dir",
+    type=str,
+    default=None,
+    help="Directory name for the template (defaults to template name)",
+)
+def template_add(name: str, output_dir: str | None) -> None:
+    """Add a template to the current directory."""
+    template_cmd = TemplateCommand()
+    template_cmd.add_template(name, output_dir)
+
+
 @crewai.group()
 def flow() -> None:
     """Flow related commands."""
diff --git a/lib/crewai/src/crewai/cli/remote_template/__init__.py b/lib/crewai/src/crewai/cli/remote_template/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/lib/crewai/src/crewai/cli/remote_template/main.py b/lib/crewai/src/crewai/cli/remote_template/main.py
new file mode 100644
index 000000000..bbd32184f
--- /dev/null
+++ b/lib/crewai/src/crewai/cli/remote_template/main.py
@@ -0,0 +1,250 @@
+import io
+import logging
+import os
+import shutil
+from typing import Any
+import zipfile
+
+import click
+import httpx
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+
+from crewai.cli.command import BaseCommand
+
+
+logger = logging.getLogger(__name__)
+console = Console()
+
+GITHUB_ORG = "crewAIInc"
+TEMPLATE_PREFIX = "template_"
+GITHUB_API_BASE = "https://api.github.com"
+
+BANNER = """\
+[bold white] ██████╗██████╗ ███████╗██╗    ██╗[/bold white] [bold red] █████╗ ██╗[/bold red]
+[bold white]██╔════╝██╔══██╗██╔════╝██║    ██║[/bold white] [bold red]██╔══██╗██║[/bold red]
+[bold white]██║     ██████╔╝█████╗  ██║ █╗ ██║[/bold white] [bold red]███████║██║[/bold red]
+[bold white]██║     ██╔══██╗██╔══╝  ██║███╗██║[/bold white] [bold red]██╔══██║██║[/bold red]
+[bold white]╚██████╗██║  ██║███████╗╚███╔███╔╝[/bold white] [bold red]██║  ██║██║[/bold red]
+[bold white] ╚═════╝╚═╝  ╚═╝╚══════╝ ╚══╝╚══╝[/bold white] [bold red]╚═╝  ╚═╝╚═╝[/bold red]
+[dim white]████████╗███████╗███╗   ███╗██████╗ ██╗      █████╗ ████████╗███████╗███████╗[/dim white]
+[dim white]╚══██╔══╝██╔════╝████╗ ████║██╔══██╗██║     ██╔══██╗╚══██╔══╝██╔════╝██╔════╝[/dim white]
+[dim white]   ██║   █████╗  ██╔████╔██║██████╔╝██║     ███████║   ██║   █████╗  ███████╗[/dim white]
+[dim white]   ██║   ██╔══╝  ██║╚██╔╝██║██╔═══╝ ██║     ██╔══██║   ██║   ██╔══╝  ╚════██║[/dim white]
+[dim white]   ██║   ███████╗██║ ╚═╝ ██║██║     ███████╗██║  ██║   ██║   ███████╗███████║[/dim white]
+[dim white]   ╚═╝   ╚══════╝╚═╝     ╚═╝╚═╝     ╚══════╝╚═╝  ╚═╝   ╚═╝   ╚══════╝╚══════╝[/dim white]"""
+
+
+class TemplateCommand(BaseCommand):
+    """Handle template-related operations for CrewAI projects."""
+
+    def __init__(self) -> None:
+        super().__init__()
+
+    def list_templates(self) -> None:
+        """List available templates with an interactive selector to install."""
+        templates = self._fetch_templates()
+        if not templates:
+            click.echo("No templates found.")
+            return
+
+        console.print(f"\n{BANNER}\n")
+        console.print(" [on cyan] templates [/on cyan]\n")
+        console.print(f" [green]o[/green]  Source: https://github.com/{GITHUB_ORG}")
+        console.print(
+            f" [green]o[/green]  Found [bold]{len(templates)}[/bold] templates\n"
+        )
+        console.print(" [green]o[/green]  Select a template to install")
+
+        for idx, repo in enumerate(templates, start=1):
+            name = repo["name"].removeprefix(TEMPLATE_PREFIX)
+            description = repo.get("description") or ""
+            if description:
+                console.print(
+                    f"      [bold cyan]{idx}.[/bold cyan] [bold white]{name}[/bold white] [dim]({description})[/dim]"
+                )
+            else:
+                console.print(
+                    f"      [bold cyan]{idx}.[/bold cyan] [bold white]{name}[/bold white]"
+                )
+
+        console.print("      [bold cyan]q.[/bold cyan] [dim]Quit[/dim]\n")
+
+        while True:
+            choice = click.prompt("Enter your choice", type=str)
+
+            if choice.lower() == "q":
+                return
+
+            if choice.isdigit() and 1 <= int(choice) <= len(templates):
+                selected_index = int(choice) - 1
+                break
+
+            click.secho(
+                f"Please enter a number between 1 and {len(templates)}, or 'q' to quit.",
+                fg="yellow",
+            )
+
+        selected = templates[selected_index]
+        repo_name = selected["name"]
+        self._install_repo(repo_name)
+
+    def add_template(self, name: str, output_dir: str | None = None) -> None:
+        """Download a template and copy it into the current working directory.
+
+        Args:
+            name: Template name (with or without the template_ prefix).
+            output_dir: Optional directory name. Defaults to the template name.
+        """
+        repo_name = self._resolve_repo_name(name)
+        if repo_name is None:
+            click.secho(f"Template '{name}' not found.", fg="red")
+            click.echo("Run 'crewai template list' to see available templates.")
+            raise SystemExit(1)
+
+        self._install_repo(repo_name, output_dir)
+
+    def _install_repo(self, repo_name: str, output_dir: str | None = None) -> None:
+        """Download and extract a template repo into the current directory.
+
+        Args:
+            repo_name: Full GitHub repo name (e.g. template_deep_research).
+            output_dir: Optional directory name. Defaults to the template name.
+        """
+        folder_name = output_dir or repo_name.removeprefix(TEMPLATE_PREFIX)
+        dest = os.path.join(os.getcwd(), folder_name)
+
+        while os.path.exists(dest):
+            click.secho(f"Directory '{folder_name}' already exists.", fg="yellow")
+            folder_name = click.prompt(
+                "Enter a different directory name (or 'q' to quit)", type=str
+            )
+            if folder_name.lower() == "q":
+                return
+            dest = os.path.join(os.getcwd(), folder_name)
+
+        click.echo(
+            f"Downloading template '{repo_name.removeprefix(TEMPLATE_PREFIX)}'..."
+        )
+
+        zip_bytes = self._download_zip(repo_name)
+        self._extract_zip(zip_bytes, dest)
+
+        self._telemetry.template_installed_span(repo_name.removeprefix(TEMPLATE_PREFIX))
+
+        console.print(
+            f"\n [green]\u2713[/green]  Installed template [bold white]{folder_name}[/bold white]"
+            f" [dim](source: github.com/{GITHUB_ORG}/{repo_name})[/dim]\n"
+        )
+
+        next_steps = Text()
+        next_steps.append(f"  cd {folder_name}\n", style="bold white")
+        next_steps.append("  crewai install", style="bold white")
+
+        panel = Panel(
+            next_steps,
+            title="[green]\u25c7  Next steps[/green]",
+            title_align="left",
+            border_style="dim",
+            padding=(1, 2),
+        )
+        console.print(panel)
+
+    def _fetch_templates(self) -> list[dict[str, Any]]:
+        """Fetch all template repos from the GitHub org."""
+        templates: list[dict[str, Any]] = []
+        page = 1
+        while True:
+            url = f"{GITHUB_API_BASE}/orgs/{GITHUB_ORG}/repos"
+            params: dict[str, str | int] = {
+                "per_page": 100,
+                "page": page,
+                "type": "public",
+            }
+            try:
+                response = httpx.get(url, params=params, timeout=15)
+                response.raise_for_status()
+            except httpx.HTTPError as e:
+                click.secho(f"Failed to fetch templates from GitHub: {e}", fg="red")
+                raise SystemExit(1) from e
+
+            repos = response.json()
+            if not repos:
+                break
+
+            templates.extend(
+                repo
+                for repo in repos
+                if repo["name"].startswith(TEMPLATE_PREFIX) and not repo.get("private")
+            )
+
+            page += 1
+
+        templates.sort(key=lambda r: r["name"])
+        return templates
+
+    def _resolve_repo_name(self, name: str) -> str | None:
+        """Resolve user input to a full repo name, or None if not found."""
+        # Accept both 'deep_research' and 'template_deep_research'
+        candidates = [
+            f"{TEMPLATE_PREFIX}{name}"
+            if not name.startswith(TEMPLATE_PREFIX)
+            else name,
+            name,
+        ]
+
+        templates = self._fetch_templates()
+        template_names = {t["name"] for t in templates}
+
+        for candidate in candidates:
+            if candidate in template_names:
+                return candidate
+
+        return None
+
+    def _download_zip(self, repo_name: str) -> bytes:
+        """Download the default branch zipball for a repo."""
+        url = f"{GITHUB_API_BASE}/repos/{GITHUB_ORG}/{repo_name}/zipball"
+        try:
+            response = httpx.get(url, follow_redirects=True, timeout=60)
+            response.raise_for_status()
+        except httpx.HTTPError as e:
+            click.secho(f"Failed to download template: {e}", fg="red")
+            raise SystemExit(1) from e
+
+        return response.content
+
+    def _extract_zip(self, zip_bytes: bytes, dest: str) -> None:
+        """Extract a GitHub zipball into dest, stripping the top-level directory."""
+        with zipfile.ZipFile(io.BytesIO(zip_bytes)) as zf:
+            # GitHub zipballs have a single top-level dir like 'crewAIInc-template_xxx-<sha>/'
+            members = zf.namelist()
+            if not members:
+                click.secho("Downloaded archive is empty.", fg="red")
+                raise SystemExit(1)
+
+            top_dir = members[0].split("/")[0] + "/"
+
+            os.makedirs(dest, exist_ok=True)
+
+            for member in members:
+                if member == top_dir or not member.startswith(top_dir):
+                    continue
+
+                relative_path = member[len(top_dir) :]
+                if not relative_path:
+                    continue
+
+                target = os.path.realpath(os.path.join(dest, relative_path))
+                if not target.startswith(
+                    os.path.realpath(dest) + os.sep
+                ) and target != os.path.realpath(dest):
+                    continue
+
+                if member.endswith("/"):
+                    os.makedirs(target, exist_ok=True)
+                else:
+                    os.makedirs(os.path.dirname(target), exist_ok=True)
+                    with zf.open(member) as src, open(target, "wb") as dst:
+                        shutil.copyfileobj(src, dst)
diff --git a/lib/crewai/src/crewai/telemetry/telemetry.py b/lib/crewai/src/crewai/telemetry/telemetry.py
index 94939bb7a..1e7506da0 100644
--- a/lib/crewai/src/crewai/telemetry/telemetry.py
+++ b/lib/crewai/src/crewai/telemetry/telemetry.py
@@ -1058,3 +1058,20 @@ class Telemetry:
             close_span(span)
 
         self._safe_telemetry_operation(_operation)
+
+    def template_installed_span(self, template_name: str) -> None:
+        """Records when a template is downloaded and installed.
+
+        Args:
+            template_name: Name of the template that was installed
+                (without the template_ prefix).
+        """
+
+        def _operation() -> None:
+            tracer = trace.get_tracer("crewai.telemetry")
+            span = tracer.start_span("Template Installed")
+            self._add_attribute(span, "crewai_version", version("crewai"))
+            self._add_attribute(span, "template_name", template_name)
+            close_span(span)
+
+        self._safe_telemetry_operation(_operation)
diff --git a/lib/crewai/tests/cli/remote_template/__init__.py b/lib/crewai/tests/cli/remote_template/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/lib/crewai/tests/cli/remote_template/test_main.py b/lib/crewai/tests/cli/remote_template/test_main.py
new file mode 100644
index 000000000..829e956ce
--- /dev/null
+++ b/lib/crewai/tests/cli/remote_template/test_main.py
@@ -0,0 +1,283 @@
+import io
+import os
+import zipfile
+from unittest.mock import MagicMock, patch
+
+import httpx
+import pytest
+from click.testing import CliRunner
+
+from crewai.cli.cli import template_add, template_list
+from crewai.cli.remote_template.main import TemplateCommand
+
+
+@pytest.fixture
+def runner():
+    return CliRunner()
+
+
+SAMPLE_REPOS = [
+    {"name": "template_deep_research", "description": "Deep research template", "private": False},
+    {"name": "template_pull_request_review", "description": "PR review template", "private": False},
+    {"name": "template_conversational_example", "description": "Conversational demo", "private": False},
+    {"name": "crewai", "description": "Main repo", "private": False},
+    {"name": "marketplace-crew-template", "description": "Marketplace", "private": False},
+]
+
+
+def _make_zipball(files: dict[str, str], top_dir: str = "crewAIInc-template_test-abc123") -> bytes:
+    """Create an in-memory zipball mimicking GitHub's format."""
+    buf = io.BytesIO()
+    with zipfile.ZipFile(buf, "w") as zf:
+        zf.writestr(f"{top_dir}/", "")
+        for path, content in files.items():
+            zf.writestr(f"{top_dir}/{path}", content)
+    return buf.getvalue()
+
+
+# --- CLI command tests ---
+
+
+@patch("crewai.cli.cli.TemplateCommand")
+def test_template_list_command(mock_cls, runner):
+    mock_instance = MagicMock()
+    mock_cls.return_value = mock_instance
+
+    result = runner.invoke(template_list)
+
+    assert result.exit_code == 0
+    mock_cls.assert_called_once()
+    mock_instance.list_templates.assert_called_once()
+
+
+@patch("crewai.cli.cli.TemplateCommand")
+def test_template_add_command(mock_cls, runner):
+    mock_instance = MagicMock()
+    mock_cls.return_value = mock_instance
+
+    result = runner.invoke(template_add, ["deep_research"])
+
+    assert result.exit_code == 0
+    mock_cls.assert_called_once()
+    mock_instance.add_template.assert_called_once_with("deep_research", None)
+
+
+@patch("crewai.cli.cli.TemplateCommand")
+def test_template_add_with_output_dir(mock_cls, runner):
+    mock_instance = MagicMock()
+    mock_cls.return_value = mock_instance
+
+    result = runner.invoke(template_add, ["deep_research", "-o", "my_project"])
+
+    assert result.exit_code == 0
+    mock_instance.add_template.assert_called_once_with("deep_research", "my_project")
+
+
+# --- TemplateCommand unit tests ---
+
+
+class TestTemplateCommand:
+    @pytest.fixture
+    def cmd(self):
+        with patch.object(TemplateCommand, "__init__", return_value=None):
+            instance = TemplateCommand()
+            instance._telemetry = MagicMock()
+            return instance
+
+    @patch("crewai.cli.remote_template.main.httpx.get")
+    def test_fetch_templates_filters_by_prefix(self, mock_get, cmd):
+        mock_response = MagicMock()
+        mock_response.json.return_value = SAMPLE_REPOS
+        mock_response.raise_for_status = MagicMock()
+        # Return empty on page 2 to stop pagination
+        mock_empty = MagicMock()
+        mock_empty.json.return_value = []
+        mock_empty.raise_for_status = MagicMock()
+        mock_get.side_effect = [mock_response, mock_empty]
+
+        templates = cmd._fetch_templates()
+
+        assert len(templates) == 3
+        assert all(t["name"].startswith("template_") for t in templates)
+
+    @patch("crewai.cli.remote_template.main.httpx.get")
+    def test_fetch_templates_excludes_private(self, mock_get, cmd):
+        repos = [
+            {"name": "template_private_one", "description": "", "private": True},
+            {"name": "template_public_one", "description": "", "private": False},
+        ]
+        mock_response = MagicMock()
+        mock_response.json.return_value = repos
+        mock_response.raise_for_status = MagicMock()
+        mock_empty = MagicMock()
+        mock_empty.json.return_value = []
+        mock_empty.raise_for_status = MagicMock()
+        mock_get.side_effect = [mock_response, mock_empty]
+
+        templates = cmd._fetch_templates()
+
+        assert len(templates) == 1
+        assert templates[0]["name"] == "template_public_one"
+
+    @patch("crewai.cli.remote_template.main.httpx.get")
+    def test_fetch_templates_api_error(self, mock_get, cmd):
+        mock_get.side_effect = httpx.HTTPError("connection error")
+
+        with pytest.raises(SystemExit):
+            cmd._fetch_templates()
+
+    @patch("crewai.cli.remote_template.main.click.prompt", return_value="q")
+    @patch("crewai.cli.remote_template.main.httpx.get")
+    def test_list_templates_prints_output(self, mock_get, mock_prompt, cmd):
+        mock_response = MagicMock()
+        mock_response.json.return_value = SAMPLE_REPOS
+        mock_response.raise_for_status = MagicMock()
+        mock_empty = MagicMock()
+        mock_empty.json.return_value = []
+        mock_empty.raise_for_status = MagicMock()
+        mock_get.side_effect = [mock_response, mock_empty]
+
+        with patch("crewai.cli.remote_template.main.console") as mock_console:
+            cmd.list_templates()
+            assert mock_console.print.call_count > 0
+
+    @patch("crewai.cli.remote_template.main.httpx.get")
+    def test_resolve_repo_name_with_prefix(self, mock_get, cmd):
+        mock_response = MagicMock()
+        mock_response.json.return_value = SAMPLE_REPOS
+        mock_response.raise_for_status = MagicMock()
+        mock_empty = MagicMock()
+        mock_empty.json.return_value = []
+        mock_empty.raise_for_status = MagicMock()
+        mock_get.side_effect = [mock_response, mock_empty]
+
+        result = cmd._resolve_repo_name("template_deep_research")
+        assert result == "template_deep_research"
+
+    @patch("crewai.cli.remote_template.main.httpx.get")
+    def test_resolve_repo_name_without_prefix(self, mock_get, cmd):
+        mock_response = MagicMock()
+        mock_response.json.return_value = SAMPLE_REPOS
+        mock_response.raise_for_status = MagicMock()
+        mock_empty = MagicMock()
+        mock_empty.json.return_value = []
+        mock_empty.raise_for_status = MagicMock()
+        mock_get.side_effect = [mock_response, mock_empty]
+
+        result = cmd._resolve_repo_name("deep_research")
+        assert result == "template_deep_research"
+
+    @patch("crewai.cli.remote_template.main.httpx.get")
+    def test_resolve_repo_name_not_found(self, mock_get, cmd):
+        mock_response = MagicMock()
+        mock_response.json.return_value = SAMPLE_REPOS
+        mock_response.raise_for_status = MagicMock()
+        mock_empty = MagicMock()
+        mock_empty.json.return_value = []
+        mock_empty.raise_for_status = MagicMock()
+        mock_get.side_effect = [mock_response, mock_empty]
+
+        result = cmd._resolve_repo_name("nonexistent")
+        assert result is None
+
+    def test_extract_zip(self, cmd, tmp_path):
+        files = {
+            "README.md": "# Test Template",
+            "src/main.py": "print('hello')",
+            "config/settings.yaml": "key: value",
+        }
+        zip_bytes = _make_zipball(files)
+        dest = str(tmp_path / "output")
+
+        cmd._extract_zip(zip_bytes, dest)
+
+        assert os.path.isfile(os.path.join(dest, "README.md"))
+        assert os.path.isfile(os.path.join(dest, "src", "main.py"))
+        assert os.path.isfile(os.path.join(dest, "config", "settings.yaml"))
+
+        with open(os.path.join(dest, "src", "main.py")) as f:
+            assert f.read() == "print('hello')"
+
+    @patch.object(TemplateCommand, "_extract_zip")
+    @patch.object(TemplateCommand, "_download_zip")
+    @patch.object(TemplateCommand, "_resolve_repo_name")
+    def test_add_template_success(self, mock_resolve, mock_download, mock_extract, cmd, tmp_path):
+        mock_resolve.return_value = "template_deep_research"
+        mock_download.return_value = b"fake-zip-bytes"
+
+        os.chdir(tmp_path)
+        cmd.add_template("deep_research")
+
+        mock_resolve.assert_called_once_with("deep_research")
+        mock_download.assert_called_once_with("template_deep_research")
+        expected_dest = os.path.join(str(tmp_path), "deep_research")
+        mock_extract.assert_called_once_with(b"fake-zip-bytes", expected_dest)
+
+    @patch.object(TemplateCommand, "_resolve_repo_name")
+    def test_add_template_not_found(self, mock_resolve, cmd):
+        mock_resolve.return_value = None
+
+        with pytest.raises(SystemExit):
+            cmd.add_template("nonexistent")
+
+    @patch.object(TemplateCommand, "_extract_zip")
+    @patch.object(TemplateCommand, "_download_zip")
+    @patch("crewai.cli.remote_template.main.click.prompt", return_value="my_project")
+    @patch.object(TemplateCommand, "_resolve_repo_name")
+    def test_add_template_dir_exists_prompts_rename(self, mock_resolve, mock_prompt, mock_download, mock_extract, cmd, tmp_path):
+        mock_resolve.return_value = "template_deep_research"
+        mock_download.return_value = b"fake-zip-bytes"
+        existing = tmp_path / "deep_research"
+        existing.mkdir()
+
+        os.chdir(tmp_path)
+        cmd.add_template("deep_research")
+
+        expected_dest = os.path.join(str(tmp_path), "my_project")
+        mock_extract.assert_called_once_with(b"fake-zip-bytes", expected_dest)
+
+    @patch.object(TemplateCommand, "_resolve_repo_name")
+    @patch("crewai.cli.remote_template.main.click.prompt", return_value="q")
+    def test_add_template_dir_exists_quit(self, mock_prompt, mock_resolve, cmd, tmp_path):
+        mock_resolve.return_value = "template_deep_research"
+        existing = tmp_path / "deep_research"
+        existing.mkdir()
+
+        os.chdir(tmp_path)
+        cmd.add_template("deep_research")
+        # Should return without downloading
+
+    @patch.object(TemplateCommand, "_install_repo")
+    @patch("crewai.cli.remote_template.main.click.prompt", return_value="2")
+    @patch("crewai.cli.remote_template.main.httpx.get")
+    def test_list_templates_selects_and_installs(self, mock_get, mock_prompt, mock_install, cmd):
+        mock_response = MagicMock()
+        mock_response.json.return_value = SAMPLE_REPOS
+        mock_response.raise_for_status = MagicMock()
+        mock_empty = MagicMock()
+        mock_empty.json.return_value = []
+        mock_empty.raise_for_status = MagicMock()
+        mock_get.side_effect = [mock_response, mock_empty]
+
+        with patch("crewai.cli.remote_template.main.console"):
+            cmd.list_templates()
+
+        # Templates are sorted by name; index 1 (choice "2") = template_deep_research
+        mock_install.assert_called_once_with("template_deep_research")
+
+    @patch.object(TemplateCommand, "_install_repo")
+    @patch("crewai.cli.remote_template.main.click.prompt", return_value="q")
+    @patch("crewai.cli.remote_template.main.httpx.get")
+    def test_list_templates_quit(self, mock_get, mock_prompt, mock_install, cmd):
+        mock_response = MagicMock()
+        mock_response.json.return_value = SAMPLE_REPOS
+        mock_response.raise_for_status = MagicMock()
+        mock_empty = MagicMock()
+        mock_empty.json.return_value = []
+        mock_empty.raise_for_status = MagicMock()
+        mock_get.side_effect = [mock_response, mock_empty]
+
+        with patch("crewai.cli.remote_template.main.console"):
+            cmd.list_templates()
+
+        mock_install.assert_not_called()

From 7e01c5a03048596dc6dd43b51b3ca2c41e3bc8fe Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Fri, 17 Apr 2026 01:34:06 +0800
Subject: [PATCH 65/70] fix: dispatch Flow checkpoints through Flow APIs in TUI

---
 lib/crewai/src/crewai/cli/checkpoint_tui.py | 170 ++++++++++++++------
 lib/crewai/src/crewai/flow/flow.py          |   4 +-
 2 files changed, 120 insertions(+), 54 deletions(-)

diff --git a/lib/crewai/src/crewai/cli/checkpoint_tui.py b/lib/crewai/src/crewai/cli/checkpoint_tui.py
index e0d10f813..26791af23 100644
--- a/lib/crewai/src/crewai/cli/checkpoint_tui.py
+++ b/lib/crewai/src/crewai/cli/checkpoint_tui.py
@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from collections import defaultdict
-from typing import Any, ClassVar
+from typing import Any, ClassVar, Literal
 
 from textual.app import App, ComposeResult
 from textual.binding import Binding
@@ -78,15 +78,25 @@ def _build_entity_header(ent: dict[str, Any]) -> str:
     return "\n".join(lines)
 
 
-# Return type: (location, action, inputs, task_output_overrides)
-_TuiResult = tuple[str, str, dict[str, Any] | None, dict[int, str] | None] | None
+# Return type: (location, action, inputs, task_output_overrides, entity_type)
+_TuiResult = (
+    tuple[
+        str,
+        str,
+        dict[str, Any] | None,
+        dict[int, str] | None,
+        Literal["crew", "flow"],
+    ]
+    | None
+)
 
 
 class CheckpointTUI(App[_TuiResult]):
     """TUI to browse and inspect checkpoints.
 
-    Returns ``(location, action, inputs)`` where action is ``"resume"`` or
-    ``"fork"`` and inputs is a parsed dict or ``None``,
+    Returns ``(location, action, inputs, task_overrides, entity_type)``
+    where action is ``"resume"`` or ``"fork"``, inputs is a parsed dict
+    or ``None``, and entity_type is ``"crew"`` or ``"flow"``;
     or ``None`` if the user quit without selecting.
     """
 
@@ -506,6 +516,13 @@ class CheckpointTUI(App[_TuiResult]):
                 overrides[task_idx] = editor.text
         return overrides or None
 
+    def _detect_entity_type(self, entry: dict[str, Any]) -> Literal["crew", "flow"]:
+        """Infer the top-level entity type from checkpoint entities."""
+        for ent in entry.get("entities", []):
+            if ent.get("type") == "flow":
+                return "flow"
+        return "crew"
+
     def _resolve_location(self, entry: dict[str, Any]) -> str:
         """Get the restore location string for a checkpoint entry."""
         if "path" in entry:
@@ -526,15 +543,64 @@ class CheckpointTUI(App[_TuiResult]):
         inputs = self._collect_inputs()
         overrides = self._collect_task_overrides()
         loc = self._resolve_location(self._selected_entry)
+        etype = self._detect_entity_type(self._selected_entry)
         if event.button.id == "btn-resume":
-            self.exit((loc, "resume", inputs, overrides))
+            self.exit((loc, "resume", inputs, overrides, etype))
         elif event.button.id == "btn-fork":
-            self.exit((loc, "fork", inputs, overrides))
+            self.exit((loc, "fork", inputs, overrides, etype))
 
     def action_refresh(self) -> None:
         self._refresh_tree()
 
 
+def _apply_task_overrides(crew: Any, task_overrides: dict[int, str]) -> None:
+    """Apply task output overrides to a restored Crew and print modifications."""
+    import click
+
+    click.echo("Modifications:")
+    overridden_agents: set[int] = set()
+    for task_idx, new_output in task_overrides.items():
+        if task_idx < len(crew.tasks) and crew.tasks[task_idx].output is not None:
+            desc = crew.tasks[task_idx].description or f"Task {task_idx + 1}"
+            if len(desc) > 60:
+                desc = desc[:57] + "..."
+            crew.tasks[task_idx].output.raw = new_output
+            preview = new_output.replace("\n", " ")
+            if len(preview) > 80:
+                preview = preview[:77] + "..."
+            click.echo(f"  Task {task_idx + 1}: {desc}")
+            click.echo(f"    -> {preview}")
+            agent = crew.tasks[task_idx].agent
+            if agent and agent.agent_executor:
+                nth = sum(1 for t in crew.tasks[:task_idx] if t.agent is agent)
+                messages = agent.agent_executor.messages
+                system_positions = [
+                    i for i, m in enumerate(messages) if m.get("role") == "system"
+                ]
+                if nth < len(system_positions):
+                    seg_start = system_positions[nth]
+                    seg_end = (
+                        system_positions[nth + 1]
+                        if nth + 1 < len(system_positions)
+                        else len(messages)
+                    )
+                    for j in range(seg_end - 1, seg_start, -1):
+                        if messages[j].get("role") == "assistant":
+                            messages[j]["content"] = new_output
+                            break
+                overridden_agents.add(id(agent))
+
+    earliest = min(task_overrides)
+    for offset, subsequent in enumerate(crew.tasks[earliest + 1 :], start=earliest + 1):
+        if subsequent.output and offset not in task_overrides:
+            subsequent.output = None
+        if subsequent.agent and subsequent.agent.agent_executor:
+            subsequent.agent.agent_executor._resuming = False
+            if id(subsequent.agent) not in overridden_agents:
+                subsequent.agent.agent_executor.messages = []
+    click.echo()
+
+
 async def _run_checkpoint_tui_async(location: str) -> None:
     """Async implementation of the checkpoint TUI flow."""
     import click
@@ -545,13 +611,54 @@ async def _run_checkpoint_tui_async(location: str) -> None:
     if selection is None:
         return
 
-    selected, action, inputs, task_overrides = selection
+    selected, action, inputs, task_overrides, entity_type = selection
 
-    from crewai.crew import Crew
     from crewai.state.checkpoint_config import CheckpointConfig
 
     config = CheckpointConfig(restore_from=selected)
 
+    if entity_type == "flow":
+        from crewai.events.event_bus import crewai_event_bus
+        from crewai.flow.flow import Flow
+
+        if action == "fork":
+            click.echo(f"\nForking flow from: {selected}\n")
+            flow = Flow.fork(config)
+        else:
+            click.echo(f"\nResuming flow from: {selected}\n")
+            flow = Flow.from_checkpoint(config)
+
+        if task_overrides:
+            from crewai.crew import Crew as CrewCls
+
+            state = crewai_event_bus._runtime_state
+            if state is not None:
+                flat_offset = 0
+                for entity in state.root:
+                    if not isinstance(entity, CrewCls) or not entity.tasks:
+                        continue
+                    n = len(entity.tasks)
+                    local = {
+                        idx - flat_offset: out
+                        for idx, out in task_overrides.items()
+                        if flat_offset <= idx < flat_offset + n
+                    }
+                    if local:
+                        _apply_task_overrides(entity, local)
+                    flat_offset += n
+
+        if inputs:
+            click.echo("Inputs:")
+            for k, v in inputs.items():
+                click.echo(f"  {k}: {v}")
+            click.echo()
+
+        result = await flow.kickoff_async(inputs=inputs)
+        click.echo(f"\nResult: {getattr(result, 'raw', result)}")
+        return
+
+    from crewai.crew import Crew
+
     if action == "fork":
         click.echo(f"\nForking from: {selected}\n")
         crew = Crew.fork(config)
@@ -560,50 +667,7 @@ async def _run_checkpoint_tui_async(location: str) -> None:
         crew = Crew.from_checkpoint(config)
 
     if task_overrides:
-        click.echo("Modifications:")
-        overridden_agents: set[int] = set()
-        for task_idx, new_output in task_overrides.items():
-            if task_idx < len(crew.tasks) and crew.tasks[task_idx].output is not None:
-                desc = crew.tasks[task_idx].description or f"Task {task_idx + 1}"
-                if len(desc) > 60:
-                    desc = desc[:57] + "..."
-                crew.tasks[task_idx].output.raw = new_output  # type: ignore[union-attr]
-                preview = new_output.replace("\n", " ")
-                if len(preview) > 80:
-                    preview = preview[:77] + "..."
-                click.echo(f"  Task {task_idx + 1}: {desc}")
-                click.echo(f"    -> {preview}")
-                agent = crew.tasks[task_idx].agent
-                if agent and agent.agent_executor:
-                    nth = sum(1 for t in crew.tasks[:task_idx] if t.agent is agent)
-                    messages = agent.agent_executor.messages
-                    system_positions = [
-                        i for i, m in enumerate(messages) if m.get("role") == "system"
-                    ]
-                    if nth < len(system_positions):
-                        seg_start = system_positions[nth]
-                        seg_end = (
-                            system_positions[nth + 1]
-                            if nth + 1 < len(system_positions)
-                            else len(messages)
-                        )
-                        for j in range(seg_end - 1, seg_start, -1):
-                            if messages[j].get("role") == "assistant":
-                                messages[j]["content"] = new_output
-                                break
-                    overridden_agents.add(id(agent))
-
-        earliest = min(task_overrides)
-        for offset, subsequent in enumerate(
-            crew.tasks[earliest + 1 :], start=earliest + 1
-        ):
-            if subsequent.output and offset not in task_overrides:
-                subsequent.output = None
-            if subsequent.agent and subsequent.agent.agent_executor:
-                subsequent.agent.agent_executor._resuming = False
-                if id(subsequent.agent) not in overridden_agents:
-                    subsequent.agent.agent_executor.messages = []
-        click.echo()
+        _apply_task_overrides(crew, task_overrides)
 
     if inputs:
         click.echo("Inputs:")
diff --git a/lib/crewai/src/crewai/flow/flow.py b/lib/crewai/src/crewai/flow/flow.py
index 057f60ffb..88457f7aa 100644
--- a/lib/crewai/src/crewai/flow/flow.py
+++ b/lib/crewai/src/crewai/flow/flow.py
@@ -2138,7 +2138,9 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):
 
         try:
             # Reset flow state for fresh execution unless restoring from persistence
-            is_restoring = inputs and "id" in inputs and self.persistence is not None
+            is_restoring = (
+                inputs and "id" in inputs and self.persistence is not None
+            ) or self.checkpoint_completed_methods is not None
             if not is_restoring:
                 # Clear completed methods and outputs for a fresh start
                 self._completed_methods.clear()

From baf91d8f0a15103d39e3cb87aafbb3d31229b600 Mon Sep 17 00:00:00 2001
From: iris-clawd <iris@crewai.com>
Date: Thu, 16 Apr 2026 11:01:59 -0700
Subject: [PATCH 66/70] fix: update broken enterprise link on installation page
 (OSS-36) (#5443)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* fix: update broken enterprise link on installation page (OSS-36)

The 'Explore Enterprise Options' card on the installation page linked to
https://crewai.com/enterprise which returns a 404. Updated the href to
https://crewai.com/amp across all locales (en, pt-BR, ko, ar).

* fix: use HubSpot form link for enterprise options card

Updated per team feedback — the enterprise card should link to the
HubSpot demo form instead of crewai.com/amp.

---------

Co-authored-by: Lorenze Jay <63378463+lorenzejay@users.noreply.github.com>
---
 docs/ar/installation.mdx    | 2 +-
 docs/en/installation.mdx    | 2 +-
 docs/ko/installation.mdx    | 2 +-
 docs/pt-BR/installation.mdx | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/ar/installation.mdx b/docs/ar/installation.mdx
index 3a902fae0..6690e72ec 100644
--- a/docs/ar/installation.mdx
+++ b/docs/ar/installation.mdx
@@ -196,7 +196,7 @@ python3 --version
 - يدعم أي مزود سحابي بما في ذلك النشر المحلي
 - تكامل مع أنظمة الأمان الحالية
 
-<Card title="استكشف خيارات المؤسسات" icon="building" href="https://crewai.com/enterprise">
+<Card title="استكشف خيارات المؤسسات" icon="building" href="https://share.hsforms.com/1Ooo2UViKQ22UOzdr7i77iwr87kg">
   تعرّف على عروض CrewAI للمؤسسات وجدول عرضًا توضيحيًا
 </Card>
 </Note>
diff --git a/docs/en/installation.mdx b/docs/en/installation.mdx
index 727f71220..50f43ff9d 100644
--- a/docs/en/installation.mdx
+++ b/docs/en/installation.mdx
@@ -199,7 +199,7 @@ For teams and organizations, CrewAI offers enterprise deployment options that el
 - Supports any hyperscaler including on prem deployments
 - Integration with your existing security systems
 
-<Card title="Explore Enterprise Options" icon="building" href="https://crewai.com/enterprise">
+<Card title="Explore Enterprise Options" icon="building" href="https://share.hsforms.com/1Ooo2UViKQ22UOzdr7i77iwr87kg">
   Learn about CrewAI's enterprise offerings and schedule a demo
 </Card>
 </Note>
diff --git a/docs/ko/installation.mdx b/docs/ko/installation.mdx
index fc47d796b..6363f3271 100644
--- a/docs/ko/installation.mdx
+++ b/docs/ko/installation.mdx
@@ -189,7 +189,7 @@ CrewAI는 의존성 관리와 패키지 처리를 위해 `uv`를 사용합니다
 - 온프레미스 배포를 포함하여 모든 하이퍼스케일러 지원
 - 기존 보안 시스템과의 통합
 
-<Card title="엔터프라이즈 옵션 살펴보기" icon="building" href="https://crewai.com/enterprise">
+<Card title="엔터프라이즈 옵션 살펴보기" icon="building" href="https://share.hsforms.com/1Ooo2UViKQ22UOzdr7i77iwr87kg">
   CrewAI의 엔터프라이즈 서비스에 대해 알아보고 데모를 예약하세요
 </Card>
 </Note>
diff --git a/docs/pt-BR/installation.mdx b/docs/pt-BR/installation.mdx
index 868778af8..74d0445d3 100644
--- a/docs/pt-BR/installation.mdx
+++ b/docs/pt-BR/installation.mdx
@@ -191,7 +191,7 @@ Para equipes e organizações, o CrewAI oferece opções de implantação corpor
 - Compatível com qualquer hyperscaler, incluindo ambientes on-premises
 - Integração com seus sistemas de segurança existentes
 
-<Card title="Explore as Opções Enterprise" icon="building" href="https://crewai.com/enterprise">
+<Card title="Explore as Opções Enterprise" icon="building" href="https://share.hsforms.com/1Ooo2UViKQ22UOzdr7i77iwr87kg">
   Saiba mais sobre as soluções enterprise do CrewAI e agende uma demonstração
 </Card>
 </Note>

From fbe2a040645cc3ef2f3938279c026b58a52616bf Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Fri, 17 Apr 2026 02:39:22 +0800
Subject: [PATCH 67/70] fix: mock Repository.__init__ in
 test_publish_when_not_in_sync

---
 lib/crewai/tests/cli/tools/test_main.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/lib/crewai/tests/cli/tools/test_main.py b/lib/crewai/tests/cli/tools/test_main.py
index 31032a072..ed51db74a 100644
--- a/lib/crewai/tests/cli/tools/test_main.py
+++ b/lib/crewai/tests/cli/tools/test_main.py
@@ -161,7 +161,8 @@ def test_install_api_error(mock_get, capsys, tool_command):
 
 
 @patch("crewai.cli.tools.main.git.Repository.is_synced", return_value=False)
-def test_publish_when_not_in_sync(mock_is_synced, capsys, tool_command):
+@patch("crewai.cli.tools.main.git.Repository.__init__", return_value=None)
+def test_publish_when_not_in_sync(mock_init, mock_is_synced, capsys, tool_command):
     with raises(SystemExit):
         tool_command.publish(is_public=True)
 

From 6136228a66d94d77f4899548812ce866577f4117 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Fri, 17 Apr 2026 03:02:03 +0800
Subject: [PATCH 68/70] fix: scope streaming handlers to prevent cross-run
 chunk contamination

Concurrent streaming runs registered handlers on the singleton event bus
that received all LLMStreamChunkEvent emissions, causing chunks to fan
out across unrelated queues. Introduces a ContextVar-based stream scope
ID so each handler only accepts events from its own execution context.

Closes #5376
---
 lib/crewai/src/crewai/utilities/streaming.py | 38 +++++++--
 lib/crewai/tests/test_streaming.py           | 88 ++++++++++++++++++++
 2 files changed, 117 insertions(+), 9 deletions(-)

diff --git a/lib/crewai/src/crewai/utilities/streaming.py b/lib/crewai/src/crewai/utilities/streaming.py
index 008144bff..99bc9b199 100644
--- a/lib/crewai/src/crewai/utilities/streaming.py
+++ b/lib/crewai/src/crewai/utilities/streaming.py
@@ -7,6 +7,7 @@ import logging
 import queue
 import threading
 from typing import Any, NamedTuple
+import uuid
 
 from typing_extensions import TypedDict
 
@@ -25,6 +26,10 @@ from crewai.utilities.string_utils import sanitize_tool_name
 
 logger = logging.getLogger(__name__)
 
+_current_stream_ids: contextvars.ContextVar[tuple[str, ...]] = contextvars.ContextVar(
+    "_current_stream_ids", default=()
+)
+
 
 class TaskInfo(TypedDict):
     """Task context information for streaming."""
@@ -45,6 +50,7 @@ class StreamingState(NamedTuple):
     async_queue: asyncio.Queue[StreamChunk | None | Exception] | None
     loop: asyncio.AbstractEventLoop | None
     handler: Callable[[Any, BaseEvent], None]
+    stream_id: str | None = None
 
 
 def _extract_tool_call_info(
@@ -106,6 +112,7 @@ def _create_stream_handler(
     sync_queue: queue.Queue[StreamChunk | None | Exception],
     async_queue: asyncio.Queue[StreamChunk | None | Exception] | None = None,
     loop: asyncio.AbstractEventLoop | None = None,
+    stream_id: str | None = None,
 ) -> Callable[[Any, BaseEvent], None]:
     """Create a stream handler function.
 
@@ -114,21 +121,19 @@ def _create_stream_handler(
         sync_queue: Synchronous queue for chunks.
         async_queue: Optional async queue for chunks.
         loop: Optional event loop for async operations.
+        stream_id: Stream scope ID for concurrent isolation.
 
     Returns:
         Handler function that can be registered with the event bus.
     """
 
     def stream_handler(_: Any, event: BaseEvent) -> None:
-        """Handle LLM stream chunk events and enqueue them.
-
-        Args:
-            _: Event source (unused).
-            event: The event to process.
-        """
         if not isinstance(event, LLMStreamChunkEvent):
             return
 
+        if stream_id is not None and stream_id not in _current_stream_ids.get():
+            return
+
         chunk = _create_stream_chunk(event, current_task_info)
 
         if async_queue is not None and loop is not None:
@@ -203,7 +208,11 @@ def create_streaming_state(
         async_queue = asyncio.Queue()
         loop = asyncio.get_event_loop()
 
-    handler = _create_stream_handler(current_task_info, sync_queue, async_queue, loop)
+    stream_id = str(uuid.uuid4())
+
+    handler = _create_stream_handler(
+        current_task_info, sync_queue, async_queue, loop, stream_id=stream_id
+    )
     crewai_event_bus.register_handler(LLMStreamChunkEvent, handler)
 
     return StreamingState(
@@ -213,6 +222,7 @@ def create_streaming_state(
         async_queue=async_queue,
         loop=loop,
         handler=handler,
+        stream_id=stream_id,
     )
 
 
@@ -260,7 +270,12 @@ def create_chunk_generator(
     Yields:
         StreamChunk objects as they arrive.
     """
-    ctx = contextvars.copy_context()
+    if state.stream_id is not None:
+        token = _current_stream_ids.set((*_current_stream_ids.get(), state.stream_id))
+        ctx = contextvars.copy_context()
+        _current_stream_ids.reset(token)
+    else:
+        ctx = contextvars.copy_context()
     thread = threading.Thread(target=ctx.run, args=(run_func,), daemon=True)
     thread.start()
 
@@ -300,7 +315,12 @@ async def create_async_chunk_generator(
             "Async queue not initialized. Use create_streaming_state(use_async=True)."
         )
 
-    task = asyncio.create_task(run_coro())
+    if state.stream_id is not None:
+        token = _current_stream_ids.set((*_current_stream_ids.get(), state.stream_id))
+        task = asyncio.create_task(run_coro())
+        _current_stream_ids.reset(token)
+    else:
+        task = asyncio.create_task(run_coro())
 
     try:
         while True:
diff --git a/lib/crewai/tests/test_streaming.py b/lib/crewai/tests/test_streaming.py
index 7b1c8e1ba..9079c393f 100644
--- a/lib/crewai/tests/test_streaming.py
+++ b/lib/crewai/tests/test_streaming.py
@@ -879,3 +879,91 @@ class TestStreamingImports:
         assert StreamChunk is not None
         assert StreamChunkType is not None
         assert ToolCallChunk is not None
+
+
+class TestConcurrentStreamIsolation:
+    """Regression tests for concurrent streaming isolation (issue #5376)."""
+
+    def test_concurrent_streams_do_not_cross_contaminate(self) -> None:
+        """Two concurrent streaming runs must each receive only their own chunks.
+
+        Mirrors the real production path: create_streaming_state in the caller,
+        then temporarily push the stream_id into the ContextVar, copy_context,
+        and reset — exactly as create_chunk_generator does.
+        """
+        import contextvars
+        import threading
+
+        from crewai.utilities.streaming import (
+            TaskInfo,
+            _current_stream_ids,
+            _unregister_handler,
+            create_streaming_state,
+        )
+
+        task_info_a: TaskInfo = {
+            "index": 0,
+            "name": "task_a",
+            "id": "a",
+            "agent_role": "A",
+            "agent_id": "a",
+        }
+        task_info_b: TaskInfo = {
+            "index": 1,
+            "name": "task_b",
+            "id": "b",
+            "agent_role": "B",
+            "agent_id": "b",
+        }
+
+        state_a = create_streaming_state(task_info_a, [])
+        state_b = create_streaming_state(task_info_b, [])
+
+        def make_emitter_ctx(state: Any) -> contextvars.Context:
+            token = _current_stream_ids.set(
+                (*_current_stream_ids.get(), state.stream_id)
+            )
+            ctx = contextvars.copy_context()
+            _current_stream_ids.reset(token)
+            return ctx
+
+        ctx_a = make_emitter_ctx(state_a)
+        ctx_b = make_emitter_ctx(state_b)
+
+        def emit_chunks(prefix: str, call_id: str) -> None:
+            for text in [f"{prefix}1", f"{prefix}2", f"{prefix}3"]:
+                crewai_event_bus.emit(
+                    None,
+                    event=LLMStreamChunkEvent(
+                        chunk=text, call_id=call_id, response_id="r"
+                    ),
+                )
+
+        t_a = threading.Thread(target=ctx_a.run, args=(lambda: emit_chunks("A", "ca"),))
+        t_b = threading.Thread(target=ctx_b.run, args=(lambda: emit_chunks("B", "cb"),))
+        t_a.start()
+        t_b.start()
+        t_a.join()
+        t_b.join()
+
+        chunks_a: list[str] = []
+        while not state_a.sync_queue.empty():
+            item = state_a.sync_queue.get_nowait()
+            if isinstance(item, StreamChunk):
+                chunks_a.append(item.content)
+
+        chunks_b: list[str] = []
+        while not state_b.sync_queue.empty():
+            item = state_b.sync_queue.get_nowait()
+            if isinstance(item, StreamChunk):
+                chunks_b.append(item.content)
+
+        assert set(chunks_a) == {"A1", "A2", "A3"}, (
+            f"Stream A received unexpected chunks: {chunks_a}"
+        )
+        assert set(chunks_b) == {"B1", "B2", "B3"}, (
+            f"Stream B received unexpected chunks: {chunks_b}"
+        )
+
+        _unregister_handler(state_a.handler)
+        _unregister_handler(state_b.handler)

From 54391fdbdf4e20dddb48577e600d5e68abd93564 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Fri, 17 Apr 2026 03:40:37 +0800
Subject: [PATCH 69/70] feat: add from_checkpoint parameter to Agent.kickoff,
 kickoff_async, akickoff

---
 lib/crewai/src/crewai/agent/core.py | 31 ++++++++++++++++++++++++++++-
 lib/crewai/tests/test_checkpoint.py | 25 +++++++++++++++++++++++
 2 files changed, 55 insertions(+), 1 deletion(-)

diff --git a/lib/crewai/src/crewai/agent/core.py b/lib/crewai/src/crewai/agent/core.py
index 597b69dc9..b83752344 100644
--- a/lib/crewai/src/crewai/agent/core.py
+++ b/lib/crewai/src/crewai/agent/core.py
@@ -84,6 +84,7 @@ from crewai.rag.embeddings.types import EmbedderConfig
 from crewai.security.fingerprint import Fingerprint
 from crewai.skills.loader import activate_skill, discover_skills
 from crewai.skills.models import INSTRUCTIONS, Skill as SkillModel
+from crewai.state.checkpoint_config import CheckpointConfig, apply_checkpoint
 from crewai.tools.agent_tools.agent_tools import AgentTools
 from crewai.types.callback import SerializableCallable
 from crewai.utilities.agent_utils import (
@@ -1457,6 +1458,7 @@ class Agent(BaseAgent):
         messages: str | list[LLMMessage],
         response_format: type[Any] | None = None,
         input_files: dict[str, FileInput] | None = None,
+        from_checkpoint: CheckpointConfig | None = None,
     ) -> LiteAgentOutput | Coroutine[Any, Any, LiteAgentOutput]:
         """Execute the agent with the given messages using the AgentExecutor.
 
@@ -1475,6 +1477,9 @@ class Agent(BaseAgent):
             response_format: Optional Pydantic model for structured output.
             input_files: Optional dict of named files to attach to the message.
                    Files can be paths, bytes, or File objects from crewai_files.
+            from_checkpoint: Optional checkpoint config. If ``restore_from``
+                is set, the agent resumes from that checkpoint. Remaining
+                config fields enable checkpointing for the run.
 
         Returns:
             LiteAgentOutput: The result of the agent execution.
@@ -1483,6 +1488,14 @@ class Agent(BaseAgent):
         Note:
             For explicit async usage outside of Flow, use kickoff_async() directly.
         """
+        restored = apply_checkpoint(self, from_checkpoint)
+        if restored is not None:
+            return restored.kickoff(  # type: ignore[no-any-return]
+                messages=messages,
+                response_format=response_format,
+                input_files=input_files,
+            )
+
         if is_inside_event_loop():
             return self.kickoff_async(messages, response_format, input_files)
 
@@ -1760,6 +1773,7 @@ class Agent(BaseAgent):
         messages: str | list[LLMMessage],
         response_format: type[Any] | None = None,
         input_files: dict[str, FileInput] | None = None,
+        from_checkpoint: CheckpointConfig | None = None,
     ) -> LiteAgentOutput:
         """Execute the agent asynchronously with the given messages.
 
@@ -1775,10 +1789,20 @@ class Agent(BaseAgent):
             response_format: Optional Pydantic model for structured output.
             input_files: Optional dict of named files to attach to the message.
                    Files can be paths, bytes, or File objects from crewai_files.
+            from_checkpoint: Optional checkpoint config. If ``restore_from``
+                is set, the agent resumes from that checkpoint.
 
         Returns:
             LiteAgentOutput: The result of the agent execution.
         """
+        restored = apply_checkpoint(self, from_checkpoint)
+        if restored is not None:
+            return await restored.kickoff_async(  # type: ignore[no-any-return]
+                messages=messages,
+                response_format=response_format,
+                input_files=input_files,
+            )
+
         executor, inputs, agent_info, parsed_tools = self._prepare_kickoff(
             messages, response_format, input_files
         )
@@ -1808,6 +1832,7 @@ class Agent(BaseAgent):
         messages: str | list[LLMMessage],
         response_format: type[Any] | None = None,
         input_files: dict[str, FileInput] | None = None,
+        from_checkpoint: CheckpointConfig | None = None,
     ) -> LiteAgentOutput:
         """Async version of kickoff. Alias for kickoff_async.
 
@@ -1815,8 +1840,12 @@ class Agent(BaseAgent):
             messages: Either a string query or a list of message dictionaries.
             response_format: Optional Pydantic model for structured output.
             input_files: Optional dict of named files to attach to the message.
+            from_checkpoint: Optional checkpoint config. If ``restore_from``
+                is set, the agent resumes from that checkpoint.
 
         Returns:
             LiteAgentOutput: The result of the agent execution.
         """
-        return await self.kickoff_async(messages, response_format, input_files)
+        return await self.kickoff_async(
+            messages, response_format, input_files, from_checkpoint
+        )
diff --git a/lib/crewai/tests/test_checkpoint.py b/lib/crewai/tests/test_checkpoint.py
index f645541a4..b1ad9e2df 100644
--- a/lib/crewai/tests/test_checkpoint.py
+++ b/lib/crewai/tests/test_checkpoint.py
@@ -523,6 +523,31 @@ class TestKickoffFromCheckpoint:
         assert isinstance(crew.checkpoint, CheckpointConfig)
         assert crew.checkpoint.on_events == ["task_completed"]
 
+    def test_agent_kickoff_delegates_to_from_checkpoint(self) -> None:
+        mock_restored = MagicMock(spec=Agent)
+        mock_restored.kickoff.return_value = "agent_result"
+
+        cfg = CheckpointConfig(restore_from="/path/to/agent_cp.json")
+        with patch.object(Agent, "from_checkpoint", return_value=mock_restored):
+            agent = Agent(role="r", goal="g", backstory="b", llm="gpt-4o-mini")
+            result = agent.kickoff(messages="hello", from_checkpoint=cfg)
+
+        mock_restored.kickoff.assert_called_once_with(
+            messages="hello", response_format=None, input_files=None
+        )
+        assert mock_restored.checkpoint.restore_from is None
+        assert result == "agent_result"
+
+    def test_agent_kickoff_config_only_sets_checkpoint(self) -> None:
+        cfg = CheckpointConfig(on_events=["lite_agent_execution_completed"])
+        agent = Agent(role="r", goal="g", backstory="b", llm="gpt-4o-mini")
+        assert agent.checkpoint is None
+        with patch.object(Agent, "_prepare_kickoff", side_effect=RuntimeError("stop")):
+            with pytest.raises(RuntimeError, match="stop"):
+                agent.kickoff(messages="hello", from_checkpoint=cfg)
+        assert isinstance(agent.checkpoint, CheckpointConfig)
+        assert agent.checkpoint.on_events == ["lite_agent_execution_completed"]
+
     def test_flow_kickoff_delegates_to_from_checkpoint(self) -> None:
         mock_restored = MagicMock(spec=Flow)
         mock_restored.kickoff.return_value = "flow_result"

From c5192b970c498010d9008263249ca5598c2b2459 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson.r.lalonde@gmail.com>
Date: Fri, 17 Apr 2026 04:50:15 +0800
Subject: [PATCH 70/70] feat: add checkpoint resume, diff, prune commands and
 save discoverability

Add three new CLI subcommands to improve checkpoint UX:

- `crewai checkpoint resume [id]` skips the TUI and resumes from the
  latest or specified checkpoint directly
- `crewai checkpoint diff <id1> <id2>` compares two checkpoints showing
  changes in metadata, inputs, task status, and outputs
- `crewai checkpoint prune --keep N --older-than Xd` removes old
  checkpoints from JSON dirs or SQLite databases

Also writes a resume hint to stderr after every checkpoint save so
users discover the command without needing to know it exists.
---
 lib/crewai/src/crewai/cli/checkpoint_cli.py   | 308 +++++++++++++-
 lib/crewai/src/crewai/cli/cli.py              |  43 ++
 .../src/crewai/state/checkpoint_listener.py   |   6 +
 lib/crewai/tests/test_checkpoint_cli.py       | 402 ++++++++++++++++++
 4 files changed, 758 insertions(+), 1 deletion(-)
 create mode 100644 lib/crewai/tests/test_checkpoint_cli.py

diff --git a/lib/crewai/src/crewai/cli/checkpoint_cli.py b/lib/crewai/src/crewai/cli/checkpoint_cli.py
index 1745c224f..9db783e0e 100644
--- a/lib/crewai/src/crewai/cli/checkpoint_cli.py
+++ b/lib/crewai/src/crewai/cli/checkpoint_cli.py
@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from datetime import datetime
+from datetime import datetime, timedelta, timezone
 import glob
 import json
 import os
@@ -37,6 +37,26 @@ ORDER BY rowid DESC
 LIMIT 1
 """
 
+_DELETE_OLDER_THAN = """
+DELETE FROM checkpoints
+WHERE created_at < ?
+"""
+
+_DELETE_KEEP_N = """
+DELETE FROM checkpoints WHERE rowid NOT IN (
+    SELECT rowid FROM checkpoints ORDER BY rowid DESC LIMIT ?
+)
+"""
+
+_COUNT_CHECKPOINTS = "SELECT COUNT(*) FROM checkpoints"
+
+_SELECT_LIKE = """
+SELECT id, created_at, json(data)
+FROM checkpoints
+WHERE id LIKE ?
+ORDER BY rowid DESC
+"""
+
 
 _DEFAULT_DIR = "./.checkpoints"
 _DEFAULT_DB = "./.checkpoints.db"
@@ -262,6 +282,8 @@ def _info_sqlite_latest(db_path: str) -> dict[str, Any] | None:
 def _info_sqlite_id(db_path: str, checkpoint_id: str) -> dict[str, Any] | None:
     with sqlite3.connect(db_path) as conn:
         row = conn.execute(_SELECT_ONE, (checkpoint_id,)).fetchone()
+        if not row:
+            row = conn.execute(_SELECT_LIKE, (f"%{checkpoint_id}%",)).fetchone()
     if not row:
         return None
     cid, created_at, raw = row
@@ -384,3 +406,287 @@ def _print_info(meta: dict[str, Any]) -> None:
                 if len(desc) > 70:
                     desc = desc[:67] + "..."
                 click.echo(f"    {i + 1}. [{status}] {desc}")
+
+
+def _resolve_checkpoint(
+    location: str, checkpoint_id: str | None
+) -> dict[str, Any] | None:
+    if _is_sqlite(location):
+        if checkpoint_id:
+            return _info_sqlite_id(location, checkpoint_id)
+        return _info_sqlite_latest(location)
+    if os.path.isdir(location):
+        if checkpoint_id:
+            from crewai.state.provider.json_provider import JsonProvider
+
+            _json_provider: JsonProvider = JsonProvider()
+            pattern: str = os.path.join(location, "**", "*.json")
+            all_files: list[str] = glob.glob(pattern, recursive=True)
+            matches: list[str] = [
+                f for f in all_files if checkpoint_id in _json_provider.extract_id(f)
+            ]
+            matches.sort(key=os.path.getmtime, reverse=True)
+            if matches:
+                return _info_json_file(matches[0])
+            return None
+        return _info_json_latest(location)
+    if os.path.isfile(location):
+        return _info_json_file(location)
+    return None
+
+
+def _entity_type_from_meta(meta: dict[str, Any]) -> str:
+    for ent in meta.get("entities", []):
+        if ent.get("type") == "flow":
+            return "flow"
+    return "crew"
+
+
+def resume_checkpoint(location: str, checkpoint_id: str | None) -> None:
+    import asyncio
+
+    meta: dict[str, Any] | None = _resolve_checkpoint(location, checkpoint_id)
+    if meta is None:
+        if checkpoint_id:
+            click.echo(f"Checkpoint not found: {checkpoint_id}")
+        else:
+            click.echo(f"No checkpoints found in {location}")
+        return
+
+    restore_path: str = meta.get("path") or meta.get("source", "")
+    if meta.get("db"):
+        restore_path = f"{meta['db']}#{meta['name']}"
+
+    click.echo(f"Resuming from: {meta.get('name', restore_path)}")
+    _print_info(meta)
+    click.echo()
+
+    from crewai.state.checkpoint_config import CheckpointConfig
+
+    config: CheckpointConfig = CheckpointConfig(restore_from=restore_path)
+    entity_type: str = _entity_type_from_meta(meta)
+    inputs: dict[str, Any] | None = meta.get("inputs") or None
+
+    if entity_type == "flow":
+        from crewai.flow.flow import Flow
+
+        flow = Flow.from_checkpoint(config)
+        result = asyncio.run(flow.kickoff_async(inputs=inputs))
+    else:
+        from crewai.crew import Crew
+
+        crew = Crew.from_checkpoint(config)
+        result = asyncio.run(crew.akickoff(inputs=inputs))
+
+    click.echo(f"\nResult: {getattr(result, 'raw', result)}")
+
+
+def _task_list_from_meta(meta: dict[str, Any]) -> list[dict[str, Any]]:
+    tasks: list[dict[str, Any]] = []
+    for ent in meta.get("entities", []):
+        tasks.extend(
+            {
+                "entity": ent.get("name", "unnamed"),
+                "description": t.get("description", ""),
+                "completed": t.get("completed", False),
+                "output": t.get("output", ""),
+            }
+            for t in ent.get("tasks", [])
+        )
+    return tasks
+
+
+def diff_checkpoints(location: str, id1: str, id2: str) -> None:
+    meta1: dict[str, Any] | None = _resolve_checkpoint(location, id1)
+    meta2: dict[str, Any] | None = _resolve_checkpoint(location, id2)
+
+    if meta1 is None:
+        click.echo(f"Checkpoint not found: {id1}")
+        return
+    if meta2 is None:
+        click.echo(f"Checkpoint not found: {id2}")
+        return
+
+    name1: str = meta1.get("name", id1)
+    name2: str = meta2.get("name", id2)
+
+    click.echo(f"--- {name1}")
+    click.echo(f"+++ {name2}")
+    click.echo()
+
+    fields: list[tuple[str, str]] = [
+        ("Time", "ts"),
+        ("Branch", "branch"),
+        ("Trigger", "trigger"),
+        ("Events", "event_count"),
+    ]
+    for label, key in fields:
+        v1: str = str(meta1.get(key, ""))
+        v2: str = str(meta2.get(key, ""))
+        if v1 != v2:
+            click.echo(f"  {label}:")
+            click.echo(f"    - {v1}")
+            click.echo(f"    + {v2}")
+
+    inputs1: dict[str, Any] = meta1.get("inputs", {})
+    inputs2: dict[str, Any] = meta2.get("inputs", {})
+    all_keys: list[str] = sorted(set(list(inputs1.keys()) + list(inputs2.keys())))
+    changed_inputs: list[tuple[str, Any, Any]] = [
+        (k, inputs1.get(k, ""), inputs2.get(k, ""))
+        for k in all_keys
+        if inputs1.get(k) != inputs2.get(k)
+    ]
+    if changed_inputs:
+        click.echo("\n  Inputs:")
+        for key, v1, v2 in changed_inputs:
+            click.echo(f"    {key}:")
+            click.echo(f"      - {v1}")
+            click.echo(f"      + {v2}")
+
+    tasks1: list[dict[str, Any]] = _task_list_from_meta(meta1)
+    tasks2: list[dict[str, Any]] = _task_list_from_meta(meta2)
+
+    max_tasks: int = max(len(tasks1), len(tasks2))
+    if max_tasks == 0:
+        return
+
+    click.echo("\n  Tasks:")
+    for i in range(max_tasks):
+        t1: dict[str, Any] | None = tasks1[i] if i < len(tasks1) else None
+        t2: dict[str, Any] | None = tasks2[i] if i < len(tasks2) else None
+
+        if t1 is None:
+            desc: str = t2["description"][:60] if t2 else ""
+            click.echo(f"    + {i + 1}. [new] {desc}")
+            continue
+        if t2 is None:
+            desc = t1["description"][:60]
+            click.echo(f"    - {i + 1}. [removed] {desc}")
+            continue
+
+        desc = str(t1["description"][:60])
+        s1: str = "done" if t1["completed"] else "pending"
+        s2: str = "done" if t2["completed"] else "pending"
+
+        if s1 != s2:
+            click.echo(f"    {i + 1}. {desc}")
+            click.echo(f"      status: {s1} -> {s2}")
+
+        out1: str = (t1.get("output") or "").strip()
+        out2: str = (t2.get("output") or "").strip()
+        if out1 != out2:
+            if s1 == s2:
+                click.echo(f"    {i + 1}. {desc}")
+            preview1: str = (
+                out1[:80] + ("..." if len(out1) > 80 else "") if out1 else "(empty)"
+            )
+            preview2: str = (
+                out2[:80] + ("..." if len(out2) > 80 else "") if out2 else "(empty)"
+            )
+            click.echo("      output:")
+            click.echo(f"        - {preview1}")
+            click.echo(f"        + {preview2}")
+
+
+def _parse_duration(value: str) -> timedelta:
+    match: re.Match[str] | None = re.match(r"^(\d+)([dhm])$", value.strip())
+    if not match:
+        raise click.BadParameter(
+            f"Invalid duration: {value!r}. Use format like '7d', '24h', or '30m'."
+        )
+    amount: int = int(match.group(1))
+    unit: str = match.group(2)
+    if unit == "d":
+        return timedelta(days=amount)
+    if unit == "h":
+        return timedelta(hours=amount)
+    return timedelta(minutes=amount)
+
+
+def _prune_json(location: str, keep: int | None, older_than: timedelta | None) -> int:
+    pattern: str = os.path.join(location, "**", "*.json")
+    files: list[str] = sorted(
+        glob.glob(pattern, recursive=True), key=os.path.getmtime, reverse=True
+    )
+    if not files:
+        return 0
+
+    to_delete: set[str] = set()
+
+    if keep is not None and len(files) > keep:
+        to_delete.update(files[keep:])
+
+    if older_than is not None:
+        cutoff: datetime = datetime.now(timezone.utc) - older_than
+        for path in files:
+            mtime: datetime = datetime.fromtimestamp(
+                os.path.getmtime(path), tz=timezone.utc
+            )
+            if mtime < cutoff:
+                to_delete.add(path)
+
+    deleted: int = 0
+    for path in to_delete:
+        try:
+            os.remove(path)
+            deleted += 1
+        except OSError:  # noqa: PERF203
+            pass
+
+    for dirpath, dirnames, filenames in os.walk(location, topdown=False):
+        if dirpath != location and not filenames and not dirnames:
+            try:
+                os.rmdir(dirpath)
+            except OSError:
+                pass
+
+    return deleted
+
+
+def _prune_sqlite(db_path: str, keep: int | None, older_than: timedelta | None) -> int:
+    deleted: int = 0
+    with sqlite3.connect(db_path) as conn:
+        if older_than is not None:
+            cutoff: str = (datetime.now(timezone.utc) - older_than).strftime(
+                "%Y%m%dT%H%M%S"
+            )
+            cursor: sqlite3.Cursor = conn.execute(_DELETE_OLDER_THAN, (cutoff,))
+            deleted += cursor.rowcount
+
+        if keep is not None:
+            cursor = conn.execute(_DELETE_KEEP_N, (keep,))
+            deleted += cursor.rowcount
+
+        conn.commit()
+    return deleted
+
+
+def prune_checkpoints(
+    location: str, keep: int | None, older_than: str | None, dry_run: bool = False
+) -> None:
+    if keep is None and older_than is None:
+        click.echo("Specify --keep N and/or --older-than DURATION (e.g. 7d, 24h)")
+        return
+
+    duration: timedelta | None = _parse_duration(older_than) if older_than else None
+
+    deleted: int
+    if _is_sqlite(location):
+        if dry_run:
+            with sqlite3.connect(location) as conn:
+                total: int = conn.execute(_COUNT_CHECKPOINTS).fetchone()[0]
+            click.echo(f"Would prune from {total} checkpoint(s) in {location}")
+            return
+        deleted = _prune_sqlite(location, keep, duration)
+    elif os.path.isdir(location):
+        if dry_run:
+            files: list[str] = glob.glob(
+                os.path.join(location, "**", "*.json"), recursive=True
+            )
+            click.echo(f"Would prune from {len(files)} checkpoint(s) in {location}")
+            return
+        deleted = _prune_json(location, keep, duration)
+    else:
+        click.echo(f"Not a directory or SQLite database: {location}")
+        return
+    click.echo(f"Pruned {deleted} checkpoint(s) from {location}")
diff --git a/lib/crewai/src/crewai/cli/cli.py b/lib/crewai/src/crewai/cli/cli.py
index bc2a9ee26..dc4284677 100644
--- a/lib/crewai/src/crewai/cli/cli.py
+++ b/lib/crewai/src/crewai/cli/cli.py
@@ -873,5 +873,48 @@ def checkpoint_info(path: str) -> None:
     info_checkpoint(_detect_location(path))
 
 
+@checkpoint.command("resume")
+@click.argument("checkpoint_id", required=False, default=None)
+@click.pass_context
+def checkpoint_resume(ctx: click.Context, checkpoint_id: str | None) -> None:
+    """Resume from a checkpoint. Defaults to the most recent."""
+    from crewai.cli.checkpoint_cli import resume_checkpoint
+
+    resume_checkpoint(ctx.obj["location"], checkpoint_id)
+
+
+@checkpoint.command("diff")
+@click.argument("id1")
+@click.argument("id2")
+@click.pass_context
+def checkpoint_diff(ctx: click.Context, id1: str, id2: str) -> None:
+    """Compare two checkpoints side-by-side."""
+    from crewai.cli.checkpoint_cli import diff_checkpoints
+
+    diff_checkpoints(ctx.obj["location"], id1, id2)
+
+
+@checkpoint.command("prune")
+@click.option(
+    "--keep", type=int, default=None, help="Keep the N most recent checkpoints."
+)
+@click.option(
+    "--older-than",
+    default=None,
+    help="Remove checkpoints older than duration (e.g. 7d, 24h, 30m).",
+)
+@click.option(
+    "--dry-run", is_flag=True, help="Show what would be pruned without deleting."
+)
+@click.pass_context
+def checkpoint_prune(
+    ctx: click.Context, keep: int | None, older_than: str | None, dry_run: bool
+) -> None:
+    """Remove old checkpoints."""
+    from crewai.cli.checkpoint_cli import prune_checkpoints
+
+    prune_checkpoints(ctx.obj["location"], keep, older_than, dry_run)
+
+
 if __name__ == "__main__":
     crewai()
diff --git a/lib/crewai/src/crewai/state/checkpoint_listener.py b/lib/crewai/src/crewai/state/checkpoint_listener.py
index 2408e88e3..674a8436a 100644
--- a/lib/crewai/src/crewai/state/checkpoint_listener.py
+++ b/lib/crewai/src/crewai/state/checkpoint_listener.py
@@ -120,6 +120,12 @@ def _do_checkpoint(
     )
     state._chain_lineage(cfg.provider, location)
 
+    checkpoint_id: str = cfg.provider.extract_id(location)
+    msg: str = (
+        f"Checkpoint saved. Resume with: crewai checkpoint resume {checkpoint_id}"
+    )
+    logger.info(msg)
+
     if cfg.max_checkpoints is not None:
         cfg.provider.prune(cfg.location, cfg.max_checkpoints, branch=state._branch)
 
diff --git a/lib/crewai/tests/test_checkpoint_cli.py b/lib/crewai/tests/test_checkpoint_cli.py
new file mode 100644
index 000000000..38e105cce
--- /dev/null
+++ b/lib/crewai/tests/test_checkpoint_cli.py
@@ -0,0 +1,402 @@
+"""Tests for checkpoint CLI commands."""
+
+from __future__ import annotations
+
+import json
+import os
+import sqlite3
+import tempfile
+import time
+from datetime import datetime, timedelta, timezone
+from typing import Any
+from unittest.mock import MagicMock, patch
+
+import pytest
+from crewai.cli.checkpoint_cli import (
+    _parse_checkpoint_json,
+    _parse_duration,
+    _prune_json,
+    _prune_sqlite,
+    _resolve_checkpoint,
+    _task_list_from_meta,
+    diff_checkpoints,
+    prune_checkpoints,
+    resume_checkpoint,
+)
+
+
+def _make_checkpoint_data(
+    tasks_completed: int = 2,
+    tasks_total: int = 4,
+    trigger: str = "task_completed",
+    branch: str = "main",
+    parent_id: str | None = None,
+    entity_type: str = "crew",
+    name: str = "test_crew",
+    inputs: dict[str, Any] | None = None,
+) -> str:
+    tasks: list[dict[str, Any]] = []
+    for i in range(tasks_total):
+        t: dict[str, Any] = {
+            "description": f"Task {i + 1} description",
+            "expected_output": f"Output {i + 1}",
+        }
+        if i < tasks_completed:
+            t["output"] = {"raw": f"Result of task {i + 1}"}
+        else:
+            t["output"] = None
+        tasks.append(t)
+
+    data: dict[str, Any] = {
+        "entities": [
+            {
+                "entity_type": entity_type,
+                "name": name,
+                "id": "abc12345-1234-1234-1234-abcdef012345",
+                "tasks": tasks,
+                "agents": [],
+                "checkpoint_inputs": inputs or {},
+            }
+        ],
+        "event_record": {"nodes": {f"node_{i}": {} for i in range(3)}},
+        "trigger": trigger,
+        "branch": branch,
+        "parent_id": parent_id,
+    }
+    return json.dumps(data)
+
+
+def _write_json_checkpoint(
+    base_dir: str,
+    branch: str = "main",
+    name: str | None = None,
+    data: str | None = None,
+    tasks_completed: int = 2,
+    inputs: dict[str, Any] | None = None,
+) -> str:
+    branch_dir = os.path.join(base_dir, branch)
+    os.makedirs(branch_dir, exist_ok=True)
+    if name is None:
+        ts = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%S")
+        name = f"{ts}_abcd1234_p-none.json"
+    path = os.path.join(branch_dir, name)
+    if data is None:
+        data = _make_checkpoint_data(tasks_completed=tasks_completed, inputs=inputs)
+    with open(path, "w") as f:
+        f.write(data)
+    return path
+
+
+def _create_sqlite_checkpoint(
+    db_path: str,
+    checkpoint_id: str | None = None,
+    data: str | None = None,
+    tasks_completed: int = 2,
+    branch: str = "main",
+    inputs: dict[str, Any] | None = None,
+) -> str:
+    if checkpoint_id is None:
+        ts = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%S")
+        checkpoint_id = f"{ts}_abcd1234"
+    if data is None:
+        data = _make_checkpoint_data(
+            tasks_completed=tasks_completed, branch=branch, inputs=inputs
+        )
+    with sqlite3.connect(db_path) as conn:
+        conn.execute(
+            """CREATE TABLE IF NOT EXISTS checkpoints (
+                id TEXT PRIMARY KEY,
+                created_at TEXT NOT NULL,
+                parent_id TEXT,
+                branch TEXT NOT NULL DEFAULT 'main',
+                data JSONB NOT NULL
+            )"""
+        )
+        conn.execute(
+            "INSERT INTO checkpoints (id, created_at, parent_id, branch, data) "
+            "VALUES (?, ?, ?, ?, jsonb(?))",
+            (checkpoint_id, checkpoint_id.split("_")[0], None, branch, data),
+        )
+        conn.commit()
+    return checkpoint_id
+
+
+class TestParseDuration:
+    def test_days(self) -> None:
+        assert _parse_duration("7d") == timedelta(days=7)
+
+    def test_hours(self) -> None:
+        assert _parse_duration("24h") == timedelta(hours=24)
+
+    def test_minutes(self) -> None:
+        assert _parse_duration("30m") == timedelta(minutes=30)
+
+    def test_invalid_raises(self) -> None:
+        with pytest.raises(Exception):
+            _parse_duration("abc")
+
+    def test_no_unit_raises(self) -> None:
+        with pytest.raises(Exception):
+            _parse_duration("7")
+
+
+class TestResolveCheckpoint:
+    def test_json_latest(self) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            _write_json_checkpoint(d, name="20260101T000000_aaaa1111_p-none.json")
+            time.sleep(0.01)
+            path2 = _write_json_checkpoint(
+                d, name="20260102T000000_bbbb2222_p-none.json", tasks_completed=3
+            )
+            meta = _resolve_checkpoint(d, None)
+            assert meta is not None
+            assert meta["path"] == path2
+
+    def test_json_by_id(self) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            _write_json_checkpoint(d, name="20260101T000000_aaaa1111_p-none.json")
+            _write_json_checkpoint(d, name="20260102T000000_bbbb2222_p-none.json")
+            meta = _resolve_checkpoint(d, "aaaa1111")
+            assert meta is not None
+            assert "aaaa1111" in meta["name"]
+
+    def test_json_not_found(self) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            _write_json_checkpoint(d)
+            assert _resolve_checkpoint(d, "nonexistent") is None
+
+    def test_sqlite_latest(self) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            db_path = os.path.join(d, "test.db")
+            _create_sqlite_checkpoint(db_path, "20260101T000000_aaaa1111")
+            _create_sqlite_checkpoint(
+                db_path, "20260102T000000_bbbb2222", tasks_completed=3
+            )
+            meta = _resolve_checkpoint(db_path, None)
+            assert meta is not None
+            assert "bbbb2222" in meta["name"]
+
+    def test_sqlite_by_id(self) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            db_path = os.path.join(d, "test.db")
+            _create_sqlite_checkpoint(db_path, "20260101T000000_aaaa1111")
+            _create_sqlite_checkpoint(db_path, "20260102T000000_bbbb2222")
+            meta = _resolve_checkpoint(db_path, "20260101T000000_aaaa1111")
+            assert meta is not None
+            assert "aaaa1111" in meta["name"]
+
+    def test_sqlite_partial_id(self) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            db_path = os.path.join(d, "test.db")
+            _create_sqlite_checkpoint(db_path, "20260101T000000_aaaa1111")
+            _create_sqlite_checkpoint(db_path, "20260102T000000_bbbb2222")
+            meta = _resolve_checkpoint(db_path, "aaaa1111")
+            assert meta is not None
+            assert "aaaa1111" in meta["name"]
+
+    def test_nonexistent(self) -> None:
+        assert _resolve_checkpoint("/nonexistent/path", None) is None
+
+
+class TestTaskListFromMeta:
+    def test_flattens_tasks(self) -> None:
+        data = _make_checkpoint_data(tasks_completed=2, tasks_total=3)
+        meta = _parse_checkpoint_json(data, "test")
+        tasks = _task_list_from_meta(meta)
+        assert len(tasks) == 3
+        assert tasks[0]["completed"] is True
+        assert tasks[2]["completed"] is False
+
+    def test_empty_entities(self) -> None:
+        assert _task_list_from_meta({"entities": []}) == []
+
+
+class TestDiffCheckpoints:
+    def test_diff_shows_status_change(self, capsys: pytest.CaptureFixture[str]) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            _write_json_checkpoint(
+                d, name="20260101T000000_aaaa1111_p-none.json", tasks_completed=1
+            )
+            _write_json_checkpoint(
+                d, name="20260102T000000_bbbb2222_p-none.json", tasks_completed=3
+            )
+            diff_checkpoints(d, "aaaa1111", "bbbb2222")
+            out = capsys.readouterr().out
+            assert "---" in out
+            assert "+++" in out
+            assert "status:" in out or "pending -> done" in out
+
+    def test_diff_shows_output_change(self, capsys: pytest.CaptureFixture[str]) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            data1 = _make_checkpoint_data(tasks_completed=2)
+            data2 = json.loads(data1)
+            data2["entities"][0]["tasks"][0]["output"]["raw"] = "Updated result"
+            _write_json_checkpoint(
+                d,
+                name="20260101T000000_aaaa1111_p-none.json",
+                data=json.dumps(json.loads(data1)),
+            )
+            _write_json_checkpoint(
+                d,
+                name="20260102T000000_bbbb2222_p-none.json",
+                data=json.dumps(data2),
+            )
+            diff_checkpoints(d, "aaaa1111", "bbbb2222")
+            out = capsys.readouterr().out
+            assert "output:" in out
+
+    def test_diff_not_found(self, capsys: pytest.CaptureFixture[str]) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            _write_json_checkpoint(d, name="20260101T000000_aaaa1111_p-none.json")
+            diff_checkpoints(d, "aaaa1111", "nonexistent")
+            out = capsys.readouterr().out
+            assert "not found" in out
+
+    def test_diff_input_change(self, capsys: pytest.CaptureFixture[str]) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            _write_json_checkpoint(
+                d,
+                name="20260101T000000_aaaa1111_p-none.json",
+                inputs={"topic": "AI"},
+            )
+            _write_json_checkpoint(
+                d,
+                name="20260102T000000_bbbb2222_p-none.json",
+                inputs={"topic": "ML"},
+            )
+            diff_checkpoints(d, "aaaa1111", "bbbb2222")
+            out = capsys.readouterr().out
+            assert "Inputs:" in out
+            assert "AI" in out
+            assert "ML" in out
+
+
+class TestPruneJson:
+    def test_keep_n(self) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            for i in range(5):
+                _write_json_checkpoint(
+                    d, name=f"2026010{i + 1}T000000_aaa{i}1111_p-none.json"
+                )
+                time.sleep(0.01)
+            deleted = _prune_json(d, keep=2, older_than=None)
+            assert deleted == 3
+            remaining = []
+            for root, _, files in os.walk(d):
+                remaining.extend(files)
+            assert len(remaining) == 2
+
+    def test_older_than(self) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            old_path = _write_json_checkpoint(
+                d, name="20250101T000000_old01111_p-none.json"
+            )
+            os.utime(old_path, (0, 0))
+            _write_json_checkpoint(d, name="20260417T000000_new01111_p-none.json")
+            deleted = _prune_json(d, keep=None, older_than=timedelta(days=1))
+            assert deleted == 1
+
+    def test_empty_dir(self) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            assert _prune_json(d, keep=2, older_than=None) == 0
+
+    def test_removes_empty_branch_dirs(self) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            path = _write_json_checkpoint(
+                d,
+                branch="feature",
+                name="20260101T000000_aaaa1111_p-none.json",
+            )
+            os.utime(path, (0, 0))
+            _prune_json(d, keep=None, older_than=timedelta(days=1))
+            assert not os.path.exists(os.path.join(d, "feature"))
+
+
+class TestPruneSqlite:
+    def test_keep_n(self) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            db_path = os.path.join(d, "test.db")
+            for i in range(5):
+                _create_sqlite_checkpoint(
+                    db_path, f"2026010{i + 1}T000000_aaa{i}1111"
+                )
+            deleted = _prune_sqlite(db_path, keep=2, older_than=None)
+            assert deleted == 3
+            with sqlite3.connect(db_path) as conn:
+                count = conn.execute("SELECT COUNT(*) FROM checkpoints").fetchone()[0]
+            assert count == 2
+
+    def test_older_than(self) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            db_path = os.path.join(d, "test.db")
+            _create_sqlite_checkpoint(db_path, "20200101T000000_old01111")
+            _create_sqlite_checkpoint(db_path, "20260417T000000_new01111")
+            deleted = _prune_sqlite(db_path, keep=None, older_than=timedelta(days=1))
+            assert deleted >= 1
+            with sqlite3.connect(db_path) as conn:
+                count = conn.execute("SELECT COUNT(*) FROM checkpoints").fetchone()[0]
+            assert count >= 1
+
+
+class TestPruneCommand:
+    def test_no_options_shows_help(self, capsys: pytest.CaptureFixture[str]) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            prune_checkpoints(d, keep=None, older_than=None)
+            out = capsys.readouterr().out
+            assert "Specify" in out
+
+    def test_dry_run_json(self, capsys: pytest.CaptureFixture[str]) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            _write_json_checkpoint(d)
+            prune_checkpoints(d, keep=1, older_than=None, dry_run=True)
+            out = capsys.readouterr().out
+            assert "Would prune" in out
+
+    def test_not_found(self, capsys: pytest.CaptureFixture[str]) -> None:
+        prune_checkpoints("/nonexistent", keep=1, older_than=None)
+        out = capsys.readouterr().out
+        assert "Not a directory" in out
+
+
+class TestResumeCheckpoint:
+    def test_not_found(self, capsys: pytest.CaptureFixture[str]) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            resume_checkpoint(d, "nonexistent")
+            out = capsys.readouterr().out
+            assert "not found" in out
+
+    def test_no_checkpoints(self, capsys: pytest.CaptureFixture[str]) -> None:
+        with tempfile.TemporaryDirectory() as d:
+            resume_checkpoint(d, None)
+            out = capsys.readouterr().out
+            assert "No checkpoints" in out
+
+
+class TestDiscoverabilityMessage:
+    def test_checkpoint_listener_logs_resume_hint(self) -> None:
+        from crewai.state.checkpoint_listener import _do_checkpoint
+        from crewai.state.runtime import RuntimeState
+
+        state = MagicMock(spec=RuntimeState)
+        state.root = []
+        state.model_dump.return_value = {"entities": [], "event_record": {"nodes": {}}}
+        state._parent_id = None
+        state._branch = "main"
+
+        cfg = MagicMock()
+        cfg.location = "/tmp/cp"
+        cfg.max_checkpoints = None
+        cfg.provider.checkpoint.return_value = "/tmp/cp/main/20260101T000000_test1234_p-none.json"
+        cfg.provider.extract_id.return_value = "20260101T000000_test1234"
+
+        with (
+            patch("crewai.state.checkpoint_listener._prepare_entities"),
+            patch("crewai.state.checkpoint_listener.logger") as mock_logger,
+        ):
+            _do_checkpoint(state, cfg)
+
+        cfg.provider.extract_id.assert_called_once()
+        mock_logger.info.assert_called_once()
+        logged: str = mock_logger.info.call_args[0][0]
+        assert "crewai checkpoint resume" in logged
+        assert "20260101T000000_test1234" in logged