Briyah SDK - v2.0.6
    Preparing search index...

    Interface Artifact

    Represents an artifact created in a room

    interface Artifact {
        body: string;
        creator: string;
        name: string;
        transient?: boolean;
        viewers?: string[];
    }
    Index
    body: string
    creator: string
    name: string
    transient?: boolean

    Deliver this artifact in the transient prompt rather than the cached one.

    An ordinary artifact renders into {{visibleArtifacts}}, which sits in the cached system block ahead of any attached documents — so every write throws away the cached prefix of every viewer, including their rule documents. A transient artifact is left out of that block and injected into the uncached per-turn prompt instead (see Room.buildTransientPrompt), which is also not written to history.

    The trade is exact: a transient artifact is re-sent in full on every one of its viewers' turns and never cached, so it suits state that is small and changes often — a character sheet whose hit points move every round. An artifact that is large and stable is cheaper left cached.

    viewers?: string[]