docs: add missing #[must_use], # Errors, # Panics across public api

hive-ag3nt/src/client.rs

@@ -19,6 +19,11 @@ const RETRY_BACKOFFS_MS: &[u64] = &[2_000, 4_000, 8_000, 16_000, 30_000];
 /// the retry count. Use this from non-tool callers (the harness serve
 /// loop, web UI, CLI subcommands) where we just want the socket-restart
 /// resilience without surfacing the bookkeeping.
+///
+/// # Errors
+///
+/// Returns an error if the socket is unreachable after all retries, or if
+/// serialization / deserialization of the request or response fails.
 pub async fn request<Req, Resp>(socket: &Path, req: &Req) -> Result<Resp>
 where
     Req: Serialize + ?Sized,
@@ -33,6 +38,16 @@ where
 /// retries happened — that way claude knows the prior socket flake
 /// wasn't a content error and shouldn't trigger an LLM-level retry of
 /// its own.
+///
+/// # Errors
+///
+/// Returns an error if all retries are exhausted, or on a fatal protocol
+/// error (serialization / deserialization failure).
+///
+/// # Panics
+///
+/// Panics if `RETRY_BACKOFFS_MS.len()` does not fit in a `u32`, which
+/// cannot happen with the current compile-time constant.
 pub async fn request_retried<Req, Resp>(socket: &Path, req: &Req) -> Result<(Resp, u32)>
 where
     Req: Serialize + ?Sized,