Class BetaManagedAgentsMemoryVersion
-
- All Implemented Interfaces:
public final class BetaManagedAgentsMemoryVersionA
memory_versionobject: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 withcontent,path,content_size_bytes, andcontent_sha256set tonull; branch onredacted_at, not HTTP status.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description public final classBetaManagedAgentsMemoryVersion.BuilderA builder for BetaManagedAgentsMemoryVersion.
public final classBetaManagedAgentsMemoryVersion.Type
-
Method Summary
Modifier and Type Method Description final Stringid()Unique identifier for this version (a memver_...value).final OffsetDateTimecreatedAt()A timestamp in RFC 3339 format final StringmemoryId()ID of the memory this version snapshots (a mem_...value).final StringmemoryStoreId()ID of the memory store this version belongs to (a memstore_...value).final BetaManagedAgentsMemoryVersionOperationoperation()The kind of mutation a memory_versionrecords.final BetaManagedAgentsMemoryVersion.Typetype()final Optional<String>content()The memory's UTF-8 text content as of this version. final Optional<String>contentSha256()Lowercase hex SHA-256 digest of contentas of this version (64 characters).final Optional<Integer>contentSizeBytes()Size of contentin bytes as of this version.final Optional<BetaManagedAgentsActor>createdBy()Identifies who performed a write or redact operation. final Optional<String>path()The memory's path at the time of this write. final Optional<OffsetDateTime>redactedAt()A timestamp in RFC 3339 format final Optional<BetaManagedAgentsActor>redactedBy()Identifies who performed a write or redact operation. final JsonField<String>_id()Returns the raw JSON value of id. final JsonField<OffsetDateTime>_createdAt()Returns the raw JSON value of createdAt. final JsonField<String>_memoryId()Returns the raw JSON value of memoryId. final JsonField<String>_memoryStoreId()Returns the raw JSON value of memoryStoreId. final JsonField<BetaManagedAgentsMemoryVersionOperation>_operation()Returns the raw JSON value of operation. final JsonField<BetaManagedAgentsMemoryVersion.Type>_type()Returns the raw JSON value of type. final JsonField<String>_content()Returns the raw JSON value of content. final JsonField<String>_contentSha256()Returns the raw JSON value of contentSha256. final JsonField<Integer>_contentSizeBytes()Returns the raw JSON value of contentSizeBytes. final JsonField<BetaManagedAgentsActor>_createdBy()Returns the raw JSON value of createdBy. final JsonField<String>_path()Returns the raw JSON value of path. final JsonField<OffsetDateTime>_redactedAt()Returns the raw JSON value of redactedAt. final JsonField<BetaManagedAgentsActor>_redactedBy()Returns the raw JSON value of redactedBy. final Map<String, JsonValue>_additionalProperties()final BetaManagedAgentsMemoryVersion.BuildertoBuilder()final BetaManagedAgentsMemoryVersionvalidate()Validates that the types of all values in this object match their expected types recursively. final BooleanisValid()Booleanequals(Object other)IntegerhashCode()StringtoString()final static BetaManagedAgentsMemoryVersion.Builderbuilder()Returns a mutable builder for constructing an instance of BetaManagedAgentsMemoryVersion. -
-
Method Detail
-
createdAt
final OffsetDateTime createdAt()
A timestamp in RFC 3339 format
-
memoryId
final String memoryId()
ID of the memory this version snapshots (a
mem_...value). Remains valid after the memory is deleted; pass it asmemory_idto /en/api/beta/memory_stores/memory_versions/list to retrieve the full lineage including thedeletedrow.
-
memoryStoreId
final String memoryStoreId()
ID of the memory store this version belongs to (a
memstore_...value).
-
operation
final BetaManagedAgentsMemoryVersionOperation operation()
The kind of mutation a
memory_versionrecords. Every non-no-op mutation to a memory appends exactly one version row with one of these values.
-
type
final BetaManagedAgentsMemoryVersion.Type type()
-
content
final Optional<String> content()
The memory's UTF-8 text content as of this version.
nullwhenview=basic, whenoperationisdeleted, or whenredacted_atis set.
-
contentSha256
final Optional<String> contentSha256()
Lowercase hex SHA-256 digest of
contentas of this version (64 characters).nullwhenredacted_atis set oroperationisdeleted. Populated regardless ofviewotherwise.
-
contentSizeBytes
final Optional<Integer> contentSizeBytes()
Size of
contentin bytes as of this version.nullwhenredacted_atis set oroperationisdeleted. Populated regardless ofviewotherwise.
-
createdBy
final Optional<BetaManagedAgentsActor> createdBy()
Identifies who performed a write or redact operation. Captured at write time on the
memory_versionrow. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the /en/api/sessions-retrieve.
-
path
final Optional<String> path()
The memory's path at the time of this write.
nullif and only ifredacted_atis set.
-
redactedAt
final Optional<OffsetDateTime> redactedAt()
A timestamp in RFC 3339 format
-
redactedBy
final Optional<BetaManagedAgentsActor> redactedBy()
Identifies who performed a write or redact operation. Captured at write time on the
memory_versionrow. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the /en/api/sessions-retrieve.
-
_id
final JsonField<String> _id()
Returns the raw JSON value of id.
Unlike id, this method doesn't throw if the JSON field has an unexpected type.
-
_createdAt
final JsonField<OffsetDateTime> _createdAt()
Returns the raw JSON value of createdAt.
Unlike createdAt, this method doesn't throw if the JSON field has an unexpected type.
-
_memoryId
final JsonField<String> _memoryId()
Returns the raw JSON value of memoryId.
Unlike memoryId, this method doesn't throw if the JSON field has an unexpected type.
-
_memoryStoreId
final JsonField<String> _memoryStoreId()
Returns the raw JSON value of memoryStoreId.
Unlike memoryStoreId, this method doesn't throw if the JSON field has an unexpected type.
-
_operation
final JsonField<BetaManagedAgentsMemoryVersionOperation> _operation()
Returns the raw JSON value of operation.
Unlike operation, this method doesn't throw if the JSON field has an unexpected type.
-
_type
final JsonField<BetaManagedAgentsMemoryVersion.Type> _type()
Returns the raw JSON value of type.
Unlike type, this method doesn't throw if the JSON field has an unexpected type.
-
_content
final JsonField<String> _content()
Returns the raw JSON value of content.
Unlike content, this method doesn't throw if the JSON field has an unexpected type.
-
_contentSha256
final JsonField<String> _contentSha256()
Returns the raw JSON value of contentSha256.
Unlike contentSha256, this method doesn't throw if the JSON field has an unexpected type.
-
_contentSizeBytes
final JsonField<Integer> _contentSizeBytes()
Returns the raw JSON value of contentSizeBytes.
Unlike contentSizeBytes, this method doesn't throw if the JSON field has an unexpected type.
-
_createdBy
final JsonField<BetaManagedAgentsActor> _createdBy()
Returns the raw JSON value of createdBy.
Unlike createdBy, this method doesn't throw if the JSON field has an unexpected type.
-
_path
final JsonField<String> _path()
Returns the raw JSON value of path.
Unlike path, this method doesn't throw if the JSON field has an unexpected type.
-
_redactedAt
final JsonField<OffsetDateTime> _redactedAt()
Returns the raw JSON value of redactedAt.
Unlike redactedAt, this method doesn't throw if the JSON field has an unexpected type.
-
_redactedBy
final JsonField<BetaManagedAgentsActor> _redactedBy()
Returns the raw JSON value of redactedBy.
Unlike redactedBy, this method doesn't throw if the JSON field has an unexpected type.
-
_additionalProperties
final Map<String, JsonValue> _additionalProperties()
-
toBuilder
final BetaManagedAgentsMemoryVersion.Builder toBuilder()
-
validate
final BetaManagedAgentsMemoryVersion validate()
Validates that the types of all values in this object match their expected types recursively.
This method is not forwards compatible with new types from the API for existing fields.
-
builder
final static BetaManagedAgentsMemoryVersion.Builder builder()
Returns a mutable builder for constructing an instance of BetaManagedAgentsMemoryVersion.
The following fields are required:
.id() .createdAt() .memoryId() .memoryStoreId() .operation() .type()
-
-
-
-