BlipAction

A declarative action: an id routed back to the extension’s onAction, never code. At most 4 survive on a payload (quick choices included); places with little room show the first one or two.

Properties

confirm?

optional confirm?: boolean

Asks first, a hold or a second press, like a destructive action but without its red: for what’s consequential rather than harmful (Merge, Publish).

copy?

optional copy?: string

Copied by the host directly, with no round trip (“Copy branch”), and said under the notch. At most MAX_COPY_CHARS characters. Not with url or input.

dismisses?

optional dismisses?: boolean

Takes its list item out of the list the moment it’s pressed (Done, Snooze, Mute), so the press feels instant: the notch hides the item while the action runs, and your next update decides. It comes back if the action fails. Only for a list item’s buttons (ListItem.actions). The kit’s TRIAGE actions set it.

icon?

optional icon?: string

SF Symbol name.

id

id: string

input?

optional input?: "text"

"text" shows a reply field on the surface; the typed text comes back as input.

label

label: string

on?

optional on?: boolean

A switch, and whether it’s on (keep awake, mute): its icon names the switch, and a tile lights it while on.

placeholder?

optional placeholder?: string

quick?

optional quick?: boolean

One of a set of small choices (“5 min”, “+1 min”), shown only where the item has room (opened in place) as a line of chips, never in a row, a tile or a peek.

role?

optional role?: "default" | "primary" | "destructive"

default and destructive change presentation; primary calls out one action.

url?

optional url?: string

Opened by the host directly, with no round trip to the extension.