Continuum C++ API
Unified runtime for token + tensor execution
Loading...
Searching...
No Matches
observer.hpp
Go to the documentation of this file.
1#pragma once
2
3#include <cstdint>
4#include <string>
5
6namespace continuum::runtime {
7
9enum class ReuseEventKind : std::uint8_t {
12};
13
16struct ReuseEvent {
19 std::string tier;
20 std::string node_name;
22 std::string node_kind;
23 std::string backend;
24 std::string model_id;
25 std::string cache_namespace;
27 bool hit = false;
29 std::string served_by;
31 float similarity = 0.0f;
33 std::int32_t match_len = 0;
34 std::int32_t total_tokens = 0;
35 std::int32_t tokens_saved = 0;
36 std::int32_t tokens_sent = 0;
37 std::int32_t reused_prefix_len = 0;
38 std::int32_t compute_steps = 0;
39 bool used_cached_state = false;
40 std::int64_t start_unix_ns = 0;
41 std::int64_t end_unix_ns = 0;
42};
43
48 public:
49 virtual ~ReuseObserver() = default;
50 virtual void on_event(const ReuseEvent& event) = 0;
51};
52
53} // namespace continuum::runtime
Definition observer.hpp:47
virtual void on_event(const ReuseEvent &event)=0
Definition checkpoint.hpp:12
ReuseEventKind
What a ReuseEvent describes.
Definition observer.hpp:9
@ NodeExecution
One executed node, whatever served it.
@ TierLookup
One reuse-tier lookup for a TokenOp.
Definition observer.hpp:16
std::int32_t total_tokens
Definition observer.hpp:34
float similarity
Semantic: best similarity. Memory graph: top recalled similarity.
Definition observer.hpp:31
std::string served_by
NodeExecution: "memo", "semantic", "backend", or "passthrough".
Definition observer.hpp:29
bool hit
TierLookup: the tier matched (for memory_graph: recalled >= 1 node).
Definition observer.hpp:27
ReuseEventKind kind
Definition observer.hpp:17
std::int32_t tokens_sent
Definition observer.hpp:36
std::int32_t compute_steps
Definition observer.hpp:38
std::int64_t start_unix_ns
Definition observer.hpp:40
std::string node_name
Definition observer.hpp:20
std::string model_id
Definition observer.hpp:24
std::int32_t reused_prefix_len
Definition observer.hpp:37
bool used_cached_state
Definition observer.hpp:39
std::int64_t end_unix_ns
Definition observer.hpp:41
std::string backend
Definition observer.hpp:23
std::int32_t match_len
Prefix / layer KV: matched prefix length. Memory graph: nodes recalled.
Definition observer.hpp:33
std::string tier
TierLookup: "memo", "semantic", "prefix_kv", "layer_kv", "memory_graph".
Definition observer.hpp:19
std::string cache_namespace
Definition observer.hpp:25
std::int32_t tokens_saved
Definition observer.hpp:35
std::string node_kind
"TokenOp", "TensorOp", "PromptOp", "ToolOp", "ControlOp".
Definition observer.hpp:22