SessionReport.h File

Structured pipeline diagnostics and reproduction helpers. More...

Included Headers

#include <cstdint> #include <string> #include <vector>

Namespaces Index

namespace	simaai
namespace	neat

Classes Index

struct	BusMessage
struct	BoundaryFlowStats
struct	NodeReport
struct	BuildAdaptationAction
struct	BuildAdaptationSummary
struct	SessionReport

Description

Structured pipeline diagnostics and reproduction helpers.

File Listing

The file content with the documentation metadata removed is:

1

6#pragma once

7

8#include <cstdint>

9#include <string>

10#include <vector>

11

12namespace simaai::neat {

13

14struct BusMessage {

15 std::string type; // e.g. "ERROR", "WARNING", "STATE_CHANGED"

16 std::string src; // element/object name

17 std::string detail; // formatted message (incl debug if present)

18 int64_t wall_time_us = 0; // monotonic

19};

20

21struct BoundaryFlowStats {

22 std::string boundary_name; // sima_b<N>

23 int after_node_index = -1; // upstream node index

24 int before_node_index = -1; // downstream node index (may be -1 for terminal tap boundary)

25

26 uint64_t in_buffers = 0; // observed on identity:sink

27 uint64_t out_buffers = 0; // observed on identity:src

28

29 int64_t last_in_pts_ns = -1;

30 int64_t last_out_pts_ns = -1;

31

32 int64_t last_in_wall_us = 0;

33 int64_t last_out_wall_us = 0;

34};

35

36struct NodeReport {

37 int index = -1;

38 std::string kind; // "FileInput", "H264Decode", ...

39 std::string user_label; // optional user-supplied label

40 std::string backend_fragment; // fragment with names

41 std::vector<std::string> elements; // element names owned by this node

42};

43

44struct BuildAdaptationAction {

45 std::string target; // e.g. "input_constraints", "appsrc_caps_seed"

46 bool applied = false;

47 std::string detail;

48 std::string reason; // populated when applied == false

49};

50

51struct BuildAdaptationSummary {

52 std::string shape_policy;

53 std::string dynamic_capability;

54

55 int seed_width = -1;

56 int seed_height = -1;

57 int seed_depth = -1;

58 std::string seed_width_origin;

59 std::string seed_height_origin;

60 std::string seed_depth_origin;

61

62 int max_width = -1;

63 int max_height = -1;

64 int max_depth = -1;

65 std::string max_width_origin;

66 std::string max_height_origin;

67 std::string max_depth_origin;

68

69 std::size_t max_input_bytes_guard = 0;

70 std::string byte_guard_origin;

71 bool allow_ingress_cvu_format_renegotiation = false;

72

73 std::vector<BuildAdaptationAction> actions;

74};

75

76struct SessionReport {

77 std::string pipeline_string;

78 // Canonical machine-triage code. Prefer values from pipeline/ErrorCodes.h.

79 // Empty when operation succeeds or only informational diagnostics are returned.

80 std::string error_code;

81

82 std::vector<NodeReport> nodes;

83 std::vector<BusMessage> bus;

84 std::vector<BoundaryFlowStats> boundaries;

85

86 // Heavy-on-failure add-ons

87 std::string caps_dump;

88 std::vector<std::string> dot_paths;

89

90 // Repro helpers

91 std::string repro_gst_launch; // gst-launch-1.0 -v '...'

92 std::string repro_env; // env vars suggestion (GST_DEBUG, DOT dir)

93 std::string repro_note; // human summary + hint

94

95 // Input-build adaptation snapshot (present for build(input) flows).

96 bool has_build_adaptation = false;

97 BuildAdaptationSummary build_adaptation;

98

99 // Optional: JSON serialization for CI / support bundling

100 std::string to_json() const;

101};

102

103} // namespace simaai::neat

---

Generated via doxygen2docusaurus 2.0.0 by Doxygen 1.9.1.