Skip to content

feature(graph): Allow cyclic graphs #497

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 10 commits into
base: main
Choose a base branch
from

Conversation

mkmeral
Copy link
Contributor

@mkmeral mkmeral commented Jul 18, 2025

Description

This PR removes the cyclic graph validation from the multiagent graph implementation, based on customer feedback. Previously, the graph implementation enforced a Directed Acyclic Graph (DAG) structure, which limited certain use cases. By removing this restriction, we now support cyclic graphs, enabling more flexible agent workflows such as:

  • "Loop until" patterns where agents can continue processing until a specific condition is met
  • Feedback loops where output from later stages can influence earlier stages
  • Recursive agent workflows where an agent can feed back into itself
  • Iterative refinement processes where results are continuously improved

The changes are minimal and focused on removing the cycle detection algorithm while maintaining all other validation checks.

Related Issues

Addresses customer feedback requesting support for cyclic agent graphs

Documentation PR

TODO

Type of Change

New feature

Testing

  • Verified that cyclic graphs can now be created without validation errors
  • Updated existing tests to confirm that cyclic graphs are properly supported
  • Ran full test suite with hatch test and hatch run test-integ to ensure no regressions
  • All tests pass with no new warnings or errors

Checklist

  • I have read the CONTRIBUTING document
  • I have added any necessary tests that prove my fix is effective or my feature works
  • I have updated the documentation accordingly
  • I have added an appropriate example to the documentation to outline the feature, or no new docs are needed
  • My changes generate no new warnings
  • Any dependent changes have been merged and published

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

@zastrowm zastrowm added the area-multiagent Multi-agent related label Jul 22, 2025
@mkmeral mkmeral enabled auto-merge (squash) July 30, 2025 13:07
@vria vria mentioned this pull request Jul 30, 2025
7 tasks
@vria
Copy link

vria commented Jul 30, 2025

Please concider #571

Co-authored-by: Nick Clegg <nac542@gmail.com>
def should_continue(
self,
max_node_executions: Optional[int],
execution_timeout: Optional[float],
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you think we should have a default timeout value?

@@ -213,8 +270,48 @@ def set_entry_point(self, node_id: str) -> "GraphBuilder":
self.entry_points.add(self.nodes[node_id])
return self

def reset_on_revisit(self, enabled: bool = True) -> "GraphBuilder":
Copy link
Contributor

@JackYPCOnline JackYPCOnline Aug 7, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: if the only purpose of this function is to True, then having a boolean parameter is unnecessary?

if any(colors[node_id] == WHITE and has_cycle_from(node_id) for node_id in self.nodes):
raise ValueError("Graph contains cycles - must be a directed acyclic graph")
# Warn about potential infinite loops if no execution limits are set
if self._max_node_executions is None and self._execution_timeout is None:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you think we could help users avoid infinite loops?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area-multiagent Multi-agent related
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants