Skip to content

v0.3.1: Automatic LangGraph State Observability & Trace UI Overhaul

Latest
Latest

Choose a tag to compare

View all tags
@SGcpu SGcpu released this 23 Jul 19:04
· 1 commit to main since this release
v0.3.1
1e896ae

🚀 AeroGraph v0.3.1 - Release Notes

AeroGraph v0.3.1 brings major improvements to LangGraph state observability, cross-language adapter parity between Python and Node.js, and visual fixes for the web graph visualizer and trace inspector.

✨ What's New & Key Highlights

🧠 LangGraph State & Memory Tracking (Python & Node.js)

  • Automatic Node & State Extraction: The LangChain callback adapters (aerograph-langchain & @aerograph/adapter-langchain) now automatically detect LangGraph node boundaries using runtime metadata (langgraph_node, langgraph_step, langgraph_triggers, langgraph_path, checkpoint_ns).
  • Input & Output Capturing: Automatically records state_before (Inputs) on node entry and state_update (Outputs) upon completion.
  • Full Adapter Parity: Guaranteed identical state serialization and deduplication behavior across both Python and TypeScript runtimes.

🎨 Web Visualizer & Trace Inspector Overhaul (apps/web)

  • Unified State Views Panel: When inspecting a LangGraph node, the right sidebar now presents state_before (Inputs) and state_update (Outputs) side-by-side with toggleable Human Readable and JSON views.
  • Cleaned Canvas Topography: Resolved floating/disconnected chain_end nodes on the graph canvas while seamlessly aggregating their output payloads into the parent node inspector.
  • No Obscured Edge Labels: Increased Dagre vertical rank separation (ranksep: 120), ensuring trigger arrows and edge labels render clearly without hiding behind graph nodes.
  • Collapsible Sidebar Accordions: Grouped Lineage, Trace Analytics, and Loop Warnings into collapsible sections for a cleaner, navigation-friendly sidebar layout.
  • Tuned Loop Warnings: Improved the loop detection heuristic to require 3 consecutive pattern occurrences, filtering out false-positive warnings on standard agent loops (e.g. Agent -> Tool -> Agent).

🌉 OpenTelemetry & Contract Governance

  • Zero-Drift Interoperability: Ensured all rich LangGraph node payloads pass losslessly through OpenTelemetry bridges (@aerograph/otel and aerograph-otel) via OTLP aerograph.note.payload.
  • Full Contract Compliance: Strict alignment with @aerograph/contracts (Zod & Pydantic v2 schemas).

📦 Package Version Bumps

Package Version
aerograph-langchain (Python) 0.3.1
@aerograph/adapter-langchain (Node.js) 0.3.1
aerograph-otel (Python) 0.3.1
@aerograph/otel (Node.js) 0.3.1
apps/web (UI App) 0.3.1

🛠️ Upgrading

Node.js / NPM

npm install @aerograph/adapter-langchain@0.3.1 @aerograph/sdk@latest

Python

pip install --upgrade aerograph-langchain aerograph-sdk

Full Changelog: v0.3.0...v0.3.1

Assets 3
Loading