An artifact's owner moves who may open it with an artifact.put over its newest version that sends no files, a new version carrying every file, which the daemon forwards so the desktop app changes it in place; a pod sends a large version by an upload handle as a daemon does; and a path part past 255 bytes is refused before anything is written¶
Decision 955 · accepted · 2026-10-27 · issue #765
The decision.
- A put over a version may send no files.
artifact.put {id, base, visibility?, title?, note?}with neitherfilesnoruploadis the next version carrying every file ofbase, their objects not copied. It is checked as any put is:basemust still be the newest (conflictotherwise), only the owner movesvisibility, and a move to a team takes every stored byte to that team's quota (Decision 953). It stays a version, not a field changed in place, so the history says when an artifact was moved and by whom, as every other change to one does (Decision 950). Withoutbasea put with no files is refused as before: there is nothing to carry. - The daemon forwards it, with
id,base,visibility,titleandnoteand never files (those go byartifact.publishwithid), refused under Local only as everyartifact.*is (Decision 951). The desktop app's Change who can see it is a choice of the same audiences its Publish dialog offers, in place; this narrows Decision 954, under which it opened the console's page. - A pod sends a large version by an upload handle, as a daemon does: past about 2.5 MB of
base64,
session.artifact.upload.begin {session_id, epoch?, files}over the control link answers a handle for the session's owner, the pod PUTs each file to its presigned URL, andsession.artifact.publishnamesupload. One function decides it for both (Troupe.Gateway.Artifacts.carried/2), given how each begins. A pod reaches the object store as it does to seal a session; a deployment whose worker egress does not reach the plane's object-store endpoint publishes only what fits inline. - A path part is at most 255 bytes, the object store's own limit, refused with the publish's other path rules before anything is written.
Governs: apps/troupe_plane/lib/troupe/plane/artifacts.ex, apps/troupe_plane/lib/troupe/plane/control/connection.ex, apps/troupe_gateway/lib/troupe/gateway/artifacts.ex, apps/troupe_gateway/lib/troupe/gateway/dispatch.ex, apps/troupe_worker/lib/troupe/worker/artifacts.ex, clients/gui/apps/desktop/src/views/Artifacts.tsx