Memory Partition

Shared stored-memory metadata rules.

MemoryPartition(role, scope, user_id, agent_id, source, target) dataclass

One validated vector-memory ownership partition.

is_important_memory(metadata)

Return whether stored memory metadata marks the row as important.

Parameters:

Name	Type	Description	Default
metadata	Mapping[str, Any] | None	Stored vector-memory metadata.	required

Returns:

Name	Type	Description
bool	bool	True when the importance metadata is enabled.

normalize_memory_metadata_text(value)

Normalize one non-empty metadata text value.

Parameters:

Name	Type	Description	Default
value	Any	Raw metadata value.	required

Returns:

Type	Description
str | None	str | None: Stripped text, or None when the value is unsafe.

resolve_memory_partition(metadata)

Resolve the dedupe and retention partition from stored metadata.

Parameters:

Name	Type	Description	Default
metadata	Mapping[str, Any] | None	Stored vector-memory metadata.	required

Returns:

Type	Description
MemoryPartition | None	MemoryPartition | None: Resolved partition, or None when the
MemoryPartition | None	metadata cannot safely identify a user-agent memory scope.