asepharyana
da2ed6da25
feat(tui): implement status bar with connection and turn state indicators feat(tui): create workflow panel for agent status and progress visualization feat(web): introduce web frontend interface with static file serving feat(ws): add WebSocket interface for real-time communication and session management
58 lines
2.3 KiB
Rust
58 lines
2.3 KiB
Rust
//! Repository trait definitions (pure — no impls, no concrete persistence).
|
|
//!
|
|
//! Defines the repository contracts that infrastructure adapters implement.
|
|
//! Following clean architecture, domain code depends only on these traits,
|
|
//! not on concrete persistence libraries.
|
|
//!
|
|
//! # Traits
|
|
//!
|
|
//! - [`SessionRepository`] — CRUD for session metadata
|
|
//! - [`SessionLockRepository`] — acquire/release/liveness for session locks
|
|
//! - [`OAuthRepository`] — persist/load OAuth tokens
|
|
|
|
use std::path::Path;
|
|
|
|
use crate::auth::error::RepositoryError;
|
|
use crate::auth::oauth::OAuthToken;
|
|
use crate::auth::session::Session;
|
|
use crate::auth::session_id::SessionId;
|
|
|
|
/// Repository for loading, saving, listing, and deleting sessions.
|
|
pub trait SessionRepository {
|
|
/// List all loadable sessions under `<base_dir>/sessions/`.
|
|
fn list_sessions(&self, base_dir: &Path) -> Result<Vec<Session>, RepositoryError>;
|
|
|
|
/// Load a single session by id.
|
|
fn load_session(&self, base_dir: &Path, id: &SessionId) -> Result<Session, RepositoryError>;
|
|
|
|
/// Save a session's metadata to disk.
|
|
fn save_session(&self, base_dir: &Path, session: &Session) -> Result<(), RepositoryError>;
|
|
|
|
/// Delete a session directory and all its contents.
|
|
fn delete_session(&self, base_dir: &Path, id: &SessionId) -> Result<(), RepositoryError>;
|
|
}
|
|
|
|
/// Repository for per-session PID-file advisory locks.
|
|
pub trait SessionLockRepository {
|
|
/// Try to acquire the lock for a session directory.
|
|
/// Returns `true` if the lock was acquired, `false` if another live
|
|
/// process holds it.
|
|
fn try_lock(&self, session_dir: &Path) -> Result<bool, RepositoryError>;
|
|
|
|
/// Release the lock by removing the lock file.
|
|
fn unlock(&self, session_dir: &Path) -> Result<(), RepositoryError>;
|
|
|
|
/// Check whether a process with the given PID is alive.
|
|
fn is_alive(&self, pid: u32) -> bool;
|
|
}
|
|
|
|
/// Repository for persisting and loading OAuth tokens.
|
|
pub trait OAuthRepository {
|
|
/// Persist an OAuth token to a JSON file.
|
|
fn save_token(&self, path: &Path, token: &OAuthToken) -> Result<(), RepositoryError>;
|
|
|
|
/// Load an OAuth token from a JSON file, returning `None` if the file
|
|
/// does not exist.
|
|
fn load_token(&self, path: &Path) -> Result<Option<OAuthToken>, RepositoryError>;
|
|
}
|