---
title: "Graph integration"
description: "Run a conversation inside an application-defined durable graph."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.cortavyn.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Graph integration

`ChatAgentNode` bridges Chat into `cortavyn-graph`. The node creates a run-scoped `ChatSession` from `NodeRuntime`, making the graph run ID available when constructing `ToolRuntime`.

Use `GraphToolProgressWriter` to emit tool progress as graph custom events. The graph remains independent from Chat: applications choose state channels, checkpoint storage, routing, and their own observability pipeline.

If the model must also manipulate a workspace and wait for approvals, use [Deep Agent](/deep-agent/overview).

Source: https://docs.cortavyn.org/chat/graph-integration/index.mdx