---
title: "Link lists"
description: "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."
type: "living"
source: "docs/contracts/links.v1.md"
verified: "2026-11-14"
group: "Contracts"
---

> **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.

