Publish harness and TUI open-source

initial sync from the monorepo

crates/codegen/xai-grok-pager/src/client_identity.rs

@@ -0,0 +1,39 @@
+pub const PAGER_CLIENT_TYPE: &str = "grok-pager";
+pub const HEADLESS_CLIENT_TYPE: &str = "grok-shell";
+
+pub const PAGER_CLIENT_VERSION: &str = xai_grok_version::VERSION;
+
+/// `User-Agent` for pager-owned direct-to-`api.x.ai` clients (voice STT).
+///
+/// Matches the sampler's `grok-shell/<version> (os; arch)` shape so server-side
+/// dashboards bucket voice traffic alongside chat / imagine requests.
+pub fn client_user_agent() -> String {
+    format!(
+        "{}/{} ({}; {})",
+        HEADLESS_CLIENT_TYPE,
+        PAGER_CLIENT_VERSION,
+        std::env::consts::OS,
+        std::env::consts::ARCH,
+    )
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn client_user_agent_has_expected_shape() {
+        // e.g. "grok-shell/1.2.3 (macos; aarch64)". The pieces are wire
+        // contract for server-side UA parsing, so pin the exact shape.
+        let ua = client_user_agent();
+        assert_eq!(
+            ua,
+            format!(
+                "grok-shell/{} ({}; {})",
+                PAGER_CLIENT_VERSION,
+                std::env::consts::OS,
+                std::env::consts::ARCH
+            )
+        );
+    }
+}