pub struct AdminView<'a>(/* private fields */);Expand description
Admin operations: statistics, compaction, maintenance, and agent management.
Implementations§
Source§impl<'a> AdminView<'a>
impl<'a> AdminView<'a>
Sourcepub fn mutation_write_contracts(&self) -> &'static [MutationWriteContract]
pub fn mutation_write_contracts(&self) -> &'static [MutationWriteContract]
Return the product-level write guarantee table used by diagnostics and docs.
Sourcepub async fn stats(&self) -> HirnResult<DbStats>
pub async fn stats(&self) -> HirnResult<DbStats>
Get aggregate database statistics.
Sourcepub async fn count(&self) -> HirnResult<LayerCounts>
pub async fn count(&self) -> HirnResult<LayerCounts>
Get per-layer record counts.
Sourcepub fn consolidate(&self) -> ConsolidateBuilder<'a>
pub fn consolidate(&self) -> ConsolidateBuilder<'a>
Start building a consolidation operation.
Sourcepub fn lifecycle_compact(&self) -> LifecycleCompactBuilder<'a>
pub fn lifecycle_compact(&self) -> LifecycleCompactBuilder<'a>
Start building a lifecycle compaction operation.
Sourcepub async fn apply_resource_retention_policy(
&self,
policy: &ResourceRetentionPolicy,
) -> HirnResult<ResourceRetentionApplyResult>
pub async fn apply_resource_retention_policy( &self, policy: &ResourceRetentionPolicy, ) -> HirnResult<ResourceRetentionApplyResult>
Apply a specific resource retention policy to active resource heads.
Sourcepub async fn apply_configured_resource_retention(
&self,
) -> HirnResult<ResourceRetentionApplyResult>
pub async fn apply_configured_resource_retention( &self, ) -> HirnResult<ResourceRetentionApplyResult>
Apply the configured resource retention policy from HirnConfig.
Sourcepub async fn audit_log(
&self,
after: Option<&Timestamp>,
before: Option<&Timestamp>,
) -> HirnResult<Vec<AuditEntry>>
pub async fn audit_log( &self, after: Option<&Timestamp>, before: Option<&Timestamp>, ) -> HirnResult<Vec<AuditEntry>>
Query the audit log.
Sourcepub async fn cross_agent_consolidate(
&self,
target_namespace: &Namespace,
auto_merge_threshold: f32,
) -> HirnResult<CrossAgentConsolidationResult>
pub async fn cross_agent_consolidate( &self, target_namespace: &Namespace, auto_merge_threshold: f32, ) -> HirnResult<CrossAgentConsolidationResult>
Consolidate semantic records across agents in a namespace.
Sourcepub async fn purge_agent(&self, agent_id: &AgentId) -> HirnResult<PurgeReport>
pub async fn purge_agent(&self, agent_id: &AgentId) -> HirnResult<PurgeReport>
Purge all data associated with an agent (GDPR Right to Erasure).
Sourcepub async fn schedule_offline_job(
&self,
job: CognitiveJob,
) -> HirnResult<OfflineJobId>
pub async fn schedule_offline_job( &self, job: CognitiveJob, ) -> HirnResult<OfflineJobId>
Queue a budgeted offline cognition job.
Sourcepub fn offline_job_status(
&self,
job_id: OfflineJobId,
) -> Option<OfflineJobStatus>
pub fn offline_job_status( &self, job_id: OfflineJobId, ) -> Option<OfflineJobStatus>
Inspect the latest in-memory status for an offline cognition job.
Sourcepub async fn inspect_offline_job(
&self,
job_id: OfflineJobId,
) -> HirnResult<Option<OfflineJobInspection>>
pub async fn inspect_offline_job( &self, job_id: OfflineJobId, ) -> HirnResult<Option<OfflineJobInspection>>
Inspect durable audit history and latest state for an offline cognition job.
Sourcepub async fn retry_offline_job(
&self,
job_id: OfflineJobId,
) -> HirnResult<OfflineJobId>
pub async fn retry_offline_job( &self, job_id: OfflineJobId, ) -> HirnResult<OfflineJobId>
Retry a failed offline cognition job using the configured retry backoff policy.
Sourcepub async fn replay_offline_job(
&self,
job_id: OfflineJobId,
) -> HirnResult<OfflineJobId>
pub async fn replay_offline_job( &self, job_id: OfflineJobId, ) -> HirnResult<OfflineJobId>
Replay a terminal offline cognition job as a new attempt immediately.
Sourcepub fn offline_scheduler_metrics(&self) -> OfflineSchedulerMetrics
pub fn offline_scheduler_metrics(&self) -> OfflineSchedulerMetrics
Inspect the scheduler counters for queued offline cognition jobs.
Sourcepub async fn close(&self) -> HirnResult<()>
pub async fn close(&self) -> HirnResult<()>
Close the database, flushing pending writes.
Sourcepub async fn get_memory(&self, id: MemoryId) -> HirnResult<MemoryRecord>
pub async fn get_memory(&self, id: MemoryId) -> HirnResult<MemoryRecord>
Retrieve a memory record from any layer by ID.
Sourcepub async fn get_memories_batch(
&self,
ids: &[MemoryId],
) -> HirnResult<HashMap<MemoryId, MemoryRecord>>
pub async fn get_memories_batch( &self, ids: &[MemoryId], ) -> HirnResult<HashMap<MemoryId, MemoryRecord>>
Batch-retrieve memory records from any layer by IDs.
Sourcepub async fn validate_semantic_revisions(
&self,
) -> HirnResult<SemanticRevisionIntegrityReport>
pub async fn validate_semantic_revisions( &self, ) -> HirnResult<SemanticRevisionIntegrityReport>
Validate semantic revision chains and the runtime semantic head cache.
Sourcepub async fn repair_semantic_revisions(
&self,
) -> HirnResult<SemanticRevisionRepairReport>
pub async fn repair_semantic_revisions( &self, ) -> HirnResult<SemanticRevisionRepairReport>
Rebuild the runtime semantic head cache from authoritative semantic storage state.
Auto Trait Implementations§
impl<'a> Freeze for AdminView<'a>
impl<'a> !RefUnwindSafe for AdminView<'a>
impl<'a> Send for AdminView<'a>
impl<'a> Sync for AdminView<'a>
impl<'a> Unpin for AdminView<'a>
impl<'a> UnsafeUnpin for AdminView<'a>
impl<'a> !UnwindSafe for AdminView<'a>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
Source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>, which can then be
downcast into Box<dyn ConcreteType> where ConcreteType implements Trait.Source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait> (where Trait: Downcast) to Rc<Any>, which can then be further
downcast into Rc<ConcreteType> where ConcreteType implements Trait.Source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &Any’s vtable from &Trait’s.Source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &mut Any’s vtable from &mut Trait’s.Source§impl<T> DowncastSend for T
impl<T> DowncastSend for T
Source§impl<T> DowncastSync for T
impl<T> DowncastSync for T
Source§impl<T> FmtForward for T
impl<T> FmtForward for T
Source§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self to use its Binary implementation when Debug-formatted.Source§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self to use its Display implementation when
Debug-formatted.Source§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self to use its LowerExp implementation when
Debug-formatted.Source§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self to use its LowerHex implementation when
Debug-formatted.Source§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self to use its Octal implementation when Debug-formatted.Source§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self to use its Pointer implementation when
Debug-formatted.Source§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self to use its UpperExp implementation when
Debug-formatted.Source§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self to use its UpperHex implementation when
Debug-formatted.Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
Source§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
Source§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read moreSource§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read moreSource§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
Source§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
Source§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self, then passes self.as_ref() into the pipe function.Source§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self, then passes self.as_mut() into the pipe
function.Source§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self, then passes self.deref() into the pipe function.Source§impl<T> Pointable for T
impl<T> Pointable for T
Source§impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> PolicyExt for Twhere
T: ?Sized,
Source§impl<T> Tap for T
impl<T> Tap for T
Source§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B> of a value. Read moreSource§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B> of a value. Read moreSource§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R> view of a value. Read moreSource§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R> view of a value. Read moreSource§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target of a value. Read moreSource§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target of a value. Read moreSource§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap() only in debug builds, and is erased in release builds.Source§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut() only in debug builds, and is erased in release
builds.Source§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow() only in debug builds, and is erased in release
builds.Source§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut() only in debug builds, and is erased in release
builds.Source§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref() only in debug builds, and is erased in release
builds.Source§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut() only in debug builds, and is erased in release
builds.Source§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref() only in debug builds, and is erased in release
builds.