Graph State Management

This page previously covered the graph-admin lifecycle (revision management, config-as-code, snapshot import/export, promotion, rollback). Those features have been removed to keep yggdrasil focused on its core thesis as a graph-native agent runtime.

What Still Exists

Checkpoints — the executor can persist and restore ExecutionContext:

checkpoint = await executor.checkpoint_context(ctx)
restored   = await executor.load_checkpoint(checkpoint.node_id)
resumed    = await executor.resume_from_checkpoint(
    checkpoint.node_id, entry.node_id, query="Continue."
)

Workflow state versioningAgentNode.graph_version provides a semantic compatibility label for in-flight workflow state. Bump it when a graph change is incompatible with previously checkpointed state.

Runtime node cleanup — session-scoped context nodes created during execution can be enumerated and removed:

from yggdrasil import get_runtime_nodes, cleanup_session

nodes = await get_runtime_nodes(store, ctx.session_id)
await cleanup_session(store, ctx.session_id)

Copyright © 2026 Hoang Dao. MIT License.

This site uses Just the Docs, a documentation theme for Jekyll.