carryctx 0.3.0

Persistent project context for coding agents
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

use crate::adapter::sqlite_repos::SqliteEventRepository;
use crate::adapter::unit_of_work::UnitOfWork;
use crate::error::CarryCtxError;
use crate::repository::event::{EventFilter, EventRecord, EventRepository};

/// Result of listing events with cursor-based pagination
#[derive(serde::Serialize)]
pub struct CursorList {
    pub events: Vec<EventRecord>,
    pub next_cursor: Option<String>,
}

/// List events with cursor-based pagination.
///
/// The cursor is the `occurred_at` timestamp of the last event in the previous
/// page. Pass it as `until` in the filter to get the next page.
pub fn list_events(
    project_id: &str,
    filter: &EventFilter,
    cursor: Option<&str>,
    uow: &UnitOfWork,
) -> Result<CursorList, CarryCtxError> {
    let conn = uow.connection();
    let repo = SqliteEventRepository::new(conn);

    // Build an adjusted filter: if cursor is set, use it as the upper bound
    let adjusted_limit = filter.limit.map(|l| l + 1);
    let adjusted_filter = EventFilter {
        project_id: project_id.to_string(),
        task_id: filter.task_id.clone(),
        agent_id: filter.agent_id.clone(),
        session_id: filter.session_id.clone(),
        event_type: filter.event_type.clone(),
        since: filter.since.clone(),
        until: cursor
            .map(|c| c.to_string())
            .or_else(|| filter.until.clone()),
        limit: adjusted_limit,
    };

    let mut events = repo.list(&adjusted_filter)?;

    // Determine next cursor
    let next_cursor = if let Some(limit) = filter.limit {
        let limit = limit as usize;
        if events.len() > limit {
            // Truncate to limit; the (limit+1)th event tells us there's a next page
            events.truncate(limit);
            events.last().map(|e| e.occurred_at.clone())
        } else {
            None
        }
    } else {
        None
    };

    Ok(CursorList {
        events,
        next_cursor,
    })
}

/// Show a single event by ID
pub fn show_event(
    project_id: &str,
    event_id: &str,
    uow: &UnitOfWork,
) -> Result<EventRecord, CarryCtxError> {
    let conn = uow.connection();
    let repo = SqliteEventRepository::new(conn);

    let event = repo.find_by_id(project_id, event_id)?;
    event.ok_or_else(|| CarryCtxError::resource_not_found(format!("Event '{event_id}' not found.")))
}