feat: Add ManagedGraphResult, GraphMetricSummary, and AgentGraphRunnerResult types

[jsonbailey]

Summary

Adds the managed-layer return type and metric summary for agent graph execution, mirroring the per-config types introduced in PR 8.

• GraphMetrics — runner-layer metrics (success, path, duration_ms, usage, node_metrics).
• GraphMetricSummary — managed-layer summary, analogous to LDAIMetricSummary (adds resumption_token).
• ManagedGraphResult — return type of ManagedAgentGraph.run() (content, metrics, raw, evaluations task).
• AgentGraphRunnerResult — pure runner-layer return type (no evaluations field).
• ManagedAgentGraph.run() now returns ManagedGraphResult and builds a GraphMetricSummary from the underlying runner's LDAIMetrics (path/node_metrics will be populated once graph runners migrate in PR 11).

Stack

PR 7 → PR 8 → PR 8-openai → PR 8-langchain → PR 9 (this) → PR 10 → PR 11 → PR 11-openai → PR 11-langchain → PR 12

Test plan

• make test — 261 tests pass (server-ai 140, langchain 81, openai 40)
• make lint — mypy clean

🤖 Generated with Claude Code

---

Note

Medium Risk
Introduces new public result/metrics types and changes ManagedAgentGraph.run() to return ManagedGraphResult (breaking callers expecting AgentGraphResult.output). Risk is mainly API/typing compatibility and downstream integrations relying on the old return shape.

Overview
Adds new agent-graph result/metrics dataclasses (GraphMetrics, GraphMetricSummary, ManagedGraphResult, AgentGraphRunnerResult) and exports them from ldai and ldai.providers.

Updates ManagedAgentGraph.run() to return a managed-layer ManagedGraphResult (with content + GraphMetricSummary) by wrapping the underlying runner’s AgentGraphResult, and adjusts tests to assert the new return type/field names.

^{Reviewed by Cursor Bugbot for commit af60d27. Bugbot is set up for automated code reviews on this repo. Configure here.}

[jsonbailey]

This will be added in a follow up PR #153

[jsonbailey]

@cursor review

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 1b47300. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 3928030. Configure here.}