statusline

Documentation

Overview

Package statusline renders the poe-acp side of the dev.acp-kit.status-line/v1 ACP extension: a compact one-line header prepended to assistant responses and the live Thinking… indicator, so mobile users see fir-style mood/plan signals they'd otherwise miss without a TUI.

The shared wire-contract pieces (extension id, length cap, Status type, ProviderEmoji map, ParseMeta) live in github.com/kfet/acp-kit/statusline and are re-exported here so existing call sites keep a single import. Only the poe-acp-specific renderers (Header, Spinner) — which use poe markdown and the blockquote+italic spinner style — are owned here.

See docs/ext/status-line.md for the wire spec.

Index

• Constants
• func Header(s Status) string
• func ParseMeta(meta map[string]any) (mood, plan string, ok bool)
• func ProviderEmoji(slug string) string
• func ProviderEmojiForModel(modelID string) string
• func Spinner(s Status, dots string) string
• type Status

Constants

const ExtensionID = kit.ExtensionID

ExtensionID is the _meta key both sides use to advertise support and to carry per-update mood/plan payloads.

const MaxFieldRunes = kit.MaxFieldRunes

MaxFieldRunes caps the rendered length of mood and plan.

Functions

func Header

func Header(s Status) string

Header renders the final-message header (no "Thinking…" suffix). Returns "" when nothing would be shown — caller drops the prepend entirely. Segments are joined with " • " and empty segments are dropped.

func ParseMeta

func ParseMeta(meta map[string]any) (mood, plan string, ok bool)

ParseMeta extracts the v1 mood/plan fields from a session/update _meta map.

func ProviderEmoji

func ProviderEmoji(slug string) string

ProviderEmoji maps a provider slug (case-insensitive) to the emoji shown in the status header.

func ProviderEmojiForModel

func ProviderEmojiForModel(modelID string) string

ProviderEmojiForModel resolves the provider emoji from a fully qualified model id of the form "<provider>/<model>".

func Spinner

func Spinner(s Status, dots string) string

Spinner renders the live thinking indicator. The dots argument is the current animation frame (e.g. ".", "..", "..."). The result is wrapped in a Markdown blockquote + italic so it matches poe-acp's existing heartbeat styling; the spinner is a single block.

Always emits a visible frame — even with no status segments, the caller still needs liveness signal, so the bare "> _Thinking..._" is returned.

Types

type Status

type Status = kit.Status

Status is the renderable state of one status header.