feat!: consolidate graph metric summary into LDAIGraphMetricSummary

The managed-layer `AIGraphMetricSummary` and the tracker-layer
`LDAIGraphMetricSummary` were duplicate interfaces describing the same
concept with slightly different fields. Consolidate to the existing
`LDAIGraphMetricSummary` (which follows the JS LD-prefix naming
convention for the spec's `AIGraphMetricSummary`) and add the missing
`nodeMetrics` field so it can carry the per-node summaries returned by
`ManagedAgentGraph.run()`.

`AIGraphMetricSummary` is removed; `ManagedGraphResult.metrics` and
`ManagedAgentGraph` now use `LDAIGraphMetricSummary`. All fields remain
optional so the tracker can populate them incrementally; the managed
layer fills them all in.

BREAKING CHANGE: `AIGraphMetricSummary` is removed. Consumers should
import `LDAIGraphMetricSummary` from `@launchdarkly/server-sdk-ai`
instead. Existing `LDAIGraphMetricSummary` consumers gain an optional
`nodeMetrics` field.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: jsonbailey

packages/sdk/server-ai/src/api/graph/ManagedAgentGraph.ts

@@ -5,15 +5,15 @@ import { LDAIMetricSummary } from '../model/types';
 import { LDJudgeResult } from '../judge/types';
 import { AgentGraphDefinition } from './AgentGraphDefinition';
 import { LDGraphTracker } from './LDGraphTracker';
-import { AgentGraphRunnerResult, GraphMetricSummary, ManagedGraphResult } from './types';
+import { AgentGraphRunnerResult, LDAIGraphMetricSummary, ManagedGraphResult } from './types';
 
 /**
  * ManagedAgentGraph wraps an AgentGraphDefinition and provides a managed run()
  * method that returns ManagedGraphResult with async judge evaluations.
  *
  * The runner function is responsible for executing the graph and returning
  * an AgentGraphRunnerResult. ManagedAgentGraph builds the managed result from
- * the runner result, including GraphMetricSummary with the graphTracker's
+ * the runner result, including LDAIGraphMetricSummary with the graphTracker's
  * resumptionToken.
  */
 export class ManagedAgentGraph {
@@ -31,7 +31,7 @@ export class ManagedAgentGraph {
    * run() returns before ManagedGraphResult.evaluations resolves.
    *
    * @param runner Async function that executes the graph and returns AgentGraphRunnerResult.
-   * @returns ManagedGraphResult with GraphMetricSummary and evaluations promise.
+   * @returns ManagedGraphResult with LDAIGraphMetricSummary and evaluations promise.
    */
   async run(
     runner: (
@@ -43,7 +43,7 @@ export class ManagedAgentGraph {
 
     const runnerResult = await runner(this._graphDefinition, graphTracker);
 
-    const metrics: GraphMetricSummary = {
+    const metrics: LDAIGraphMetricSummary = {
       success: runnerResult.metrics.success,
       path: runnerResult.metrics.path,
       durationMs: runnerResult.metrics.durationMs,

packages/sdk/server-ai/src/api/graph/types.ts

@@ -40,7 +40,10 @@ export interface LDAgentGraphFlagValue {
 }
 
 /**
- * Accumulated graph-level metrics collected by an LDGraphTracker.
+ * Summarized graph-level metrics for a graph invocation. Returned by both
+ * {@link LDGraphTracker.getSummary} (populated incrementally as tracking calls
+ * arrive) and {@link ManagedAgentGraph.run} via {@link ManagedGraphResult.metrics}
+ * (populated fully from the runner result).
  */
 export interface LDAIGraphMetricSummary {
   /**
@@ -63,6 +66,12 @@ export interface LDAIGraphMetricSummary {
    */
   path?: string[];
 
+  /**
+   * Per-node metric summaries keyed by agent config key. Populated by
+   * {@link ManagedAgentGraph.run}; absent on tracker-produced summaries.
+   */
+  nodeMetrics?: Record<string, LDAIMetricSummary>;
+
   /**
    * Resumption token for deferred feedback association.
    */
@@ -125,42 +134,6 @@ export interface AgentGraphRunnerResult {
 // Managed-Layer Graph Types
 // ============================================================================
 
-/**
- * Graph metric summary returned in ManagedGraphResult.
- * Includes per-node metrics and a resumption token.
- */
-export interface GraphMetricSummary {
-  /**
-   * Whether the graph invocation succeeded.
-   */
-  success: boolean;
-
-  /**
-   * Execution path through the graph as an ordered array of config keys.
-   */
-  path: string[];
-
-  /**
-   * Total graph execution duration in milliseconds, if tracked.
-   */
-  durationMs?: number;
-
-  /**
-   * Aggregate token usage across the entire graph invocation, if available.
-   */
-  tokens?: LDTokenUsage;
-
-  /**
-   * Per-node metric summaries keyed by agent config key.
-   */
-  nodeMetrics: Record<string, LDAIMetricSummary>;
-
-  /**
-   * Resumption token for deferred feedback association.
-   */
-  resumptionToken?: string;
-}
-
 /**
  * The result returned by a managed graph invocation (ManagedAgentGraph.run()).
  */
@@ -173,7 +146,7 @@ export interface ManagedGraphResult {
   /**
    * Summarized metrics for this graph invocation.
    */
-  metrics: GraphMetricSummary;
+  metrics: LDAIGraphMetricSummary;
 
   /**
    * The raw response object from the provider, if available.