At this level
ai.newnal.illi.artwork ยท 13- ai.newnal.illi.artwork.ackDelivery procedure Device app. Acknowledges one delivery: outcome received after the whole file was downloaded, its CID, size and sha256 matched the manifest and a decoder frame was prepared without starting playback (playbackReady true); outcome failed with the failure stage otherwise. received is final and counts the work's originals as used; a failure consumes nothing. The same requestKey replays the first answer.
- ai.newnal.illi.artwork.defs defs Delivery counts of one occurrence. Delivered means downloaded and acknowledged, not played.
- ai.newnal.illi.artwork.excludeOccurrence procedure Root/main admin cancels an unsent occurrence before the one-hour lock. No automatic substitute.
- ai.newnal.illi.artwork.getArtwork query Family app (active guardians; parents excluded). One work with its versions, sources, occurrences and deliveries. Stored versions can be previewed before delivery (getPreview).
- ai.newnal.illi.artwork.getFamilyWork query Device app. One received work by its delivery: the card and whether its manifest can still be read. Works outside today's recommendations included.
- ai.newnal.illi.artwork.getManifest query Device app. The fixed composition version, CID, size, sha256 and download URL of one delivery. Cancelled or expired unreceived deliveries have no manifest; received versions remain accessible after retry expiry. The file and a new acknowledgement follow the same access rule.
- ai.newnal.illi.artwork.getPreview query Exact stored-version product preview for active guardians, including before delivery.
- ai.newnal.illi.artwork.listArchive query Family app (active guardians; parents excluded). History cards of the home's generated works, newest first, with the stored preview when there is one.
- ai.newnal.illi.artwork.listDeliveries query Device app. Deliveries to download, oldest first: offered or failed deliveries before expiry. state=all also lists received, cancelled and expired deliveries. A delivery whose version can no longer be sent is left out of the open list (its manifest, file and acknowledgement would answer DeliveryWithdrawn). Read on reconnect and on artworkDelivery events; the events are hints, kept 30 days.
- ai.newnal.illi.artwork.listFamilyWorks query Device-local daily recommendation membership/order snapshot. Stored version introductions are reused; a missing sentence may fill on a later read. An explicit snapshotId retains that device's published history across midnight.
- ai.newnal.illi.artwork.listScheduled query Family app (active guardians; parents excluded). The occurrences of a local-date interval (default: today) with their revision, lock time and preview, the four slot outcomes of every planned day in the interval, and changesUntil, the deadline for changing tomorrow's draft.
- ai.newnal.illi.artwork.recordPlayback procedure Device app. Records a playback event of a delivered work: started (clears the unplayed state), paused (with the position the viewer can resume from) and completed. Playback is independent of delivery and is never an acknowledgement. Events are idempotent by eventKey within the delivery; the server keeps the latest paused position.
- ai.newnal.illi.artwork.updateSubtitle procedure Root/main admin accepts a photo-only supplied subtitle render before the one-hour lock. Completion is asynchronous.