wrapByRunes splits text into lines that fit within maxWidth **rune** columns. Respects existing newlines and wraps at word boundaries.

wrapSingleRuneLine breaks one paragraph (no newlines) into rune-width-constrained lines.

ApplyLanguage injects a language directive into all system-role messages of the scan template (MAIN_TASK, PLAN_TASK if set, DEDUP_TASK if set, and MEM

CollectPendingComments awaits any async comment-processing workers and returns the aggregated comments from the collector. Safe to call once per sessi

ExcludedDirs is the list of directory prefixes that scanners and diff providers should always skip. Exposed so internal/scan and other consumers can r

FilesReviewed returns the number of items included in this scan.

IsAllowedExt returns true when the given file extension is in the supported types list. The check is case-insensitive.

IsCommitMode returns true when analyzing a single commit.

IsExcludedPath returns true when the given file path matches any default exclude pattern. Patterns support ** (recursive directory matching), * (singl

IsRangeMode returns true when comparing two refs.

LoadSummary loads a single session's Summary. Errors when the session file is missing or unreadable.

MatchGitignorePattern reports whether relPath matches a single gitignore-style pattern, using the simplified semantics that diff.Provider already impl

Session returns the session history associated with this Agent.

Session returns the session history associated with this Agent.

SessionID returns the current scan's session id, or "" when no session has been created.

SessionsDir returns the on-disk directory that holds JSONL session files for a given repository. It does not create the directory.

ToolCalls returns a snapshot of the per-tool call counts.

TotalCacheReadTokens returns the accumulated cache read tokens.

TotalCacheWriteTokens returns the accumulated cache write tokens.

TotalTokensUsed returns input + output.

Validate checks that a ScanTemplate has the minimum fields populated.

Warnings returns a copy of the accumulated warnings.

WriteLLMError writes an llm_error entry recording a failed LLM request.

WriteLLMRequest writes a request entry with the resolved messages.

WriteLLMResponse writes a response entry with model, content, tool calls, usage.

WriteReviewItemDone writes a file-level resume checkpoint for a completed diff.

WriteReviewItemFailed writes a file-level checkpoint for a failed diff.

WriteReviewItemReused writes a checkpoint reused from a previous session.

WriteSessionEnd writes the final session_end summary record and closes the file.

WriteToolCall writes a tool call result entry.

Build an `origin/<branch>` ref from a CODEUP_*_BRANCH env var, if set.

Normalize the top-level shape of ocr's JSON output to a list of comments.

Walk a hunk's lines tracking both counters until reaching new_line.

Safely parse a rate-limit response header as an int.

batchKeyFunc returns the grouping key extractor for a strategy.

构造评论挂载用的 diff 两侧 URI 与挂载 ref。

buildFileFilter picks the highest-priority layer that has any include/exclude configured. Priority order: custom (--rule) > project > global.

buildOpenAIParams converts the shared ChatRequest into OpenAI SDK parameters.

Build the config dict from environment variables (with defaults). ``env`` is typically ``os.environ``; tests pass a plain dict.

Join base URL (context path kept, trailing slash tolerated) and route.

Map `ocr review --format json` output to one Gerrit ReviewInput dict.

computeActiveZoneSize returns how many trailing rounds fit within the remaining token budget after accounting for the frozen zone and the compressed s

---- Internal helpers ----

copyMessages returns a deep copy of a messages slice so that future mutations don't corrupt stored records.

copyMessagesForJSON produces a JSON-friendly slice for persistence.

Derive the Gerrit base URL from a change URL. Modern URLs ({base}/c/{project}/+/{number}) split at "/c/", which keeps any context path; legac