Skip to main content

agentstategraph_tasks/
lib.rs

1//! Shared task-store primitives for AgentStateGraph consumers.
2//!
3//! This crate establishes the pattern for how AgentStateGraph handles
4//! opinionated-but-shared primitives: they live in sibling crates under
5//! `crates/agentstategraph-<name>`, built on top of the primitive
6//! Repository API. Consumers that don't need tasks don't depend on this
7//! crate; the core stays minimal.
8//!
9//! # Example
10//!
11//! ```rust,no_run
12//! use agentstategraph::Repository;
13//! use agentstategraph_storage::SqliteStorage;
14//! use agentstategraph_tasks::{Priority, Proof, TaskStore};
15//! use std::sync::Arc;
16//!
17//! let repo = Arc::new(Repository::new(Box::new(SqliteStorage::in_memory().expect("in-memory sqlite"))));
18//! repo.init().unwrap();
19//!
20//! let store = TaskStore::new(repo, "/plans", "claude-code");
21//!
22//! store
23//!     .create_plan("main", "website-v2", Some("Brand pivot".into()))
24//!     .unwrap();
25//! let task = store
26//!     .add_task(
27//!         "main",
28//!         "website-v2",
29//!         "Rewrite hero",
30//!         Priority::High,
31//!         None,
32//!         vec![],
33//!         None,
34//!     )
35//!     .unwrap();
36//! store.start_task("main", "website-v2", &task.id).unwrap();
37//! store
38//!     .complete_task(
39//!         "main",
40//!         "website-v2",
41//!         &task.id,
42//!         Proof::commit("abc123"),
43//!     )
44//!     .unwrap();
45//! ```
46
47pub mod error;
48pub mod paths;
49pub mod renumber;
50pub mod state;
51pub mod store;
52pub mod types;
53pub mod verifier;
54
55pub use error::TaskStoreError;
56pub use renumber::Renumbering;
57pub use state::Transition;
58pub use store::{AddTaskOptions, TaskStore};
59pub use types::{
60    MAX_NOTES_BYTES, OnCompleteHook, Plan, PlanStatus, Priority, Proof, ProofKind, Task, TaskId,
61    TaskStatus,
62};
63pub use verifier::{NoopVerifier, Verifier, VerifyEntry, VerifyReport, VerifyResult};