Framework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.
chore: improve CrewBase typing
Greyson LaLonde6469f224f6aa
diff --git a/lib/crewai/src/crewai/project/annotations.py b/lib/crewai/src/crewai/project/annotations.pyindex 17a07ddad..a36999052 100644--- a/lib/crewai/src/crewai/project/annotations.py+++ b/lib/crewai/src/crewai/project/annotations.py@@ -4,7 +4,7 @@ from __future__ import annotationsfrom collections.abc import Callablefrom functools import wraps-from typing import TYPE_CHECKING, Concatenate, ParamSpec, TypeVar+from typing import TYPE_CHECKING, Any, Concatenate, ParamSpec, TypeVar, overloadfrom crewai.project.utils import memoize@@ -33,6 +33,7 @@ P2 = ParamSpec("P2")R = TypeVar("R")R2 = TypeVar("R2")T = TypeVar("T")+SelfT = TypeVar("SelfT")def before_kickoff(meth: Callable[P, R]) -> BeforeKickoffMethod[P, R]:@@ -155,9 +156,17 @@ def cache_handler(meth: Callable[P, R]) -> CacheHandlerMethod[P, R]:return CacheHandlerMethod(memoize(meth))+@overload+def crew(+ meth: Callable[Concatenate[SelfT, P], Crew],+) -> Callable[Concatenate[SelfT, P], Crew]: ...+@overloaddef crew(meth: Callable[Concatenate[CrewInstance, P], Crew],-) -> Callable[Concatenate[CrewInstance, P], Crew]:+) -> Callable[Concatenate[CrewInstance, P], Crew]: ...+def crew(+ meth: Callable[..., Crew],+) -> Callable[..., Crew]:"""Marks a method as the main crew execution point.Args:@@ -168,7 +177,7 @@ def crew("""@wraps(meth)- def wrapper(self: CrewInstance, *args: P.args, **kwargs: P.kwargs) -> Crew:+ def wrapper(self: CrewInstance, *args: Any, **kwargs: Any) -> Crew:"""Wrapper that sets up crew before calling the decorated method.Args:diff --git a/lib/crewai/src/crewai/project/crew_base.py b/lib/crewai/src/crewai/project/crew_base.pyindex d2ba2d794..81a84889a 100644--- a/lib/crewai/src/crewai/project/crew_base.py+++ b/lib/crewai/src/crewai/project/crew_base.py@@ -6,7 +6,15 @@ from collections.abc import Callableimport inspectimport loggingfrom pathlib import Path-from typing import TYPE_CHECKING, Any, Literal, TypeGuard, TypeVar, TypedDict, cast+from typing import (+ TYPE_CHECKING,+ Any,+ Literal,+ TypeGuard,+ TypeVar,+ TypedDict,+ cast,+)from dotenv import load_dotenvimport yaml@@ -320,14 +328,17 @@ def get_mcp_tools(self: CrewInstance, *tool_names: str) -> list[BaseTool]:if not self.mcp_server_params:return []- from crewai_tools import MCPServerAdapter # type: ignore[import-untyped]+ from crewai_tools import MCPServerAdapterif self._mcp_server_adapter is None:self._mcp_server_adapter = MCPServerAdapter(self.mcp_server_params, connect_timeout=self.mcp_connect_timeout)- return self._mcp_server_adapter.tools.filter_by_names(tool_names or None)+ return cast(+ list[BaseTool],+ self._mcp_server_adapter.tools.filter_by_names(tool_names or None),+ )def _load_config(@@ -630,3 +641,17 @@ class CrewBase(metaclass=_CrewBaseType):Note:Reference: https://stackoverflow.com/questions/11091609/setting-a-class-metaclass-using-a-decorator"""++ # e+ if TYPE_CHECKING:++ def __init__(self, *args: Any, **kwargs: Any) -> None:+ """Type stub for decorator usage.++ Args:+ decorated_cls: Class to transform with CrewBaseMeta metaclass.++ Returns:+ New class with CrewBaseMeta metaclass applied.+ """+ ...diff --git a/lib/crewai/src/crewai/project/wrappers.py b/lib/crewai/src/crewai/project/wrappers.pyindex 566dd2268..45a1a9e88 100644--- a/lib/crewai/src/crewai/project/wrappers.py+++ b/lib/crewai/src/crewai/project/wrappers.py@@ -124,7 +124,7 @@ class CrewClass(Protocol):get_mcp_tools: Callable[..., list[BaseTool]]_load_config: Callable[..., dict[str, Any]]load_configurations: Callable[..., None]- load_yaml: staticmethod+ load_yaml: Callable[..., dict[str, Any]]map_all_agent_variables: Callable[..., None]_map_agent_variables: Callable[..., None]map_all_task_variables: Callable[..., None]