docs: add doc comments to 106 public items

src/api.rs

@@ -93,6 +93,7 @@ const KAGI_LOGGED_OUT_MARKERS: [&str; 3] = [
 ];
 
 #[derive(Debug, Clone)]
+/// Filter parameters for the Kagi News API.
 pub struct NewsFilterRequest {
     pub preset_ids: Vec<String>,
     pub keywords: Vec<String>,
@@ -4085,6 +4086,7 @@ fn build_client() -> Result<Client, KagiError> {
 
 #[cfg(test)]
 #[derive(Debug, Deserialize, Serialize, PartialEq, Eq)]
+/// Generic wrapper for Kagi API responses containing a data payload.
 pub struct KagiEnvelope<T> {
     pub meta: ApiMeta,
     pub data: T,

src/auth.rs

@@ -19,6 +19,7 @@ pub const API_TOKEN_ENV: &str = "KAGI_API_TOKEN";
 pub const SESSION_TOKEN_ENV: &str = "KAGI_SESSION_TOKEN";
 
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
+/// The type of authentication credential.
 pub enum CredentialKind {
     ApiToken,
     SessionToken,
@@ -38,6 +39,7 @@ impl CredentialKind {
 }
 
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
+/// Where a credential was loaded from.
 pub enum CredentialSource {
     Env,
     Config,
@@ -57,6 +59,7 @@ impl CredentialSource {
 }
 
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
+/// Preferred authentication method for search operations.
 pub enum SearchAuthPreference {
     Session,
     Api,
@@ -86,6 +89,7 @@ impl SearchAuthPreference {
 }
 
 #[derive(Clone, PartialEq, Eq)]
+/// A resolved authentication credential with its kind and source.
 pub struct Credential {
     pub kind: CredentialKind,
     pub source: CredentialSource,
@@ -103,19 +107,22 @@ impl std::fmt::Debug for Credential {
 }
 
 #[derive(Debug, Clone)]
+/// Credentials resolved for a specific search request, with optional fallback.
 pub struct SearchCredentials {
     pub primary: Credential,
     pub fallback_session: Option<Credential>,
 }
 
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
+/// Authentication requirement level for different search types.
 pub enum SearchAuthRequirement {
     Base,
     Lens,
     Filtered,
 }
 
 #[derive(Debug, Clone)]
+/// All available credentials and preferences loaded from config and environment.
 pub struct CredentialInventory {
     pub api_token: Option<Credential>,
     pub session_token: Option<Credential>,
@@ -227,6 +234,7 @@ struct AuthConfig {
 }
 
 #[derive(Debug, Clone)]
+/// Snapshot of the current authentication configuration for display purposes.
 pub struct ConfigAuthSnapshot {
     pub config_path: PathBuf,
     pub api_token: Option<String>,