1use std::sync::Arc;
10
11use rig_core::completion::Document;
12use rig_core::message::{Message, ToolChoice};
13use serde::{Deserialize, Serialize};
14
15#[derive(Debug, Clone, Default, PartialEq, Serialize, Deserialize)]
30pub struct RequestPatch {
31 pub preamble: Option<String>,
33 pub temperature: Option<f64>,
35 pub max_tokens: Option<u64>,
37 pub tool_choice: Option<ToolChoice>,
39 pub active_tools: Option<Vec<String>>,
41 pub additional_params: Option<serde_json::Value>,
43 pub extra_context: Vec<Document>,
45 pub history: Option<Vec<Arc<Message>>>,
47}
48
49fn merge_last_wins<T>(earlier: Option<T>, later: Option<T>, field: &str) -> Option<T> {
50 match (earlier, later) {
51 (Some(_), Some(later)) => {
52 tracing::warn!(
53 patch_field = field,
54 "two hooks set the same request field; later wins"
55 );
56 Some(later)
57 }
58 (earlier, later) => later.or(earlier),
59 }
60}
61
62pub(crate) fn overlay_params(
65 base: Option<serde_json::Value>,
66 later: Option<serde_json::Value>,
67) -> Option<serde_json::Value> {
68 match (base, later) {
69 (Some(base), Some(later)) if base.is_object() && later.is_object() => {
70 Some(rig_core::json_utils::merge(base, later))
71 }
72 (base, later) => later.or(base),
73 }
74}
75
76impl RequestPatch {
77 pub fn new() -> Self {
79 Self::default()
80 }
81
82 pub fn preamble(mut self, value: impl Into<String>) -> Self {
84 self.preamble = Some(value.into());
85 self
86 }
87
88 pub fn temperature(mut self, value: f64) -> Self {
90 self.temperature = Some(value);
91 self
92 }
93
94 pub fn max_tokens(mut self, value: u64) -> Self {
96 self.max_tokens = Some(value);
97 self
98 }
99
100 pub fn tool_choice(mut self, value: ToolChoice) -> Self {
102 self.tool_choice = Some(value);
103 self
104 }
105
106 pub fn active_tools<I, S>(mut self, values: I) -> Self
108 where
109 I: IntoIterator<Item = S>,
110 S: Into<String>,
111 {
112 self.active_tools = Some(values.into_iter().map(Into::into).collect());
113 self
114 }
115
116 pub fn additional_params(mut self, value: serde_json::Value) -> Self {
121 self.additional_params = Some(value);
122 self
123 }
124
125 pub fn extra_context<I>(mut self, values: I) -> Self
127 where
128 I: IntoIterator<Item = Document>,
129 {
130 self.extra_context.extend(values);
131 self
132 }
133
134 pub fn context(mut self, value: Document) -> Self {
136 self.extra_context.push(value);
137 self
138 }
139
140 pub fn history<I>(mut self, values: I) -> Self
142 where
143 I: IntoIterator<Item: Into<Arc<Message>>>,
144 {
145 self.history = Some(values.into_iter().map(Into::into).collect());
146 self
147 }
148
149 pub fn is_empty(&self) -> bool {
151 *self == Self::default()
152 }
153
154 pub fn merge(mut self, later: Self) -> Self {
159 self.extra_context.extend(later.extra_context);
160 self.additional_params =
161 overlay_params(self.additional_params.take(), later.additional_params);
162 self.preamble = merge_last_wins(self.preamble, later.preamble, "preamble");
163 self.temperature = merge_last_wins(self.temperature, later.temperature, "temperature");
164 self.max_tokens = merge_last_wins(self.max_tokens, later.max_tokens, "max_tokens");
165 self.tool_choice = merge_last_wins(self.tool_choice, later.tool_choice, "tool_choice");
166 self.history = merge_last_wins(self.history, later.history, "history");
167 self.active_tools = match (self.active_tools.take(), later.active_tools) {
168 (Some(earlier), Some(later)) => {
169 let later: std::collections::BTreeSet<_> = later.iter().collect();
170 Some(
171 earlier
172 .into_iter()
173 .filter(|name| later.contains(name))
174 .collect(),
175 )
176 }
177 (earlier, later) => earlier.or(later),
178 };
179 self
180 }
181}
182
183#[cfg(test)]
184mod tests;