ProgramArtifactDescriptor

Models & Types · AiDotNet.Evolution.Programs.ArtifactStore

What a store knows about one artifact without reading its bytes.

For Beginners

This is the label on the box rather than the contents: the name, how large it is, whether it is text, and whether anything was cut off. Use it to decide which outputs are worth loading.

How It Works

Listing is the operation that makes an artifact store usable after a run: a run that produced ten thousand evaluations may hold gigabytes of captured output, and a caller triaging it needs to know what exists and how big it is before deciding what to load. A descriptor answers that question at index cost, whereas reading the artifact itself may touch a large file.

Tier reports which side of the store’s size threshold the artifact landed on, so a caller can distinguish an inline read from a file read. IsTruncated reports that the store had to cut the content to stay inside its configured limit, which is the difference between a program that printed nothing more and one whose output was discarded.

Constructors

Constructor Summary
ProgramArtifactDescriptor(string genomeId, string name, int byteLength, bool isText, bool isTruncated, ProgramArtifactTier tier, DateTimeOffset storedAtUtc) Initializes a descriptor.

Properties

Property Summary
DateTimeOffset StoredAtUtc { get; } Gets when the artifact was written, in UTC.
ProgramArtifactTier Tier { get; } Gets which storage tier holds the bytes.
bool IsText { get; } Gets whether the artifact was supplied as text.
bool IsTruncated { get; } Gets whether the stored content was cut to fit the store’s limit.
int ByteLength { get; } Gets the stored size in bytes.
string GenomeId { get; } Gets the genome the artifact belongs to.
string Name { get; } Gets the artifact’s label.

Methods

Method Summary
string ToString() Returns the name, size, and tier, never the content.