Return briefPro
The While you were away card for a chat thread – how long you were gone, what needs you, what failed and what's done as a short list with one action per row; Got it folds it into a one-line divider.
oxyn add return-briefWhile you were away · 2h 14m
- needs you: Export jobWaiting on: CSV or Parquet for the archive?
- needs you: Release notesWaiting on: Post to the changelog or email only?
- failed: Invoice syncFailed: timeout from the billing API after 912 rows
- done: Cache layerOpened PR #317 · on preview
- done: Search pageShipped to the beta group
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.
Rendered from Rust at build time · goes live when visible
When to use
- The "While you were away" card for a chat thread, right where the person left off: how long they were gone, what needs them, what failed and what's done as a short list with one action per row; Got it folds it into a one-line divider.
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
Return brief 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.
oxyn add return-briefUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Default
Two need you, one failed, five done – five rows, Show 3 more and Got it, in the thread where you left off.
While you were away · 2h 14m
- needs you: Export jobWaiting on: CSV or Parquet for the archive?
- needs you: Release notesWaiting on: Post to the changelog or email only?
- failed: Invoice syncFailed: timeout from the billing API after 912 rows
- done: Cache layerOpened PR #317 · on preview
- done: Search pageShipped to the beta group
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Resolved
A decision made: the row turns done in place, its tick draws and the counts roll.
While you were away · 2h 14m
- done: Export jobAnswered: Parquet · exporting now
- needs you: Release notesWaiting on: Post to the changelog or email only?
- failed: Invoice syncFailed: timeout from the billing API after 912 rows
- done: Cache layerOpened PR #317 · on preview
- done: Search pageShipped to the beta group
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Expanded
Show 3 more: every row, and Show less.
While you were away · 2h 14m
- needs you: Export jobWaiting on: CSV or Parquet for the archive?
- needs you: Release notesWaiting on: Post to the changelog or email only?
- failed: Invoice syncFailed: timeout from the billing API after 912 rows
- done: Cache layerOpened PR #317 · on preview
- done: Search pageShipped to the beta group
- done: API referencePublished 22 pages
- done: Load checkHeld at 15k requests a minute
- done: Flaky specsQuarantined 2 specs in onboarding
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Folded
Since a time, folded at first: a one-line divider that opens the card again.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Slow retry
A retry that takes a while: the button works for a moment before the row settles.
While you were away · 2h 14m
- needs you: Export jobWaiting on: CSV or Parquet for the archive?
- needs you: Release notesWaiting on: Post to the changelog or email only?
- failed: Invoice syncFailed: timeout from the billing API after 912 rows
- done: Cache layerOpened PR #317 · on preview
- done: Search pageShipped to the beta group
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Narrow
Narrow: the counts drop under the title and long lines end in an ellipsis.
While you were away · 2h 14m
- needs you: Export jobWaiting on: CSV or Parquet for the archive?
- needs you: Release notesWaiting on: Post to the changelog or email only?
- failed: Invoice syncFailed: timeout from the billing API after 912 rows
- done: Cache layerOpened PR #317 · on preview
- done: Search pageShipped to the beta group
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Classic
Classic style: the header in a grey band, a stronger border and shadow.
While you were away · 2h 14m
- needs you: Export jobWaiting on: CSV or Parquet for the archive?
- needs you: Release notesWaiting on: Post to the changelog or email only?
- failed: Invoice syncFailed: timeout from the billing API after 912 rows
- done: Cache layerOpened PR #317 · on preview
- done: Search pageShipped to the beta group
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
ReturnBrief
| Prop | Type | Default | Description |
|---|---|---|---|
items | Option<Vec<AwayItem>> | Default::default() | Your own items (the demo's when `None`); what needs you comes first. |
away | u32 | AWAY_MINUTES | How long the person was away, in minutes (the head reads "2h 14m"). |
since_clock | Option<u32> | Default::default() | When set (minutes after midnight), the head reads "since 9:40" instead. |
limit | usize | 5 | Rows before Show N more. |
default_collapsed | bool | Default::default() | Starts folded into the divider. |
expanded | bool | Default::default() | Starts with every row shown. |
resolved | Vec<String> | Default::default() | Rows that start resolved (ids). |
work_ms | u64 | Default::default() | How long an action works before it settles, in ms (0 settles at once). |
title | String | "While you were away" | Heading. |
nowrequired | ClockMs | — | The clock. |
style | String | Default::default() | `clean`, `classic`, or empty to follow `data-cstyle`. |
on_action | EventHandler<String> | — | A row's action (item id). |
on_dismiss | EventHandler<()> | — | Got it was pressed. |
on_collapsed_change | EventHandler<bool> | — | Folded (true) or opened (false). |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Through the row actions, then Show more and Got it |
| EnterorSpace | Runs the focused action; Got it folds the card and focuses the divider, which opens it again |
| Escape | Folds the card from anywhere inside it |
Accessibility
- A region named While you were away with a heading that says how long; the rows are a list.
- Every action names its task ("Decide: Export job") and each row says its state in words.
- Got it and the divider are buttons with aria-expanded; a working button stays focusable (aria-disabled); changes are announced politely.
Responsive behaviour
- 600 px up to its container; rows keep one height in every state.
- Under 460 px the counts drop under the title; titles, details and long action labels end in an ellipsis.
Edge cases (spec)
Up to 600 px; rows keep one height. Under 460 px the counts drop under the title; titles, details and long action labels end in an ellipsis (full text in a tooltip); touch buttons are 36 px tall.
Notes for AI
- Import
ReturnBrieffromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
ReturnBriefElinoxyn_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.