NewStdioClient launches command/args as a subprocess and connects over its stdin/stdout. The Connect call blocks until the server has responded to the

PrintCompaction writes a before/after diff to stdout. Used by verbose mode when a compaction strategy shortens the history.

Recordf is the printf variant of Record.

Register connects to every server in cfg and registers their tools into the supplied Registry. Returns the open clients so main can defer Close. Serve

SetMessages replaces the conversation slice. Used by /compact to write back the result of an ad-hoc strategy.

Stop must be called exactly once per started spinner.

activeSubagentSummary returns a short string like " · research" or " · research ×2, codereview" when subagents are running. Empty otherwise. Tacked on

agentLoop is the inner loop: call the model, dispatch any tool calls, loop. Two exits — the model returns plain text, or it returns a non-tool stop re

assembleSession turns the in-memory draft into (summary, tags, body). The session-summary entry (if any) becomes the file header + the index record; e

buildGroups partitions chapters into the four curriculum chapters of the design. Extra chapters past 12 fall into "Going further" so adding a new chap

cmdDebugList prints every event currently in the ring, one per line, with a marker for events that have an inspectable payload.

cmdDebugShow dumps a single event's full payload to scrollback. With no argument it shows the most recent event that has a payload.

detectLanguage picks a Chroma lexer name from a leading-character peek. Returns "" when no lexer applies — caller skips highlighting in that case.

easeInOutCubic maps t ∈ [0,1] to [0,1] with a smooth-start/smooth-end shape: slow entrance, fast middle, slow exit. The classic curve for "object pass

envTruthy reports whether an env var is set to a value humans normally mean as "yes". Kept tiny on purpose: the harness has no central config struct,

executeTool is the switch that runs whatever the model asked for. The (string, bool) return — content plus is-error flag — is the "errors as tool resu

executeTool prints the tool-call line, optionally asks for confirmation, and dispatches to the registry.

exerciseBlurb looks for the "**Goal:** ..." line. Falls back to the first paragraph if no goal marker is present.

extractWritePath pulls the path out of a write_file tool input so the approval prompt can name the target file. Returns "" on any parse failure — the

formatDebugEvent renders one event as a single line, color-coded by level and source. The leading `#<id>` is what the user passes to /debug show. A tr

hasToolResult scans messages for a tool_result block matching id.

hintText returns the keymap hint shown under the input box. Changes with the active focus so the user always sees which keys are live.

inModal reports whether the current state should render a centered full-screen modal in place of the normal viewport+input layout. Two callers: the de

joinContent flattens MCP content blocks into one string. We only render text natively; non-text blocks get a placeholder so the model knows something

loadAgentsContext reads ./AGENTS.md and returns it wrapped in a header for inclusion in the system prompt. The file is the AGENTS.md convention popula

mcpStatusText formats the loading line shown next to the spinner while background MCP servers are being connected. Empty when nothing's in flight (the

mouseSelect maps a left-click Y coordinate onto the debug panel and, if it lands on an event row, focuses the panel and selects that event.

newProvider picks the initial provider at startup, honoring $LLM_PROVIDER and $LLM_MODEL as optional defaults. Mid-session swaps go through the provid

parseSummaryAndTags extracts a "<summary>\n\nTAGS: a, b, c" shape from the model's reply. If the TAGS line is missing, returns the full text as the su

precedingHasToolUse reports whether any message in slice contains a tool_use block with the given id.

renderTurnHeader returns a "── 15:23:45 ─────────…" divider sized to width. Called when the user submits a new prompt so each turn has an unmistakable

runCommand handles a line that starts with "/". Returns true if handled, false if the line should fall through to the model as a normal message.

setupMCP loads mcp.json (if present) and connects each configured server. progress receives per-server lifecycle events the caller can pipe into the T

shineColor256 returns the 256-color foreground for a banner cell. Two inputs shape the gradient beyond a simple horizontal sweep: - row creates a dia

splitSchema converts the SDK's `any` InputSchema into the (properties, required) pair our api.ToolDef expects. The Anthropic provider feeds InputSchem

summarizeSession asks the active provider for a one-paragraph recap of the conversation plus 3–5 tags, used as the body of the session file saved at s

switchProvider replaces the root agent's provider mid-session and re-registers subagents so they use the new one. Conversation history is kept — it's

toMessages translates our generic Message slice into the OpenAI chat-message shape. Two notable splits: - tool results: Anthropic carries them as bloc

toTools builds the OpenAI tool list. OpenAI expects the *full* JSON Schema envelope (`{"type":"object","properties":..., "required":...}`); our ToolDe

toggleDebugFocus flips focus between the input box and the debug panel. On the first focus, picks the latest event as the selection so ↑/↓ has a start

updateDebugFocus is the key handler used while the debug panel is focused. It owns ↑/↓ navigation, Enter to drill in, Esc to back out, and forwards sc

usageStatus formats the session's cumulative token usage for the status line. Empty when no calls have been made or no UsageFunc was wired.

viewApprovalModal renders the full-screen modal that takes over while the user is reviewing a write_file proposal. Same shape as the debug modal but w

viewDebugModal renders the full-screen modal that takes over while the user is inspecting one event. The conversation viewport and input box are hidde

Confirm shows a single-line y/n prompt and returns the user's answer. Default (Enter, Esc, Ctrl-C) is deny — safer for destructive tools.