tail-fin-core 0.7.7

Public session-lifecycle abstractions for tail-fin: Site trait, SessionManager, Credentials, SessionStatus, auth errors. The stable API surface that downstream agents (Flock A2A etc.) consume.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

//! Public session-lifecycle abstractions for tail-fin.
//!
//! This crate defines the stable API surface that downstream consumers
//! (Flock A2A agents, external platforms) import. Site adapter implementations
//! (`tail-fin-twitter`, `tail-fin-sa`, …) consume these types.
//!
//! Internal utilities (cookies parsing, CDP helpers, HTML scraping) live in
//! `tail-fin-common` — they are not part of the stable API.
//!
//! The `browser` feature (default on) gates the BrowserSession-typed surface
//! (`Site::validate`, `Site::refresh`, `Site::attempt_login`, the
//! `session::SessionManager` module, the `pub use BrowserSession` re-export,
//! and the `From<NightFuryError>` impl on `SiteError`). HTTP-only consumers
//! that don't need `BrowserSession` can disable the feature.
//!
//! See `docs/superpowers/plans/2026-04-17-site-trait-phase-1.md` for the
//! architectural rationale.

pub mod error;
#[cfg(feature = "browser")]
pub mod session;
pub mod site;

pub use error::{AuthFailureKind, SiteError};
#[cfg(feature = "browser")]
pub use session::SessionManager;
pub use site::{Credentials, FailureIndicators, SessionStatus, Site};

// Re-export the type Site implementations depend on. Gated because
// `night-fury-core` is itself optional.
#[cfg(feature = "browser")]
pub use night_fury_core::BrowserSession;