feat: event-driven parity, Windows shell detection, dirty build timestamps, and gatekeeper integration

server/src/tools.rs

@@ -984,24 +984,43 @@ pub struct EnvironmentTool {
     pub requires_vpn: Option<bool>,
     /// Optional namespace.
     pub namespace: Option<String>,
+    /// Optional operating system name (e.g. 'windows', 'linux', 'darwin').
+    pub os: Option<String>,
+    /// Optional shell name (e.g. 'pwsh', 'bash', 'zsh', 'cmd').
+    pub shell: Option<String>,
 }
 
-#[derive(Debug, Deserialize, Serialize, JsonSchema, PartialEq)]
+#[derive(Debug, Clone, Copy, Deserialize, Serialize, JsonSchema, PartialEq)]
 #[serde(rename_all = "snake_case")]
 pub enum ClipboardAction {
+    #[serde(alias = "image", alias = "IMAGE", alias = "Image", alias = "screenshot", alias = "SCREENSHOT")]
+    Image,
+    #[serde(alias = "text", alias = "TEXT", alias = "Text")]
+    Text,
+    #[serde(alias = "history", alias = "HISTORY", alias = "History")]
+    History,
+    #[serde(alias = "clear", alias = "CLEAR", alias = "Clear")]
+    Clear,
     #[serde(alias = "read", alias = "READ", alias = "Read")]
     Read,
     #[serde(alias = "write", alias = "WRITE", alias = "Write")]
     Write,
 }
-/// OS Clipboard management (read, write).
+/// Smart OS Clipboard management with overwrite-immune screenshot caching and OCR.
 /// Actions:
-/// - 'read': Read current clipboard contents.
+/// - 'image': Get latest screenshot image path (Windows + WSL) and extracted verbatim OCR text.
+///   Returns cached screenshot even if text was copied afterwards!
+/// - 'text': Get latest clipboard text (or normalized Markdown if HTML was copied).
+/// - 'history': View recent clipboard history ring buffer (images and text with timestamps).
+/// - 'clear': Clear OS clipboard and memory cache.
+/// - 'read': Read current clipboard contents (legacy alias).
 /// - 'write': Write content to OS clipboard. Optional: text, html, files, image_path.
-/// Next steps on error: Provide text/html/files/image_path when calling 'write'.
+///
+/// Triggers: Call 'image' immediately when user says "look at image in clipboard", "see screenshot",
+/// "look at clipboard", "what I copied", or shares terminal error captures.
 #[derive(Debug, Deserialize, Serialize, JsonSchema)]
 pub struct ClipboardTool {
-    /// Action to perform: 'read' or 'write'.
+    /// Action to perform: 'image', 'text', 'history', 'clear', 'read', or 'write'.
     pub action: ClipboardAction,
     /// Plain text content (for 'write').
     pub text: Option<String>,