Framework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.
fix: register checkpoint handlers when CheckpointConfig is created
Greyson LaLondec0f3151e1329
diff --git a/lib/crewai/src/crewai/agents/agent_builder/base_agent.py b/lib/crewai/src/crewai/agents/agent_builder/base_agent.pyindex dbff05e4d..de9379d09 100644--- a/lib/crewai/src/crewai/agents/agent_builder/base_agent.py+++ b/lib/crewai/src/crewai/agents/agent_builder/base_agent.py@@ -39,7 +39,7 @@ from crewai.memory.unified_memory import Memoryfrom crewai.rag.embeddings.types import EmbedderConfigfrom crewai.security.security_config import SecurityConfigfrom crewai.skills.models import Skill-from crewai.state.checkpoint_config import CheckpointConfig+from crewai.state.checkpoint_config import CheckpointConfig, _coerce_checkpointfrom crewai.tools.base_tool import BaseTool, Toolfrom crewai.types.callback import SerializableCallablefrom crewai.utilities.config import process_config@@ -300,7 +300,10 @@ class BaseAgent(BaseModel, ABC, metaclass=AgentMeta):default_factory=SecurityConfig,description="Security configuration for the agent, including fingerprinting.",)- checkpoint: CheckpointConfig | bool | None = Field(+ checkpoint: Annotated[+ CheckpointConfig | bool | None,+ BeforeValidator(_coerce_checkpoint),+ ] = Field(default=None,description="Automatic checkpointing configuration. ""True for defaults, False to opt out, None to inherit.",diff --git a/lib/crewai/src/crewai/crew.py b/lib/crewai/src/crewai/crew.pyindex 4f9ebab5d..e630ec5b0 100644--- a/lib/crewai/src/crewai/crew.py+++ b/lib/crewai/src/crewai/crew.py@@ -104,7 +104,7 @@ from crewai.rag.types import SearchResultfrom crewai.security.fingerprint import Fingerprintfrom crewai.security.security_config import SecurityConfigfrom crewai.skills.models import Skill-from crewai.state.checkpoint_config import CheckpointConfig+from crewai.state.checkpoint_config import CheckpointConfig, _coerce_checkpointfrom crewai.task import Taskfrom crewai.tasks.conditional_task import ConditionalTaskfrom crewai.tasks.task_output import TaskOutput@@ -341,7 +341,10 @@ class Crew(FlowTrackable, BaseModel):default_factory=SecurityConfig,description="Security configuration for the crew, including fingerprinting.",)- checkpoint: CheckpointConfig | bool | None = Field(+ checkpoint: Annotated[+ CheckpointConfig | bool | None,+ BeforeValidator(_coerce_checkpoint),+ ] = Field(default=None,description="Automatic checkpointing configuration. ""True for defaults, False to opt out, None to inherit.",diff --git a/lib/crewai/src/crewai/flow/flow.py b/lib/crewai/src/crewai/flow/flow.pyindex 76a96b3f9..60d03b069 100644--- a/lib/crewai/src/crewai/flow/flow.py+++ b/lib/crewai/src/crewai/flow/flow.py@@ -113,7 +113,7 @@ from crewai.flow.utils import ()from crewai.memory.memory_scope import MemoryScope, MemorySlicefrom crewai.memory.unified_memory import Memory-from crewai.state.checkpoint_config import CheckpointConfig+from crewai.state.checkpoint_config import CheckpointConfig, _coerce_checkpointif TYPE_CHECKING:@@ -921,7 +921,10 @@ class Flow(BaseModel, Generic[T], metaclass=FlowMeta):max_method_calls: int = Field(default=100)execution_context: ExecutionContext | None = Field(default=None)- checkpoint: CheckpointConfig | bool | None = Field(default=None)+ checkpoint: Annotated[+ CheckpointConfig | bool | None,+ BeforeValidator(_coerce_checkpoint),+ ] = Field(default=None)@classmethoddef from_checkpoint(diff --git a/lib/crewai/src/crewai/state/checkpoint_config.py b/lib/crewai/src/crewai/state/checkpoint_config.pyindex 4c5499ff4..84c48bd4e 100644--- a/lib/crewai/src/crewai/state/checkpoint_config.py+++ b/lib/crewai/src/crewai/state/checkpoint_config.py@@ -2,9 +2,9 @@from __future__ import annotations-from typing import Literal+from typing import Any, Literal-from pydantic import BaseModel, Field+from pydantic import BaseModel, Field, model_validatorfrom crewai.state.provider.core import BaseProviderfrom crewai.state.provider.json_provider import JsonProvider@@ -158,6 +158,20 @@ CheckpointEventType = Literal[]+def _coerce_checkpoint(v: Any) -> Any:+ """BeforeValidator for checkpoint fields on Crew/Flow/Agent.++ Converts True to CheckpointConfig and triggers handler registration.+ """+ if v is True:+ v = CheckpointConfig()+ if isinstance(v, CheckpointConfig):+ from crewai.state.checkpoint_listener import _ensure_handlers_registered++ _ensure_handlers_registered()+ return v++class CheckpointConfig(BaseModel):"""Configuration for automatic checkpointing.@@ -185,6 +199,13 @@ class CheckpointConfig(BaseModel):"each write. None means keep all.",)+ @model_validator(mode="after")+ def _register_handlers(self) -> CheckpointConfig:+ from crewai.state.checkpoint_listener import _ensure_handlers_registered++ _ensure_handlers_registered()+ return self+@propertydef trigger_all(self) -> bool:return "*" in self.on_events