roboto.experimental.sessions.record

Minutes without a new file after which Roboto marks the session complete.

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

ID of the file.

How much of the file’s current version is ingested: not at all, or partly.

The latest time an ingestion rule’s trigger ran on the file. None when none has.

Path of the file within its dataset, device, or org.

When the file’s current version was uploaded.

When this file was added to the session.

User ID or service account that added this file to the session.

The slice of the file the Session holds, as (start, end) in the file’s own units, or None when it holds the whole file. start is the first covered position; end is one past the last.

Identifier of the file.

Upper bound (inclusive) of the part of the file the Session holds, in Unix-epoch nanoseconds. None means the Session holds the file up to the end of its recorded time window; paired with min_wall_clock_timestamp_ns.

Lower bound (inclusive) of the part of the file the Session holds, in Unix-epoch nanoseconds. None means the Session holds the file from the beginning of its recorded time window; paired with max_wall_clock_timestamp_ns.

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

When this file’s place in the session was last modified.

User ID or service account that last modified this file’s place in the session.

Identifier of the session holding this file.

Wall-clock instant of stored time 0 for the file’s data the Session holds, in nanoseconds since the Unix epoch: what the platform added to the file’s own timestamps to reach min_wall_clock_timestamp_ns and max_wall_clock_timestamp_ns, and what to subtract to read any other instant back in the file’s own timestamps. None when that data includes nothing registered, and when it sits at more than one instant, which leaves no single offset to report.

When the file was created.

The slice of the file the Session holds, as (start, end) in the file’s own units, or None when it holds the whole file. start is the first covered position; end is one past the last.

ID of the dataset that contains the file.

Stable, unique identifier of the file.

Whether the file is meant to be ingested: its path matched one of its org’s ingestion rules when its current version was created, or it has since been partly or fully ingested.

How much of the contributing file has been ingested.

Upper bound (inclusive) of the part of the file the Session holds, in Unix-epoch nanoseconds. None means the Session holds the file up to the end of its recorded time window; paired with min_wall_clock_timestamp_ns.

Lower bound (inclusive) of the part of the file the Session holds, in Unix-epoch nanoseconds. None means the Session holds the file from the beginning of its recorded time window; paired with max_wall_clock_timestamp_ns.

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

When the file was last modified.

Name of the file (the final segment of relative_path).

Provenance of the file, e.g. an invocation id or upload source.

Path of the file within its dataset.

Size of the file in bytes.

Tags on the file.

Wall-clock instant of stored time 0 for the file’s data the Session holds, in nanoseconds since the Unix epoch: what the platform added to the file’s own timestamps to reach min_wall_clock_timestamp_ns and max_wall_clock_timestamp_ns, and what to subtract to read any other instant back in the file’s own timestamps. None when that data includes nothing registered, and when it sits at more than one instant, which leaves no single offset to report.

The session is in progress, so it is not announced ingested.

The session is complete and every ingestable file in it is ingested.

The session is complete and at least one of its ingestable files is not ingested yet.

How many ingestable files are ingested.

How many times the session has been announced ingested.

How many files are not ingestable. The session never waits for them.

How many ingestable files are not ingested yet, leaving out skipped ones.

Ingestable files not ingested yet, which keep a complete session from being announced. Holds at most the first 100, ordered by path; pending_file_count counts them all.

ID of the session.

How many ingestable files not ingested the session was told to stop waiting for.

Ingestable files not ingested that the session was told to stop waiting for. At most the first 100; skipped_file_count counts them all.

Whether the session is in progress, waiting for files to be ingested, or ingested.

Pending files whose latest ingestion run failed, or finished without ingesting the file. Counted among the first 100 pending files, as SessionIngestionStatus.pending_files lists them.

How many ingestable files are ingested.

How many files are not ingestable. The session never waits for them.

How many ingestable files are not ingested yet, leaving out skipped ones.

ID of the session.

Ingestable files not ingested that the session no longer waits for.

Whether the session is in progress, waiting for files to be ingested, or ingested.

When the session was last marked complete. None if it never was. Adding a file to a complete session puts it back in progress and keeps this value, so check status to tell whether the session is complete now.

User ID or service account that last marked the session complete. None if it never was.

When Roboto will mark the session complete unless another file is added first. None while the session is complete, has no completion policy, or has no files.

When Roboto marks the session complete on its own. None: the session is marked complete only by request.

When the session was created.

User ID or service account that created the session.

Values for the custom fields defined on Sessions in this org.

Every Ready custom field defined for (org_id, Session) appears as a key; values that have not been set surface as None rather than being absent. Empty when no custom fields are defined for the org.

Optional description of the Session.

When the session was last announced ingested. None until the first announcement.

How many times the session has been announced ingested. Each announcement fires a session.ingested event. A session is announced again when it is put back in progress and marked complete again, or when its ingestable files change while it is complete, once they are all ingested again. A file uploaded again, removed, or deleted changes them; editing a file’s tags, metadata, or description does not.

Latest time covered by the Session, in Unix-epoch nanoseconds. None while none of its files supplies a time: the Session holds no files, or only files added without a time window whose topic data has no time span registered yet.

User-supplied metadata.

Sessions cannot be filtered or sorted by metadata keys; for queryable structured attributes, define a custom field on the Session entity type.

Earliest time covered by the Session, in Unix-epoch nanoseconds. None while none of its files supplies a time: the Session holds no files, or only files added without a time window whose topic data has no time span registered yet.

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

When the Session was last modified.

User ID or service account that last modified the Session.

A short, human-readable name for the Session. If provided, must be 120 characters or less.

Organization that owns the Session.

Stable, unique identifier for the Session.

Whether the session is in progress or complete. Adding a file to a complete session puts it back in progress.

User-supplied tags.

Sessions can be filtered by tag membership (e.g., tags CONTAINS '<tag>') but are not sortable by tag.

All of the session’s files have been added. Roboto announces session.ingested once every ingestable file in it is ingested.

Files may still be added. Roboto does not announce the session ingested.

Where the session stands in ingestion after the skip.

Requested file ids that are not in the session, so nothing was skipped for them.

ID of the file.

Path of the file within its dataset, device, or org.

When the session was told to stop waiting for the file.

User ID or service account that told the session to stop waiting for the file.