small gleam coding and (not yet) persistent agent daemon with a detachable cli forked from okami.mom/albedo
5.3 kB · 104 lines
Markdown
at main

Terminal client #

The Go terminal client lives in cli/internal/tui. It uses Bubble Tea models and the daemon client. The web client is another client of the daemon.

Application and screens #

AppModel owns navigation between chat, session selection, and other screens. Update routes messages to the relevant model and handles transitions such as opening the model picker, webhooks, and Discord pages. listFrame renders shared list-screen framing. pageStatus tracks loading and request generations for pages.

Follow Add or change a terminal screen for shared components, keyboard conventions, confirmation behavior, and stale-request handling.

Chat and events #

ChatModel.Init starts the stream subscription and status requests. The subscription delivers daemon events as Bubble Tea messages. Cancellation and stream termination are handled in the subscription code. Chat transcript state and rendering live in transcript_state.go and transcript.go.

chat_shell.go parses shell input, submits commands through the daemon client, and updates their output in chat. Shell output is external content, not an instruction to the model.

Reasoning controls #

Chat headers and the model picker prefer the catalog's display name. The session's API ID remains unchanged. The chat loads names through the session-bound model catalog when it opens or its model or provider changes. Late replies must match the chat generation, session, provider, and model before changing the displayed name. Missing names or failed reads fall back to the ID. The same read retains model and profile reasoning defaults so inherited chat headers show the effective level. Unknown levels display Provider default. Unsupported profile levels remain visible in the selectors with an unsupported warning and a model-default bypass.

The model picker separates the effective reasoning level from its source in the details pane. Left and Right choose a level, with the actual default annotated. Ctrl+X resets the staged choice to the profile/model default. When the profile has an override, Ctrl+T switches the staged choice between the profile and model default. Enter applies the choice only to this session. Escape cancels it. Ctrl+S separately asks to apply and save the selected model and reasoning for the named profile. Confirming changes that profile without changing the starting profile.

The chat selector, opened with /effort, uses a vertical list. The actual default level is annotated instead of appearing as a separate row. Up and Down preview levels, Ctrl+X resets to default, and Ctrl+T switches the default source when a profile override exists. Previewing does not save the choice. Enter applies it and Escape restores the composer. The list keeps the highlight visible in short terminals. Models owns the saved choice and provider resolution contract.

Moving a session #

/cd to another host's folder opens the question box. It asks the daemon's preflight, and cd_move.go starts and follows the move when the user chooses yes. An unavailable preflight shows its reason under yes and offers only no.

A target that can't take this daemon's data refuses in the preflight or when a move reaches staging. cdRefusal reads three codes for a person:

  • transfer_target_older: "The target daemon is older than this one and can't accept this session. Update albedo on host."
  • transfer_extension_unavailable: an extension this session uses failed to load there. It gives no update advice.
  • transfer_unsupported: the target may be older, or one of its extensions failed to load there. An older target can't say which.

The target's own words, which name what it lacks, stay below in faint text for debugging. Other refusals show their reason as it came. The shot gallery's cd screen covers these states. The rules behind the codes are in moves between versions.

Screens and tests #

Screen-specific models and rendering live beside the application model. For example, webhooks_page.go and discord_page.go implement their respective pages. Screenshot fixtures and tests live in the same package, including shot_chat_test.go.

The Go client boundary owns typed daemon operations and transport recovery. Follow Change the HTTP API when a screen needs a new public operation.