isMachineReadable reports whether the output format writes a structured document to stdout that must not be interleaved with progress text. Both json

loadDiffs populates the diff-related fields.

loadTestTemplate returns a validated default template for runtime tests.

logicalRequestID computes the canonical logical_request_id for m under runID. Fields are NUL-terminated in a fixed order rather than concatenated, be

manifestItemID derives the content-independent item_id for a diff, keyed on operation, input mode and the normalized old/new paths. RegisterSelected a

maybeRunDedup, when the template has a DedupTask and the batch produced at least DedupMinComments comments, invokes the DEDUP_TASK LLM to merge near-d

maybeRunProjectSummary runs the post-batch PROJECT_SUMMARY_TASK over the union of all collected comments. Best-effort: any error / empty input no-temp

openBrowserCandidates tries each candidate in turn. Every failure is reported, not just the first: with $BROWSER set to something uninstalled and no p

parentState builds a resumable parent: a v1 review manifest whose identity is parentIdentity, run on anthropic/claude, with one selected item. mutate

planEnabled / dedupEnabled / summaryEnabled report whether each optional phase will actually run: template must define it AND the corresponding --no-*

Drive post() over a sequence of per-call fake_urlopen outcomes. Each outcome is either the raw response body (bytes, returned) or an

resolveWorkingDirForSession accepts an explicit --repo flag value and falls back to the current working directory. Unlike resolveRepoDir it does not r

resolvedModel returns the model to persist, falling back to the in-session pick for the provider being finalized when result.model is empty.

runSessionCommentsCompat provides test compatibility for old-style runSessionComments([]string{...}) calls.

splitBindHost returns the host portion of a listen address as passed to http.Server.Addr. Empty input returns "".

AwaitKey blocks until every unit submitted under key so far has completed. It never touches the pool-wide WaitGroup, so it is safe to call while other

Compare buckets the findings of an earlier run (before) against a later one (after). Matching is a multiset match on findingKey, so N identical findin

DefaultConfig returns a disabled default configuration.

HasInclude reports whether any include patterns are configured.

HasPersistence reports whether this session has a JSONL writer. A false value means no resumable session file exists, even though the run still has it

IsReserved reports whether name matches any built-in tool name (including Unknown).

LoadGitignorePatterns reads and parses .gitignore patterns from the given repository root. Returns nil if the file is missing or unreadable.

NewRemoteClient connects to a remote MCP server via Streamable HTTP transport. Header values may contain $ENV_VAR references which are expanded at run

NewResumeLineage builds the lineage for an accepted resume of parent. It returns nil when there is nothing to record — no parent, or a parent with no

ParseExtraHeaders parses a string of comma-separated key=value pairs into a dictionary. Values may be double-quoted to include commas, e.g. X-Forwarde

ParseReviewMode returns the correct ReviewMode based on provided flag values.

ProjectSummary is the markdown project-level summary produced by scan's PROJECT_SUMMARY_TASK. Empty for review mode and for scans that skipped / faile

Quiet replaces stdout with io.Discard and returns a cleanup function. Usage: defer stdout.Quiet()() WARNING: Quiet must ONLY be called from the mai

RecordToolResult sets the outcome of a tool execution on the span.

RefValue returns the git ref that should be used for reading file contents in range or commit mode. Returns ("", false) for workspace mode.

ResumeInfo returns resume metadata for output. Nil means this was not a resume run.

ReusableItem returns the checkpoint for fingerprint only if the parent manifest also recorded that fingerprint as completed or reused. The manifest i

Session returns the session history associated with this Agent.

SessionID returns the persisted session identifier so callers can show it in JSON output or failure diagnostics. Returns "" when no session was create

SetParentRunID links this run to the session it resumed from. It only records the direct parent; the parent's input is never copied into this run.

Shutdown flushes and shuts down all initialized providers. It should be called before process exit to ensure buffered data is exported.

ToToolDef converts an MCP tool definition to an llm.ToolDef.

ToolFailures returns failed tool calls ordered by their global call number.

UseTestSessions redirects session persistence to the "test-sessions" subdirectory and raw captures to "test-raw", so that test runs do not pollute the

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

Warnings returns a copy of the accumulated warnings.

applyDedupGroups parses the DEDUP_TASK output and returns the deduped comment slice. Returns (nil, false) when the response is malformed OR when the g

assertDeclined is the shared assertion for a batch the repair must refuse: no comments, no repair description, and the parser's own wording handed bac

── project-layer confinement tests ── canonicalRoot returns the canonical (symlink-resolved) form of dir, mirroring loadProjectRule's pathutil.Canonic

captureStderr swaps os.Stderr for a pipe around fn and returns what was written. Output here is tiny, so reading after the writer is closed avoids any

colorize wraps s in seq and a reset, or returns s untouched when color is off. Every escape sequence in the text output path is gated through here or

enforceGroupTokenBudget splits groups whose combined diffs exceed the token limit.

enforceMaxFilesPerGroup splits groups that exceed maxFilesPerGroup into smaller chunks.

ensureMessagesSuffix appends /v1/messages to base URLs that lack a versioned path.

estimateDiffFileTokens projects the input+output token cost of reviewing a single diff (PLAN + MAIN_TASK rounds). It mirrors scan.estimateFileTokens b

executeGroupPlanPhase runs the plan phase for a file group.

expandSessionKeyInBody returns a copy of body with SessionKeyTemplateVar replaced by key in every string value, recursing into nested maps and slices.

expandSessionKeyInHeaders returns a copy of headers with every occurrence of SessionKeyTemplateVar in the values replaced by key. The input map is nev

explainError translates a Bedrock rejection into the action that fixes it. Two of these are actively misleading as the service words them: the API-key