Skip to content

ProgressInput

  • CommonInput

optional actions?: BlipAction[]

At most 4 are kept; surfaces with less room show the first one or two.

CommonInput.actions


optional eta?: DateInput


optional facts?: Fact[]

At most 4 are kept.

CommonInput.facts


optional fraction?: number | null

0…1, or omitted/null when indeterminate.


optional icon?: string

SF Symbol name. Falls back to the extension’s icon when omitted.

CommonInput.icon


key: string

The part of id this extension owns: the full id becomes <extensionId>/<key>.

CommonInput.key


optional relay?: Relay

Whether this item may be shared beyond this Mac: "allow" (the default) or "deny". Blipbar shares nothing beyond the Mac today, so it has no effect.

CommonInput.relay


optional short?: string

A short form of the title for the ear’s label-and-value chip ("LDN"), at most 8 characters.

CommonInput.short


optional stages?: StageInput[]

A pipeline’s stages, in order (see Stage in the schema). Dates may be Dates.


optional staleAfter?: DateInput

After this, every surface renders the item stale without another message. A Date/ISO string is absolute; a plain number under 1e9 is “N seconds from now”.

CommonInput.staleAfter


optional startedAt?: DateInput


optional state?: BlipState

CommonInput.state


optional step?: string


optional stepCount?: number


optional stepIndex?: number


optional subtitle?: string

One line of context: the current step, the question an agent is asking.

CommonInput.subtitle


title: string

CommonInput.title


optional url?: string

Opened when the item itself is clicked.

CommonInput.url