Expand description
agentstategraph-core — Core types and algorithms for AgentStateGraph.
This crate contains the foundational types with zero I/O dependencies:
- Objects (Atom, Node) with content-addressing via BLAKE3
- Commits with intent, authority, and provenance metadata
- Path addressing for navigating state trees
- Error types
All types are serializable and designed for both agent and human use.
Re-exports§
pub use commit::Commit;pub use commit::CommitBuilder;pub use diff::DiffOp;pub use diff::DiffValue;pub use diff::ObjectResolver;pub use epoch::CrossRefType;pub use epoch::CrossReference;pub use epoch::Epoch;pub use epoch::EpochEntry;pub use epoch::EpochError;pub use epoch::EpochScope;pub use epoch::EpochStatus;pub use epoch::Registry;pub use error::CoreError;pub use intent::AgentId;pub use intent::AuthScope;pub use intent::Authority;pub use intent::DelegationLink;pub use intent::Deviation;pub use intent::DeviationImpact;pub use intent::FormatHint;pub use intent::Intent;pub use intent::IntentCategory;pub use intent::IntentId;pub use intent::IntentLifecycle;pub use intent::IntentStatus;pub use intent::NotificationPolicy;pub use intent::Outcome;pub use intent::Principal;pub use intent::Resolution;pub use intent::SessionId;pub use intent::TAG_GIT_REVISION;pub use intent::TAG_PIN_STATE;pub use intent::ToolCall;pub use intent::Urgency;pub use lifecycle::LifecycleError;pub use lifecycle::is_valid_transition;pub use lifecycle::transition;pub use merge::Conflict;pub use merge::ConflictValue;pub use merge::MergeResult;pub use namespace::MAX_NAMESPACE_LEN;pub use namespace::Namespace;pub use namespace::NamespaceError;pub use object::Atom;pub use object::Node;pub use object::Object;pub use object::ObjectId;pub use path::PathComponent;pub use path::PathError;pub use path::StatePath;pub use query::BlameEntry;pub use query::Query;pub use query::QueryFilters;pub use query::QueryOptions;pub use query::QueryTarget;pub use query::filter_commits;pub use schema::EnforcementMode;pub use schema::MergeHint;pub use schema::Schema;pub use schema::ValidationResult;pub use session::Session;pub use session::SessionStatus;
Modules§
- commit
- Commit — an immutable record linking a state tree to its history and metadata.
- diff
- Structured diff engine — schema-aware, typed diffs between state trees.
- epoch
- Epochs — bounded, sealable segments of work for lifecycle management.
- error
- Error types for agentstategraph-core.
- intent
- Intent and Authority types — the provenance metadata that makes AgentStateGraph different from git.
- lifecycle
- Intent lifecycle state machine — enforces valid transitions.
- merge
- Schema-aware merge engine.
- namespace
- Namespace primitive — a separate set of branches in one store.
- object
- Content-addressed objects — the fundamental unit of state storage.
- path
- Path addressing for navigating state trees.
- query
- Unified query interface — one API for querying state, commits, intents, and epochs.
- schema
- Schema system — optional JSON Schema validation with merge hints.
- session
- Sessions — durable records of sub-agent working contexts.