notebooklm 4.6.0

//! An async Rust client for a local Gemini Notebook (NotebookLM) server.
//!
//! Google ships no public API for the consumer product, and the part that
//! cannot live in a crate is the Google session: the login is bound to the
//! machine it was made on, the session expires server-side while local cookies
//! still look valid, and the browser driving it has to stay patched against
//! detection. So this crate does not own a browser. It talks to a process that
//! does — `npx -y @roomi-fields/notebooklm-mcp`, listening on loopback — and
//! gives you its API with types instead of `serde_json::Value`.
//!
//! ```no_run
//! use notebooklm::{AskRequest, Client};
//!
//! # async fn run() -> notebooklm::Result<()> {
//! let client = Client::new("http://127.0.0.1:3000")?;
//!
//! let health = client.health().await?;
//! if !health.authenticated {
//!     // One setup command, once per machine.
//!     return Ok(());
//! }
//!
//! let library = client.library().await?;
//! let notebook = &library.notebooks[0];
//!
//! let answer = client
//!     .ask(&AskRequest::new(&notebook.id, "What is this notebook about?"))
//!     .await?;
//! println!("{}", answer.answer);
//! for citation in answer.citations() {
//!     println!("  [{}] {}", citation.number, citation.source_text);
//! }
//! # Ok(())
//! # }
//! ```
//!
//! # Retrieval costs nothing
//!
//! [`Client::search_passages`] returns the indexed passages matching a query
//! without generating anything, so it spends no generation allowance. When you
//! mean to reason over the evidence yourself, ask for the evidence.
//!
//! # Everything else
//!
//! This crate covers reading and asking. The server exposes 56 operations in
//! all, and [`Client::manual`] returns the UTCP manual describing every one of
//! them — which a [UTCP](https://www.utcp.io/) client can call natively,
//! without any of the types here.
//!
//! # Features
//!
//! - `rustls` (default) / `native-tls` — which TLS stack to use.
//! - `blocking` — a synchronous façade, for programs with no async runtime.

#![forbid(unsafe_code)]
#![warn(missing_docs, clippy::pedantic)]
// `doc_markdown` wants product names in backticks. NotebookLM and Gemini
// Notebook are prose, not identifiers, and this documentation is meant to be
// read by people searching for those words.
#![allow(
    clippy::must_use_candidate,
    clippy::missing_errors_doc,
    clippy::doc_markdown
)]

mod client;
mod error;
mod types;

#[cfg(feature = "blocking")]
pub mod blocking;

pub use client::{Client, ClientBuilder};
pub use error::{Error, Result};
pub use types::{
    Answer, AskRequest, CallTemplate, Citation, Health, Library, Manual, Notebook, Passage,
    PassageSearch, SearchRequest, SourceFormat, SourceList, SourceSummary, SourceText, Sources,
    Tool,
};

impl Answer {
    /// The quotations behind this answer, or nothing when the question did not
    /// ask for them. Saves callers an `Option` and a `Vec` dance.
    pub fn citations(&self) -> impl Iterator<Item = &Citation> {
        self.sources.iter().flat_map(|s| s.citations.iter())
    }
}