Skip to content
Back

Sequence diagramPro

One agent run as a sequence diagram – a column for you, each agent and each tool, every message an arrow between lifelines, calls solid and replies dashed, bars while a participant works, and parallel or retried messages in labelled frames.

oxyn add sequence-diagram
Fix the failing sign-up0 messages0:00
No messages yet
    The code is part of Oxyn Pro

    The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.

    Get Pro

    Rendered from Rust at build time · goes live when visible

    When to use

    • One agent run as a sequence diagram: a column for you, each agent and each tool, every message an arrow from one lifeline to the next.
    • Shows who called whom, in what order, what ran in parallel and what had to be retried.

    When not to use

    • An agent asks before it acts: use Approval Card instead.
    • Several open requests in one card: use Approval pager instead.
    • An agent's question in its own card above the composer: use Decision Card instead.

    Installation

    Sequence diagram is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.

    Terminal
    oxyn add sequence-diagram

    Usage

    Dioxus · rust
    The code is part of Oxyn Pro

    The preview is free. Pro opens the code of every Pro component, screen and template.

    Get Pro

    Examples

    Live

    The run plays out message by message – each arrow draws across with its tag, bars grow on the lifelines while participants work, the parallel and retried messages gather in labelled frames, then it loops.

    Fix the failing sign-up0 messages0:00
    No messages yet
      Code Pro
      The code is part of Oxyn Pro

      The preview is free. Pro opens the code of every Pro component, screen and template.

      Get Pro

      Settled

      The finished run: fifteen messages, one failure, every bar closed.

      Fix the failing sign-up1 failure15 messages1:09
      0:000:020:030:030:050:060:080:110:120:290:470:501:051:071:09
      par
      retry
      1. ✕
      Lead to You: Fixed – PR #318 ready to merge, 1:09
      Code Pro
      The code is part of Oxyn Pro

      The preview is free. Pro opens the code of every Pro component, screen and template.

      Get Pro

      Message card

      A message's card: sender to receiver, the label, Call or Reply, its frame, what went along and how long the answer took.

      Fix the failing sign-up1 failure15 messages1:09
      0:000:020:030:030:050:060:080:110:120:290:470:501:051:071:09
      par
      retry
      1. ✕
      Lead to You: Fixed – PR #318 ready to merge, 1:09
      Code Pro
      The code is part of Oxyn Pro

      The preview is free. Pro opens the code of every Pro component, screen and template.

      Get Pro

      Participant card

      A participant's card: kind, Working or Idle, the model, what it does, and messages sent and received, tasks and busy time.

      Fix the failing sign-up1 failure15 messages1:09
      0:000:020:030:030:050:060:080:110:120:290:470:501:051:071:09
      par
      retry
      1. ✕
      Lead to You: Fixed – PR #318 ready to merge, 1:09
      Code Pro
      The code is part of Oxyn Pro

      The preview is free. Pro opens the code of every Pro component, screen and template.

      Get Pro

      Narrow

      Under 560 px the chips drop to their marks and the time gutter narrows.

      Fix the failing sign-up1 failure15 messages1:09
      0:000:020:030:030:050:060:080:110:120:290:470:501:051:071:09
      par
      retry
      1. ✕
      Lead to You: Fixed – PR #318 ready to merge, 1:09
      Code Pro
      The code is part of Oxyn Pro

      The preview is free. Pro opens the code of every Pro component, screen and template.

      Get Pro

      Classic

      Classic style: a white card, pill chips and tags, tinted frames.

      Fix the failing sign-up1 failure15 messages1:09
      0:000:020:030:030:050:060:080:110:120:290:470:501:051:071:09
      par
      retry
      1. ✕
      Lead to You: Fixed – PR #318 ready to merge, 1:09
      Code Pro
      The code is part of Oxyn Pro

      The preview is free. Pro opens the code of every Pro component, screen and template.

      Get Pro

      API reference

      SequenceDiagram

      PropTypeDefaultDescription
      participantsOption<Vec<SeqParticipant>>Default::default()Your own participants (the demo's when `None`).
      messagesOption<Vec<SeqMessage>>Default::default()Your own messages, in order.
      titleString"Fix the failing sign-up"The header's name.
      atOption<u64>Default::default()Freeze the demo at this many ms into a pass.
      runningbooltrueStill running: open bars shimmer and working marks twinkle.
      openStringDefault::default()A message open at the start (id).
      open_participantStringDefault::default()A participant open at the start (id).
      nowrequiredClockMs—The clock.
      styleStringDefault::default()`clean`, `classic`, or empty to follow `data-cstyle`.
      on_selectEventHandler<Option<String>>—A message selected (its id), or `None` when its card closes.

      Read from the Rust signature and doc comments.

      Keyboard interactions

      KeyAction
      TabTo the participant chips, then into the message list
      EnterorSpaceOpens the focused participant's or message's card
      EscapeCloses the open card

      Accessibility

      • Messages are an ordered list; each is named "Sender to Receiver: text, status, m:ss" and says it opens a dialog.
      • Participants are buttons; cards are dialogs with a close button you can reach by Tab.
      • Colour never carries meaning alone: replies are dashed, failures say so and carry a cross, frames are labelled.

      Responsive behaviour

      • 800 px up to its container; the columns share the width.
      • Under 560 px the chips show only their marks and the time gutter and times shrink.
      Edge cases (spec)

      Under 560 px the chips show only their marks, the gutter narrows to 36 px and times shrink to 10 px; tags may take 40 % of the width before they ellipsize.

      Notes for AI

      • Import SequenceDiagram from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
      • A GPUI version exists: SequenceDiagramEl in oxyn_gpui.
      • Props to set first: now.
      • It reads a clock (now) for live timers; pass one clock for the whole page rather than one per component.
      • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

      Guides

      Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI