feat!: consolidate graph metric summary into LDAIGraphMetricSummary

[jsonbailey]

Summary

JS already had two duplicate graph-metric-summary interfaces:

• LDAIGraphMetricSummary (tracker-layer) — used by LDGraphTracker.getSummary(). All fields optional. Missing nodeMetrics.
• AIGraphMetricSummary (managed-layer, introduced in feat: add ManagedGraphResult, GraphMetricSummary, and ManagedAgentGraph #1335) — used by ManagedGraphResult.metrics / ManagedAgentGraph. Required success/path/nodeMetrics. Includes nodeMetrics.

Both describe the same spec concept (AIGraphMetricSummary in AIRUNNER §2.5). This PR consolidates them into the single LDAIGraphMetricSummary (JS LD-prefix convention used by all sibling types like LDAIMetrics, LDAIMetricSummary, LDAIGraphMetrics) and adds the missing nodeMetrics field.

Required vs. optional fields

The consolidated type's optionality matches the actual runtime contract — preserving the type precision the old AIGraphMetricSummary provided:

• Required: success, path, nodeMetrics. The managed layer sources these from LDAIGraphMetrics where they are required, so consumers of ManagedGraphResult.metrics can rely on them being present.
• Optional: durationMs, tokens, resumptionToken. Genuinely may not be tracked depending on runner.

For the tracker's incremental view, LDGraphTracker.getSummary() now returns Partial<LDAIGraphMetricSummary> to express that fields populate as tracking calls arrive. LDGraphTrackerImpl._summary is similarly typed.

Coordination

This is one of three coordinated PRs renaming/aligning the graph metric summary types:

• Spec PR: launchdarkly/sdk-specs#162 (draft, base main) — canonical spec rename to AIGraphMetricSummary.
• Python PR: feat!: rename GraphMetrics/GraphMetricSummary to AIGraphMetrics/AIGraphMetricSummary python-server-sdk-ai#173 (draft, base main) — adopts AIGraphMetricSummary (Python doesn't use the LD prefix).
• This PR: js-core (draft, base feat/next-ai-release) — JS keeps the LD prefix and consolidates the duplicate.

Files changed

• packages/sdk/server-ai/src/api/graph/types.ts — added nodeMetrics to LDAIGraphMetricSummary; tightened success/path/nodeMetrics to required; removed the duplicate AIGraphMetricSummary interface; updated ManagedGraphResult.metrics to LDAIGraphMetricSummary.
• packages/sdk/server-ai/src/api/graph/LDGraphTracker.ts — getSummary() returns Partial<LDAIGraphMetricSummary>.
• packages/sdk/server-ai/src/LDGraphTrackerImpl.ts — _summary field and getSummary() return are Partial<LDAIGraphMetricSummary>.
• packages/sdk/server-ai/src/api/graph/ManagedAgentGraph.ts — switched to LDAIGraphMetricSummary.

Breaking changes

• AIGraphMetricSummary is removed. Consumers should import LDAIGraphMetricSummary from @launchdarkly/server-sdk-ai.
• LDAIGraphMetricSummary.success, path, and nodeMetrics are now required (previously optional). Consumers of ManagedGraphResult.metrics benefit; consumers who built LDAIGraphMetricSummary literals from the tracker should switch to Partial<LDAIGraphMetricSummary>.
• LDGraphTracker.getSummary() now returns Partial<LDAIGraphMetricSummary> instead of LDAIGraphMetricSummary to reflect the incremental population. Consumers reading getSummary().success etc. were already getting boolean | undefined at runtime; the change just makes the type honest.

Test plan

• yarn workspaces foreach -pR --topological-dev --from '@launchdarkly/server-sdk-ai' run build passes
• yarn workspace @launchdarkly/server-sdk-ai test passes (230/230)
• yarn workspace @launchdarkly/server-sdk-ai lint clean
• Reviewer confirms naming choice (LD-prefix consolidation vs spec's bare AIGraphMetricSummary)

[github-actions]

@launchdarkly/js-sdk-common size report
This is the brotli compressed size of the ESM build.
Compressed size: 26281 bytes
Compressed size limit: 29000
Uncompressed size: 128971 bytes

[github-actions]

@launchdarkly/js-client-sdk size report
This is the brotli compressed size of the ESM build.
Compressed size: 31867 bytes
Compressed size limit: 34000
Uncompressed size: 113634 bytes

[github-actions]

@launchdarkly/browser size report
This is the brotli compressed size of the ESM build.
Compressed size: 179543 bytes
Compressed size limit: 200000
Uncompressed size: 830815 bytes

[github-actions]

@launchdarkly/js-client-sdk-common size report
This is the brotli compressed size of the ESM build.
Compressed size: 38473 bytes
Compressed size limit: 39000
Uncompressed size: 211104 bytes

[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 d645b30. Configure here.}