Add @osd/apm-topology package for APM service map, trace map and GenAI agent trace visualization

[ps48]

Description

• Introduces the @osd/apm-topology package — a React component library for rendering interactive APM service topology maps and GenAI agent trace visualizations
• Built on ReactFlow (@xyflow/react) with automatic Dagre-based hierarchical layout, the library provides 4 node types (CelestialNode, ServiceCardNode, ServiceCircleNode, AgentCardNode), styled edges with flow/pulse animations, health donuts, breadcrumb navigation, minimap, legend, and dark mode support
• Ships 7 GenAI agent node kinds (Agent, LLM, Tool, Retrieval, Embeddings, Content, Other) with provider icon resolution for OpenAI, Anthropic, AWS Bedrock, Azure, Google Vertex AI, Cohere, Mistral, and Meta
• Includes an example plugin (apm_topology_example) demonstrating all node types, edge styles, layout directions, and interactive features
• Comprehensive README with live screenshots, full API reference, architecture diagrams, usage patterns, and an AI agent reference section

Issues Resolved

#9898

Screenshot

apm-topology.mov

Testing the changes

• yarn start --run-examples → navigate to APM Topology Example app → verify all 4 tabs render correctly (APM Cards, APM Circles, Agent Cards, Features)
• Verify node click, edge click, hover glow, and selection glow interactions
• Toggle minimap, SLI/SLO, layout direction (LR/TB), and legend on/off
• Verify dark mode rendering by switching OSD theme

Changelog

• feat: Add @osd/apm-topology package for APM service map, trace map and GenAI agent trace visualization

Check List

• All tests pass
  • yarn test:jest
  • yarn test:jest_integration
• New functionality includes testing.
• New functionality has been documented.
• Update CHANGELOG.md
• Commits are signed per the DCO using --signoff

[github-actions]

PR Code Analyzer ❗

AI-powered 'Code-Diff-Analyzer' found issues on commit 332053e.

'Diff too large, requires skip by maintainers after manual review'

---

Pull Requests Author(s): Please update your Pull Request according to the report above.

Repository Maintainer(s): You can bypass diff analyzer by adding label skip-diff-analyzer after reviewing the changes carefully, then re-run failed actions. To re-enable the analyzer, remove the label, then re-run all actions.

---

⚠️ Note: The Code-Diff-Analyzer helps protect against potentially harmful code patterns. Please ensure you have thoroughly reviewed the changes beforehand.

Thanks.

[github-actions]

PR Code Analyzer ❗

AI-powered 'Code-Diff-Analyzer' found issues on commit 77e34eb.

'Diff too large, requires skip by maintainers after manual review'

---

Pull Requests Author(s): Please update your Pull Request according to the report above.

Repository Maintainer(s): You can bypass diff analyzer by adding label skip-diff-analyzer after reviewing the changes carefully, then re-run failed actions. To re-enable the analyzer, remove the label, then re-run all actions.

---

⚠️ Note: The Code-Diff-Analyzer helps protect against potentially harmful code patterns. Please ensure you have thoroughly reviewed the changes beforehand.

Thanks.