LoadResumeState replays a previous session JSONL into a fingerprint index.

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

PrintTraceSummary prints a one-line summary of the review to stdout.

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

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

RecordWarning adds a non-fatal warning.

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

Submit runs f in a background goroutine bounded by the semaphore. When f completes its return value is collected internally.

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

TotalInputTokens returns the accumulated input/prompt tokens from all LLM calls.

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

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

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

dispatchSubtasks groups items into batches per the configured strategy, then processes batches sequentially while running files within each batch conc

executeSubtask runs the scan pipeline for one file: 1. Optional PLAN_TASK: produce a JSON checklist of focus areas. 2. MAIN_TASK: review the file with

filterLargeDiffs drops diffs whose diff content alone consumes more than 80% of MaxTokens.

filterLargeScans drops items whose content exceeds 80% of MaxTokens.

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".

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

normalizeLine removes leading/trailing whitespace and strips any leading '+' or '-' diff marker (mirrors Java's processTargetLineCode).

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

peekSession reads only the first and last record of a JSONL file.

resolveRepoDir resolves the repo dir for `ocr rules check`. It delegates to resolveWorkingDir(requireGit=true) so it anchors at the git top-level just

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

validateTimeoutSec converts a config-file timeout (in seconds) to time.Duration. Returns 0 for zero input (use default). Rejects negative values and o

CallTool invokes a tool on the MCP server and returns the text result.

CompletionsWithCtx sends a Responses API request and maps the result back to the shared ChatResponse shape.

ComputeLineDiff returns a line-level diff between oldLines and newLines. Uses Myers-style LCS to find common subsequences, then emits context/added/de

ContentLogging returns true when content logging is enabled via OCR_CONTENT_LOGGING.

Get returns the diff text for path.

ListSessions returns lightweight summaries for all sessions in a repo subdir.

ListSessions enumerates all persisted sessions for the given repository directory, sorted by StartTime descending (most recent first). Missing directo

NewClient starts an MCP server subprocess, initializes the connection, and caches the list of available tools. The context governs the initialization

NewToolCallMessage creates an assistant message with text content and tool invocations.

Of returns a checkpoint with data.

PrintToolCallStarted prints a line when a tool begins execution. Args are summarized as key-value pairs (path, search terms, etc.). Example: [ocr] ▶

RemoveByPathAndIndices removes comments for a given path whose per-path index (0-based position among all comments with that path) is in the indices s

Resolve returns the rule text for a given file path. Patterns with brace expansion like "*.{go,py}" are expanded into "*.go", "*.py". The first match

ResolveConfig builds the final Config by merging defaults, JSON config, and env vars. Precedence: defaults < config.json < environment variables.

SessionFilePath returns the JSONL path for a persisted session.

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

StringVarP registers --name with optional short form -s.

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.

TraceIDFromContext returns the hex-encoded trace ID of the span carried by ctx, or "" if ctx carries no valid span (e.g. telemetry is disabled).

ValidateOptions verifies that the requested review range matches the prior session.