Attachments

Attachments are first-class evidence — image, audio, video, sensor, and file artifacts referenced by a trace or step.

Shape

type Attachment = {
  type: "image" | "audio" | "video" | "file" | "sensor";
  uri: string;                 // gs://… within the project's tenant prefix
  mime?: string;
  size_bytes?: number;
  duration_ms?: number;
  fps?: number;
  modality?: string;
  metadata?: Record<string, unknown>;
};

Storage path contract

gs://{bucket}/orgs/{org_id}/projects/{project_id}/traces/{trace_id}/attachments/{filename}

Rendering

image — inline thumbnail with click-to-zoom.
audio — waveform with native controls.
video — scrubber with native controls.
file — type icon and linked artifact.
sensor — frame artifact with modality metadata.

← Messages & content parts

Architecture →