Struct AgentContext 

pub struct AgentContext<'a> { /* private fields */ }

Agent-scoped database context enforcing namespace isolation.

Created via db.as_agent(agent_id).

Implementations

impl<'a> AgentContext<'a>

pub fn agent_id(&self) -> &AgentId

The agent ID for this context.

pub fn accessible_namespaces(&self) -> &[Namespace]

The namespaces accessible to this agent.

pub fn private_namespace(&self) -> Namespace

The agent’s private namespace.

pub fn can_access(&self, ns: &Namespace) -> bool

Check whether this agent can access a given namespace.

pub async fn remember(&self, record: EpisodicRecord) -> HirnResult<MemoryId>

Store an episodic record in the agent’s private namespace (default) or a specified namespace.

pub async fn remember_in( &self, record: EpisodicRecord, namespace: Namespace, ) -> HirnResult<MemoryId>

Store a record explicitly in a named namespace.

pub fn recall(&self, query_embedding: Vec<f32>) -> AgentRecallBuilder<'_>

Recall memories, searching only accessible namespaces. By default searches private + shared.

pub fn think(&self, query_embedding: Vec<f32>) -> AgentThinkBuilder<'_>

Think (context assembly) scoped to this agent’s accessible namespaces.

pub fn watch(&self, filter: WatchFilter) -> HirnResult<WatchSubscription>

Create a watch subscription scoped to the agent’s accessible namespaces.

pub async fn inspect(&self, id: MemoryId) -> HirnResult<InspectResult>

Inspect a record, verifying the agent has access to its namespace.

pub async fn trace(&self, id: MemoryId) -> HirnResult<TraceResult>

Trace a record, verifying the agent has access to its namespace.

pub async fn store_semantic( &self, record: SemanticRecord, ) -> HirnResult<MemoryId>

Store a semantic record, enforcing namespace access.

pub async fn archive_episode(&self, id: MemoryId) -> HirnResult<()>

Archive an episodic record, verifying namespace access.

pub async fn delete_episode(&self, id: MemoryId) -> HirnResult<()>

Delete an episodic record, verifying namespace access.

pub async fn retract_semantic( &self, id: MemoryId, retraction: SemanticRetraction, ) -> HirnResult<SemanticRecord>

Retract a semantic record, verifying namespace access.

pub async fn override_semantic( &self, id: MemoryId, override_request: SemanticOverride, ) -> HirnResult<SemanticRecord>

Apply a durable semantic override, verifying namespace access.

pub async fn correct_semantic( &self, id: MemoryId, update: SemanticUpdate, ) -> HirnResult<SemanticRecord>

Correct a semantic record, verifying namespace access.

pub async fn supersede_semantic( &self, id: MemoryId, supersession: SemanticSupersession, ) -> HirnResult<SemanticRecord>

Supersede a semantic record, verifying namespace access.

pub async fn merge_semantic( &self, target: MemoryId, merge: SemanticMerge, ) -> HirnResult<SemanticMergeOutcome>

Merge semantic logical memories, verifying namespace access for the target and sources.

pub async fn purge_semantic(&self, id: MemoryId) -> HirnResult<()>

Purge all revisions for a semantic logical memory, verifying namespace access.

pub async fn connect_with( &self, source: MemoryId, target: MemoryId, relation: EdgeRelation, weight: f32, metadata: Metadata, ) -> HirnResult<EdgeId>

Create a graph edge between two records, verifying namespace access for both.

pub async fn execute_ql(&self, query: &str) -> HirnResult<QueryResult>

Execute a HirnQL query scoped to the agent’s accessible namespaces.

pub async fn share_memory( &self, id: MemoryId, target_namespace: &Namespace, ) -> HirnResult<MemoryId>

Share a memory from this agent’s accessible namespaces to a target namespace.

pub async fn promote_to_shared(&self, id: MemoryId) -> HirnResult<MemoryId>

Promote a private semantic record to the shared namespace.

pub fn db(&self) -> &HirnDB

Get the underlying database reference.