engine.h File Reference

Main graph execution engine with super-step loop and HITL support. More...

#include <neograph/api.h>
#include <neograph/graph/admin.h>
#include <neograph/graph/cancel.h>
#include <neograph/graph/channel_key.h>
#include <neograph/graph/checkpoint.h>
#include <neograph/graph/compiler.h>
#include <neograph/graph/coordinator.h>
#include <neograph/graph/executor.h>
#include <neograph/graph/node.h>
#include <neograph/graph/node_cache.h>
#include <neograph/graph/provider_call_broker.h>
#include <neograph/tool_effect_broker.h>
#include <neograph/graph/registry.h>
#include <neograph/graph/run_context.h>
#include <neograph/graph/safe_point.h>
#include <neograph/graph/scheduler.h>
#include <neograph/graph/state.h>
#include <neograph/graph/store.h>
#include <neograph/graph/types.h>
#include <neograph/graph/validator.h>
#include <neograph/tool_dispatch.h>
#include <neograph/tool_set.h>
#include <neograph/provider.h>
#include <asio/awaitable.hpp>
#include <asio/thread_pool.hpp>
#include <atomic>
#include <chrono>
#include <cstddef>
#include <map>
#include <memory>
#include <optional>
#include <set>
#include <string>
#include <vector>

Include dependency graph for engine.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	neograph::graph::EngineConfig
	Construction-time configuration for a GraphEngine. More...
struct	neograph::graph::EngineResources
	Owned construction resources layered beside EngineConfig. More...
class	neograph::graph::GraphEngine
	Super-step loop execution engine for graph-based agent workflows. More...
class	neograph::graph::ManagedBudgetLeaseReleaseError
	Both execution evidence and the failed durable disposition remain visible. More...
class	neograph::graph::NodeRetryCeiling
	A run-level ceiling on node retries (#364). More...
struct	neograph::graph::RunConfig
	Configuration for a graph execution run. More...
struct	neograph::graph::RunMetadata
	Optional per-run metadata without changing the stable RunConfig ABI. More...
struct	neograph::graph::RunResources
	Optional persistence resources scoped to one run or resume call. More...
struct	neograph::graph::RunResult
	Result of a graph execution run. More...
struct	neograph::graph::SubgraphPathStep
	One edge in a nested checkpoint lookup. More...

Enumerations
enum class	neograph::graph::RunStatus { }
	Normal, paused, or step-limited outcome of a successful run call. More...

Detailed Description

Main graph execution engine with super-step loop and HITL support.

GraphEngine is the central orchestrator that compiles JSON graph definitions, executes them using the Pregel BSP (Bulk Synchronous Parallel) model, and provides checkpointing, state management, and Human-in-the-Loop APIs.

Definition in file engine.h.

Enumeration Type Documentation

RunStatus

enum class neograph::graph::RunStatus

strong

Normal, paused, or step-limited outcome of a successful run call.

Enumerator
BarrierStalled	Nothing was ready, end was never reached, and a barrier still held partial signals: the join can no longer fire (issue #357).
FailureExit	A failure-exit node completed (#364): the run ended as failed with the node's declared code, at output["_neograph"]["failure_exit"].

Definition at line 378 of file engine.h.