Session returns the session history associated with this Agent.

SessionID returns the current review's resumable session ID. It returns an empty string when the session file could not be created, so callers do not

SessionsRoot returns the root directory where session JSONL files are stored.

SetDiffMap replaces the diff snapshot. Must be called before concurrent access begins.

ShutdownWithTimeout creates a timeout context and calls Shutdown.

Snapshot returns the current count of stored comments. Pair with Since / ReplaceSince to operate on the comments added between two points in time (e.g

SubmitFor is Submit plus registration under key, so AwaitKey can wait for exactly the units submitted under that key instead of the whole pool. Calle

TotalOutputTokens returns the accumulated completion tokens from all LLM calls.

TotalTokensUsed / TotalInputTokens / ... delegate to the underlying runner.

WaitBackground blocks until every background job started by this Runner has returned. Background memory compression is the only such job, and cancelPe

Read with proactive pacing, mirroring the GitHub Action's readWithPacing. Reads are cheaper than writes but still consume the primary rate li

argCountError assembles the guidance for a wrong argument count. The count the user supplied is deliberately not echoed back — it adds nothing they do

assertNoSessionStore fails if the session store was created under home. Preview neither runs nor finalizes a review, so it must not open persistence a

budgetAgentTestTemplate returns a minimal template sufficient to drive dispatchSubtasks without plan/dedup/summary phases.

buildOpenAIParams converts the shared ChatRequest into OpenAI SDK parameters.

classifyAttempt maps an observation to an ErrorClass and FailurePhase. A non-2xx status is the strongest available fact, so it decides the class befo

cloned returns a copy of the manifest whose coverage slices are owned copies, so every Finalize caller gets an independent, non-aliased snapshot. The

colorOn reports whether ANSI color should be emitted.

cpProtocolIndex maps a protocol string (canonical name or legacy alias) to its index in cpProtocols. Unknown / empty values default to the OpenAI Chat

deleteCustomProvider removes a custom provider from cfg in memory. Returns true if the deleted provider was the active one.

emptySHA256 is the canonical digest of an empty input, which hashFields must return for an empty field sequence.

excludeToolDef returns a copy of defs with any entries whose function name matches name removed. Used by `ocr scan` to hide tools that don't make sens

freshOCRHome points the OCR home at a temp dir so a test can assert on what a command wrote there. It also neutralizes global git config: git resolves

groupIntoRounds parses messages[start:] into logical (assistant + tool_results) pairs.

initOTLPHTTPProviders sets up OTLP HTTP exporters for traces and metrics. Unlike the gRPC path this uses WithEndpointURL rather than WithEndpoint, so

initOTLPProviders dispatches to the gRPC or HTTP exporter based on cfg.OTLPProtocol.

isErrorStatus reports whether an observed HTTP status proves the attempt failed on its own. Status 0 means no response was received, so it proves noth

isPathExcluded returns true when the given relative file path should be skipped based on hardcoded dir rules or .gitignore patterns. Patterns are res

loadGitignorePatterns reads and parses .gitignore patterns from the repo root.

makeBudgetDiffs returns n small, non-deleted diffs that survive filterDiffs and filterLargeDiffs.

manifestMode maps the review to the manifest input mode. It derives purely from From/To/Commit so the value is always one of the three valid input mod

mergeBase computes the merge-base for range mode. Returns "" for other modes.

newRequestMeta builds the retry-report identity for one logical LLM request. It is the single place provider and model are read for that purpose — th

officialAPIKeyRequiredError mirrors the wording applyOfficialProviderConfig uses for the same failure, so the interactive and non-interactive paths na

outputPreview renders a preview in the requested output format. sarif is rejected with an error because a preview contains file/rule metadata, not rev

positionalSignature extracts the positional-argument part of cmd.Use, e.g. "<key> <value>" from "set <key> <value>" and "<path...>" from "rule [flags]

preview is read-only with respect to the Agent: it does not mutate a.items. (Earlier versions did, which made a subsequent Run on the same Agent silen