Lexicon Garden

ai.newnal.illi.family.mediaItem

One original photo or video in the home's content bank. The original and its sidecar are blobs on the author's PDN; the thumbnail, display rendition, poster, dimensions and capture time are produced by the media service and uploaded by the Service Agent Node to the same PDN after the item was created, so a freshly created item may carry only the original and its upload-time content hash for exact deduplication.

Repository @illi-service.newnal.id did:plc:uztm7bi2ce42dez3uu3qafro namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authorityfamily.illi.newnal.ai
Indexed
Compare Edit in builder → Fork →

Record

record · key tid

Properties

aiDescription

string

Description written by the media service's AI analysis (ai.description of the asset snapshot). Written by the Service Agent Node; never edited by clients.

  • maxLength: 10000
  • maxGraphemes: 1000

aiTags

array

Tags the media service's AI analysis chose (ai.tags of the asset snapshot). Written by the Service Agent Node from the media service's result; never edited by clients.

  • maxLength: 100
itemsstring
  • maxLength: 640
  • maxGraphemes: 64

contentHash

string

sha256 hex of the original bytes, computed by the media service.

  • maxLength: 128

createdAt

requiredstring · datetime

display

blob

1600 px display rendition for the device. Made by the media service and uploaded by the Service Agent Node to the uploader's PDN. Present only when the original's longest side exceeds 1600 px or a PNG or HEIC original exceeds 2 MB; clients show the original otherwise.

  • maxSize: 2000000
  • accept: image/jpeg

durationMs

integer

Video duration in milliseconds, set by the media service.

  • minimum: 0

height

integer

Orientation-corrected height in pixels of the original, set by the media service.

  • minimum: 1

kind

requiredstring
  • knownValues: photo | video

manualTakenAt

string · datetime

Uploader correction sent to media updateUserInput; omitted when cleared. Effective takenAt and its source come from media.

media

requiredblob
  • maxSize: 314572800
  • accept: image/jpeg, image/png, image/webp, image/heic, video/mp4, video/quicktime

note

string
  • maxLength: 3000
  • maxGraphemes: 300

people

array
  • maxLength: 20

poster

blob

Video poster frame. Made by the media service and uploaded by the Service Agent Node to the uploader's PDN; absent until processing has produced it.

  • maxSize: 2000000
  • accept: image/jpeg

sidecar

blob

XMP sidecar the media service wrote for the original (application/xmp+xml), uploaded by the Service Agent Node to the uploader's PDN with the uploader's own session, which needs the blob token for that type.

  • maxSize: 1000000
  • accept: application/xmp+xml

takenAt

string · datetime

Capture time from file metadata, otherwise upload time. Until processing finishes, the upload time is used.

takenAtSource

string

Effective capture-time provenance returned by media: manual, file metadata, file modification time or upload fallback.

  • knownValues: exif | upload | manual | file_modified

thumb

blob

320 px thumbnail. Made by the media service and uploaded by the Service Agent Node to the uploader's PDN; absent until processing has produced it.

  • maxSize: 200000
  • accept: image/jpeg

width

integer

Orientation-corrected width in pixels of the original, set by the media service.

  • minimum: 1

#person

object

Properties

name

requiredstring
  • maxLength: 500
  • maxGraphemes: 50

relationship

string
  • maxLength: 200
  • maxGraphemes: 20

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • ai.newnal.illi.media.defs

    Full media snapshot; additional fields are allowed and retained.

  • ai.newnal.illi.family.artworkVersion

    record

    One finished version of a family work: the video the media service made, stored as a blob on the root admin's PDN and referenced from the family sphere (root admin repo, written by the Service Agent Node with the root admin's session). The record key is deterministic, "v1-" plus the first 32 hex characters of sha256 over homeId, artworkKey, mediaArtworkId and compositionVersion joined with newlines, so a retried write replaces the same record with the same content and other content under the sam

  • am.noz.atgallery.alpha.libraryMedia

    record

    A private media original with an optional safe local thumbnail.

  • ai.newnal.illi.media.uploadItem

    procedure

    Upload one photo or video. multipart/form-data parts: homeId, file, timezone?, people? (JSON array of {name, relationship?}, at most 20 people), note? (at most 300 graphemes), takenAt? (offset-bearing timestamp). Unknown parts are ignored. A manual takenAt is queued after registration through updateUserInput. Otherwise capture time comes from file metadata, then upload time. Same-file content in one home returns the existing active original across uploaders, ignoring the new people/note/takenAt

  • am.noz.atgallery.alpha.publishedMedia

    record

    An immutable, public, metadata-allowlisted media rendition.