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.

Swap replaces the stdout writer with replacement and returns a restore function. It lets tests capture output written through Writer(), and lets calle

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

UseTestSessions redirects session persistence to the "test-sessions" subdirectory so that test runs do not pollute the real sessions store. It must b

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

WithinBase reports whether target is base itself or contained under base.

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

buildAllowedHosts returns the default-deny allowlist used by the host guard. The set always includes the standard loopback names. If bindHost is a con

buildOpenAIParams converts the shared ChatRequest into OpenAI SDK parameters.

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

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

filterLargeScans drops items whose content exceeds 80% of MaxTokens.

finalizeManifest freezes the run's coverage builder and stores the immutable manifest on the session for persistence and CLI consumption. Nil-safe. A

firstLine returns the first non-empty trimmed line of git output, so a stray trailing newline or an unexpected second line never pollutes a resolved S

formatPlanGuidance parses the PLAN_TASK JSON output into a markdown snippet suitable for embedding in MAIN_TASK. On parse failure it returns the raw c

humanTokens formats a token count as e.g. "1.2M" / "850K" / "420".

humanTokens formats a token count as e.g. "1.2M" / "850K" / "420". Mirrors internal/scan/estimate.go; kept here so agent has no scan import.

isUserEditMsg reports whether msg represents user text input (typing or paste).

loadTestTemplate returns a validated default template for runtime tests.

maybeRunPlan invokes PLAN_TASK on the file and returns a human-readable guidance string suitable for {{plan_guidance}} substitution. Returns "(no pre-

mustGetResult extracts the first result from a SARIF document, failing the test if the structure is wrong.

newCompressionRunner returns a Runner whose template forces runCompression to issue a request, plus the message slice to feed it.

newRetryObserver builds the middleware that feeds collector. It sits inside the SDK retry loop, so it runs once per real HTTP attempt and sees neithe

normalizeLine removes leading/trailing whitespace and strips any leading '+' or '-' diff marker.

objcRuleText is the exact text a sniffed .m file must resolve to. Assert on identity rather than on wording: objc.md currently ships as a placeholder

The four blind spots share one shape: the observer sees HTTP 200, the failure surfaces afterwards, and nothing downstream would notice the omission —

partitionMessages divides messages into frozen, compress, and active zones. Frozen zone is always messages[0:2]. Active zone preserves the K most rece