basemind 0.8.0

Full AI context layer over MCP — tree-sitter code-map, document RAG (PDF/Office/HTML/email + OCR + reranker), shared agent memory, on-demand web crawl, git history + blame + per-symbol diff. 300+ languages, 10+ coding-agent harnesses, content-addressed Fjall + LanceDB.
//! Token counting for compression reports (and, later, budgeting).
//!
//! Real HF-tokenizer counts (o200k / gpt-4o, via kreuzberg) when the `documents`
//! feature is enabled; a `bytes/4` heuristic otherwise. The real path downloads
//! the tokenizer from HF on first use and caches it, and falls back to a word
//! estimate offline — acceptable for the explicit `compress` op, NOT for any
//! per-call hot path.

/// Count the tokens in `text`.
#[cfg(feature = "documents")]
pub(crate) fn count_tokens(text: &str) -> u64 {
    kreuzberg::chunking::count_tokens(text, None) as u64
}

/// `bytes / 4` fallback when no tokenizer is compiled in.
#[cfg(not(feature = "documents"))]
pub(crate) fn count_tokens(text: &str) -> u64 {
    (text.len() as u64) / 4
}

/// `true` when [`count_tokens`] uses a real tokenizer (the `documents` feature),
/// `false` when it uses the `bytes/4` heuristic.
pub(crate) const TOKENS_ARE_COUNTED: bool = cfg!(feature = "documents");

#[cfg(test)]
mod tests {
    use super::*;

    /// Under the heuristic path (no `documents`), the count is exactly `bytes / 4`.
    #[cfg(not(feature = "documents"))]
    #[test]
    fn fallback_count_is_bytes_over_four() {
        let text = "a".repeat(400);
        assert_eq!(count_tokens(&text), 100);
        assert_eq!(count_tokens("aaaa"), 1);
        assert_eq!(count_tokens(""), 0);
    }

    /// `TOKENS_ARE_COUNTED` mirrors the `documents` feature. Read through a runtime
    /// binding so the comparison is not a compile-time constant (which clippy flags).
    #[test]
    fn tokens_are_counted_tracks_documents_feature() {
        let counted = TOKENS_ARE_COUNTED;
        assert_eq!(counted, cfg!(feature = "documents"));
    }
}