Skip to content
Vulpine
Esc
↑↓navigate↵open⌘Jpreview

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.

Was this page helpful?