ai.newnal.illi.artwork.defs

Details · defs
Kinddefs
Authorityartwork.illi.newnal.ai
Indexed

#archiveWork

object

Properties

artworkKey

requiredstring
  • minLength: 1
  • maxLength: 64

deliveries

requiredarray

localDate

requiredstring

Local date (YYYY-MM-DD) of the day the work was made for, in the home's time zone; the same for sent and unsent works.

  • maxLength: 10

previewUrl

string · uri

Automatic processing recovery: retrying includes backoff and queued work; stopped means no further automatic attempt.

  • knownValues: none | retrying | stopped

productionState

requiredstring
itemsstring · at-uri

title

string

workType

requiredstring

#artworkView

object

Properties

analysisState

requiredstring

artworkKey

requiredstring
  • minLength: 1
  • maxLength: 64

deliveries

requiredarray

Automatic processing recovery: retrying includes backoff and queued work; stopped means no further automatic attempt.

  • knownValues: none | retrying | stopped

productionState

requiredstring

sourceUris

requiredarray
itemsstring · at-uri

title

string

versions

requiredarray

workType

requiredstring
  • knownValues: photoSlides | longVideo | shortVideoCollection

#delivery

object

Delivery counts of one occurrence. Delivered means downloaded and acknowledged, not played.

Properties

devices

requiredinteger

Devices this occurrence was offered to.

  • minimum: 0

received

requiredinteger

Devices that downloaded the whole file and confirmed its size and hash (not that anyone watched it).

  • minimum: 0

#deliveryView

object

Properties

artworkKey

requiredstring
  • maxLength: 64

completedAt

string · datetime

compositionVersion

requiredinteger
  • minimum: 1

deliveryId

requiredstring
  • maxLength: 64

durationMs

integer
  • minimum: 0

expiresAt

requiredstring · datetime

failure

string
  • knownValues: download | size | hash | storage | metadata | decode

kind

string
  • knownValues: slides | video

lastPositionMs

requiredinteger
  • minimum: 0

occurrenceId

requiredstring
  • maxLength: 64

offeredAt

string · datetime

playbackReadyAt

string · datetime

played

requiredboolean

Whether this device started playing this delivery; independent of receipt.

receivedAt

string · datetime

state

requiredstring

Receipt state: offered, received, failed, cancelled or expired.

  • knownValues: offered | received | failed | cancelled | expired

title

string

#familyWorkCard

object

Properties

artworkKey

requiredstring
  • minLength: 1
  • maxLength: 64

compositionVersion

requiredinteger
  • minimum: 1

deliveryId

requiredstring
  • minLength: 1
  • maxLength: 64

durationMs

requiredinteger
  • minimum: 0

lastPositionMs

requiredinteger
  • minimum: 0

playable

requiredboolean

playbackState

requiredstring
  • knownValues: unplayed | inProgress | paused | completed

Stored version introduction, shared with direct cards. Absent during generation or retries; later reads may fill it even for an existing snapshot.

thumbnailUrl

requiredstring

title

requiredstring

workType

requiredstring
  • knownValues: photoSlides | longVideo | shortVideoCollection

#manifest

object

Properties

artworkKey

requiredstring
  • maxLength: 64

blobCid

requiredstring · cid

CID of the video blob on the root admin's PDN.

byteSize

requiredinteger
  • minimum: 1
  • maximum: 314572800

compositionVersion

requiredinteger

Fixed for this delivery: later versions never replace it.

  • minimum: 1

contentHash

requiredstring

sha256 of the file, lowercase hex.

  • maxLength: 128

deliveryId

requiredstring
  • maxLength: 64

downloadUrl

requiredstring

Path on the Service Agent Node (GET, bearer, device session) that streams exactly this file.

durationMs

integer
  • minimum: 0

expiresAt

string · datetime

height

integer
  • minimum: 1

homeId

requiredstring

kind

requiredstring
  • knownValues: slides | video

mediaArtworkId

requiredstring
  • maxLength: 128

mimeType

requiredstring

Always video/mp4.

title

string

width

integer
  • minimum: 1

#occurrenceView

object

Properties

acceptedAt

string · datetime
  • minimum: 1

analysisState

requiredstring
  • knownValues: pending | masking | verifying | verified | textGenerating | complete | failed

artworkKey

requiredstring
  • maxLength: 64

attempt

requiredinteger
  • minimum: 0

Composition changed after guardian editing/acceptance of a previous attempt. Previous edits are not applied to this attempt. Absent after a new subtitle edit is accepted; processing retries that preserve composition do not set it.

  • knownValues: previousEditsNotApplied

changesUntil

string · datetime

Upload-window end while the next-day draft may change. Omitted at/after local midnight and for immediate debug days.

durationMs

integer

Output length of the accepted version, or of the latest stored version when none is accepted; absent until that version has rendered.

  • minimum: 0

errorCode

string

expiresAt

requiredstring · datetime

Technical readiness stage while held before dispatch, or terminal failure reason when not ready at the first dispatch decision at/after scheduledAt. Absent on a failure whose stored version's originals are no longer eligible.

  • knownValues: processing | analysis | text | render | store

localDate

requiredstring
  • maxLength: 10

lockAt

requiredstring · datetime

locked

requiredboolean

occurrenceId

requiredstring
  • maxLength: 64

previewUrl

string · uri

Automatic processing recovery: retrying includes backoff and queued work; stopped means no further automatic attempt.

  • knownValues: none | retrying | stopped

productionState

requiredstring
  • knownValues: composing | ready | failed | cancelled

receivedAt

string · datetime

revision

requiredinteger
  • minimum: 1

scheduledAt

requiredstring · datetime

slotKey

requiredstring
  • knownValues: newPhoto | newVideo | basePhoto | baseVideo

state

requiredstring
  • knownValues: scheduled | held | offered | received | cancelled | expired | failed

title

string

workType

string

Present after concrete media selection; an in-flight video kind choice has no selected work type yet.

  • knownValues: photoSlides | longVideo | shortVideoCollection

#scheduledSlot

object

Properties

localDate

requiredstring
  • maxLength: 10

reason

string

insufficientSources: the slot had too few eligible originals, so no occurrence or work exists for it.

  • knownValues: insufficientSources

slotKey

requiredstring
  • knownValues: newPhoto | newVideo | basePhoto | baseVideo

state

requiredstring
  • knownValues: insufficient | processing | failed | excluded | ready

#versionView

object

Properties

analysis

requiredunknown

compositionVersion

requiredinteger
  • minimum: 1

errorCode

string

previewUrl

string · uri

state

requiredstring
  • knownValues: ready | processing | failed

storeState

requiredstring

Similar lexicons

semantic match

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

  • 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

  • Full media snapshot; additional fields are allowed and retained.