Dimmed wraps s with the dim ANSI escape and reset.

Test helpers that build common message shapes — text turn, tool-use turn, tool-result turn. Keeps the test cases readable.

SetEnabled flips recording on or off. The UI calls this from the /debug slash command. Disabling does not clear the ring — old events stick around unt

Cyan wraps s with the bold-cyan ANSI escape and reset.

refreshDebugContent re-renders the debug ring into the debug viewport. Two modes: - debugList: one line per event; the currently selected event (if an

Enabled reports whether recording is currently on.

RenderTranscript serializes messages to a human-readable transcript. Used by summarization prompts and compaction logs.

NewSessionFiles opens (or creates) the memory directory at root and loads the index. Missing sessions referenced in the index get pruned silently — dr

Snapshot returns a copy of the current ring, oldest first.

Record appends a payload-less event and returns its ID (0 if disabled).

Clear empties the ring. Called from /debug clear.

Add returns the per-field sum. Provider accumulators use this to fold a per-call Usage into the running total.

Close flushes the current session draft to a markdown file and adds a record to index.json. An empty draft (no Save calls) is a no-op — empty sessions

Get returns a previously-registered tool, used by Subset to compose curated tool registries for subagents.

Recordp appends an event with an attached payload (full request JSON, tool output, before/after transcript) and returns its ID. Payload is truncated t

SafeSplitPoint walks backward from `desired` to find an index where the conversation is in a "clean" state — no tool_use without its tool_result on ei

Save appends an entry to the in-progress session draft. Nothing reaches disk until Close — drafts are cheap, and per-Save file writes during a busy se

layout recomputes viewport widths/heights from the current window size. In any modal state (debug detail OR approval-with-diff) the debug viewport is

setConversationContent pushes the current scrollback buffer into the viewport, wrapping it to the viewport's width first so long lines (file output, J

Calls returns how many times Send has been invoked.

Recall walks the index and returns up to `limit` session records whose summary or tags match the query. Match is a case-insensitive substring scan, or

Close shuts down the session. For stdio transports this terminates the subprocess; for HTTP it tears down the persistent connection. Safe to call mult

Definitions returns all registered tool schemas, sorted by name so the output is deterministic (important for prompt caching when you turn it on).

FindByID returns the event with the given monotonic ID, if it's still in the ring. Used by /debug show to look up a specific event.

Pair returns the event linked to id, in either direction. If the given event has a CorrelatedID, that's the request it's paired with. Otherwise Pair w

buildWriteDiff returns a unified-diff string describing what a write_file tool call would change on disk, suitable for display in the approval modal.

record is the shared implementation. The sink (if any) is called outside the lock to avoid re-entrancy from sinks that take their own lock. Returns th

HasToolResult reports whether the message contains any tool_result blocks. Used by compaction to find safe split points (a clean conversation boundary

Recordpc is Recordp with a correlation back to a previously-recorded event. The new event's CorrelatedID is set to startID; Pair() can then walk the l

formatThousands inserts thousands separators into a non-negative int.

formatThousands inserts thousands separators into a non-negative int. Mirrors the helper in commands.go; lives here too to avoid a UI → main dependenc

newTestAgent wires an Agent against the mock provider with the smallest useful surface area: an empty system prompt, an empty tool registry, no-op com

BannerText returns the banner as a string for callers that want to pre-populate a scrollback buffer (the TUI program) rather than print.

Execute dispatches a tool call by name. Unknown tools return an error result rather than panicking — the model can read it and recover.

HighlightPayload returns content with ANSI 256-color syntax highlighting applied if it looks like a recognized language (JSON or a unified diff), othe

ProviderKind returns the short name of a provider value. Used by /model and /provider to display the active backend.

Recordfc is Recordf with a correlation back to a previously-recorded event. Used for the error-path response that pairs with an in-flight request.

SetSink registers a callback fired on each Record. The TUI uses it to nudge a re-render of the debug panel. Pass nil to unregister.

Subset returns a new Registry containing only the named tools from r. Used to build curated tool sets for subagents (e.g. give a research subagent onl

TermWidth returns stdout's terminal width, or 0 when stdout isn't a TTY.

modalSize returns the outer width/height of the detail modal — capped so it doesn't get unreadably wide on big monitors, and clamped so small terminal

newProviderByName constructs a provider by short name. An empty model string falls back to that provider's default. Unknown names error.

rewriteLinksFrom rewrites the relative markdown links in body so they work on the generated site: - `(NN-name.md)` becomes `(NN-name.html)` (sibling

splitChapter pulls the first H1 out of the raw markdown, returns the chapter number (best-effort), the human title, and the body without the H1 (becau

Active returns a snapshot of currently running subagents (name -> count). Used by the /subagents command and any UI affordance that wants to show what

Latest returns the most recent event that has a non-empty payload, or (zero, false) if the ring is empty or no event has a payload yet. Used by /debug

Messages returns the agent's conversation slice. Callers (e.g. /compact) may read it, but should not mutate it directly — use SetMessages instead.

NewMockProvider constructs a MockProvider preloaded with the given canned responses. Equivalent to &MockProvider{Responses: responses} but reads bette

Preamble returns the last preambleSessionCount session summaries as a compact block ready to concatenate to the system prompt. Bounded size so a year

compactorName returns a short label for whichever compaction strategy is active. Used in debug-log entries so it's obvious what ran.

firstParagraph returns the first non-empty paragraph of body as plain text, dropping a leading "Goal:" / "Objetivo:" label if present. Used as the gui

── history persistence ───────────────────────────────────────────────────

loadChapters reads every *.md in dir (skipping README.md, which is a table of contents the generator builds itself) and returns rendered chapters in f

loadExercises reads every *.md in dir (skipping README.md) and returns rendered exercises sorted by slug. Returns nil with no error if the directory i

loadGuides reads every *.md in dir (skipping README.md, which is just an index in the markdown source) and returns rendered guides sorted by filename.

marshalRequestPayload renders the about-to-be-sent request as pretty JSON for the /debug show panel. We include the resolved tool list (names + descri

marshalResponsePayload renders the full response shape for /debug show. Includes elapsed wall time so the user can tell at a glance which calls were e

moveSelection walks the snapshot to find the current selection, then shifts it by delta (clamped). The snapshot is small (≤500) so a linear scan is fi

notifyDebugUI sends a DebugToggleMsg into the running program so it recomputes layout. Called from /debug after flipping state.

registerSubagents wires up every subagent the harness exposes.

renderInline applies a minimal inline-markdown pass: HTML-escapes the text, then turns `...` backtick runs into <code>...</code>. Good enough for one-

renderLanguage writes one full set of pages (landing + chapters + how-tos + exercises) for a given language under out/<subdir>. Pass subdir="" for the

replaceBanner regenerates the banner with the current shine column and splices it into place inside m.output. Anything written after the banner (the u

shineTickCmd schedules the next shine animation frame.

AnimatedBanner returns the banner with a "shine" highlight peaked at column shineCol. Pass shineCol == -1 (or any out-of-range value) to get the stati

Begin marks a subagent run as started. Returns a function to be deferred that decrements the count on completion.

CallTool dispatches a tool invocation to the remote server. The result's content blocks (the SDK supports text, image, audio, etc.) are concatenated t

ClearMessages wipes the conversation history.

LastSent is shorthand for the most recent SentAt.

ListTools returns every tool the server exposes. Called once at startup per server, results cached in our local registry.

LoadConfig reads a JSON config file. Missing file returns (nil, nil) — MCP is opt-in; absence is not an error.

NewHTTPClient connects to a remote MCP server over the Streamable HTTP transport. Headers (auth tokens, API keys) are injected via a RoundTripper so t

NewOpenAIProvider constructs the provider. The SDK reads OPENAI_API_KEY from the environment by default; pass option.WithAPIKey if you need to overrid

NewProgram builds the Bubble Tea program. Wire the returned program to a Confirm callback and a stdout-pipe forwarder before calling Run. Pass nil for