Link lists
Experimental operator-activated link panels: bounded labels and checked web destinations, explicit per-frontend declaration, destination-free owner/observer fallbacks, and native pointer/keyboard activation. Passive card.v1 remains unchanged.
Living doc, checked against the code 2026-11-14
links.v1 — an operator-activated list of web links
Status: built; experimental in docs/contracts/api-surfaces.toml, so it may change.
| field | bound |
|---|---|
title |
the card title rule, at most 80 characters |
summary |
the card summary rule, at most 160 characters |
items |
one to twelve rows |
row label |
required plain text, at most 60 characters |
row detail |
optional plain text, at most 80 characters |
row url |
optional canonical HTTP(S) address, at most 2,048 bytes; never truncated |
more |
optional nonnegative count of omitted rows |
Every object is closed. The gateway checks the envelope and text bounds before relay, and the native consumer checks the body again. A destination may not carry credentials, a non-web scheme, control characters or ambiguous URL syntax, and may not be a literal address or a local name. The final DNS label begins with an ASCII letter, which also excludes decimal, octal and hexadecimal IPv4 forms. A row without an accepted destination is plain text.
This kind is separate from passive card.v1 and adds no action or URL field to a card block. An owner or observer
that does not declare it gets a card.v1 list of labels and detail, with no navigation hints. The browser kit does
not declare it and draws that fallback. The GPUI conversation window declares the full kind. It draws
keyboard-accessible controls with each destination’s host visible. Receiving or drawing the panel does nothing
outside the window. Activating a control opens that row’s checked destination through the platform browser API, not
through the gateway or a shell.
pi_feeds fills the panel from its own unread receipt. Destinations stay out of the model-facing unread answer and
its receipt log. The mutation body’s seven-KiB budget applies; rows past it become more. The reader keeps a
destination whole or omits it at the byte bound. A cached link of exactly 2,000 characters stays plain: it may be
truncated.