Framework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.
fix: dispatch Flow checkpoints through Flow APIs in TUI
Greyson LaLonde7e01c5a03048
diff --git a/lib/crewai/src/crewai/cli/checkpoint_tui.py b/lib/crewai/src/crewai/cli/checkpoint_tui.pyindex 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 annotationsfrom collections import defaultdict-from typing import Any, ClassVar+from typing import Any, ClassVar, Literalfrom textual.app import App, ComposeResultfrom 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.textreturn 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 Crewfrom crewai.state.checkpoint_config import CheckpointConfigconfig = 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.pyindex 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 Noneif not is_restoring:# Clear completed methods and outputs for a fresh startself._completed_methods.clear()