roder-protocol 0.1.2

Agentic software development tools and SDKs for Roder.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

//! `stats/*` protocol DTOs for local usage analytics (roadmap phase 73).
//!
//! Responses re-use the analytics crate's summary records, which exclude
//! prompt/assistant/tool-output bodies and secrets by construction.
//! Workspace labels arrive already transformed by the configured label
//! mode. All listing windows are bounded server-side.

use serde::{Deserialize, Serialize};

pub use roder_usage_analytics::{
    SessionSummary, StatsFilter, TokenSummaryRow, ToolSummary, UsageSummary,
};

#[derive(Debug, Clone, Default, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct StatsQueryParams {
    #[serde(default)]
    pub filter: StatsFilter,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct StatsSummaryResult {
    pub summary: UsageSummary,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct StatsToolsParams {
    #[serde(default)]
    pub filter: StatsFilter,
    /// `calls` (default), `p95`, `errors`, or `underused`.
    #[serde(default)]
    pub sort: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct StatsToolsResult {
    pub tools: Vec<ToolSummary>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct StatsTokensParams {
    #[serde(default)]
    pub filter: StatsFilter,
    /// `day` (default), `session`, `provider`, `model`, or `workspace`.
    #[serde(default)]
    pub group: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct StatsTokensResult {
    pub rows: Vec<TokenSummaryRow>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct StatsSessionsResult {
    pub sessions: Vec<SessionSummary>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct StatsBackfillParams {
    #[serde(default)]
    pub rebuild: bool,
    #[serde(default)]
    pub best_effort: bool,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct StatsBackfillResult {
    pub files_scanned: u64,
    pub lines_ingested: u64,
    pub lines_skipped_by_offset: u64,
    pub sessions_enriched: u64,
    pub parse_error_count: u64,
    pub rollup_rows: u64,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct StatsExportParams {
    /// Server-side output path; export never streams an unbounded payload
    /// through the JSON-RPC response.
    pub output_path: String,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct StatsExportResult {
    pub output_path: String,
    pub records: u64,
}