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.

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

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

executePlanPhase runs the plan task for a single file, sending template messages with resolved placeholders and collecting the LLM response as plan gu

executeToolCall dispatches a single tool call from the LLM response and records the result in session history. code_comment handling includes optional

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

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

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

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

loadCommonContext validates the working directory, loads the embedded template, raises MaxToolRequestTimes when maxTools exceeds the default, resolves

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

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

parseOTLPEndpoint strips a http:// or https:// scheme from the endpoint and reports whether the connection should be plaintext (insecure). Scheme matc

printWizardCancelled prints the standard Esc-cancel message for config wizards. changesDescription is a short noun phrase, e.g. "Configuration changes

recordWarning adds a non-fatal warning to the agent's warning list.

reloadConfigAfterSaveFailure reloads on-disk config and refreshes derived provider TUI state so the UI matches persisted data after a failed save. Ret

reloadConfigAfterSaveFailure reloads on-disk config so in-memory state matches persisted data after a failed save. Returns false when reload could not

resolveAllowedHostsFromEnv reads the OCR_VIEWER_ALLOWED_HOSTS environment variable and combines it with the bind host to produce the active allowlist.

resolveConfigPath returns OCR_CONFIG_PATH when set, otherwise the default user config path. Intentionally used only by read-only commands (e.g. ocr ll

resolveLang returns the resolved language name for the instruction.

savedSecretReplaceHint builds the replace hint text without leading indent.

scanLines reads from r line by line, collecting at most maxLines lines starting from startLine (1-based), while counting the total number of lines. Th

shouldReview applies the filter algorithm via whyExcluded.

shouldSkipFile returns true if a git ls-files output path should be skipped. Keeps only widely useful files (those with recognizable extensions).

splitAndNormalize splits code text into lines and normalizes each one.

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

stripEmptyPlanBlock removes the "### Review Plan …\n{{plan_guidance}}\n\n" wrapper from a MAIN_TASK user message when the plan phase produced no guida

stripThinkTags removes reasoning wrapper tags from content.

triggerAsyncCompression kicks off a background compression job for the conversation owning st. A no-op when a job is already pending — the check-and-s

等待至少一个仓库就绪（git 扩展异步扫描，首次可能为空）。

whyExcluded mirrors agent.whyExcluded but for ScanItem inputs.

writeGarbageExternalDiff writes a shell script that emits non-diff output and returns its path. When git invokes it via GIT_EXTERNAL_DIFF / diff.exter

AddToolResult appends a tool call result to this task record and writes a tool_call record to the JSONL stream.

ApplyLanguage injects a language directive into all system-role messages of this conversation.

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

BuildToolDefs converts toolsconfig.ToolConfigEntry slice into []llm.ToolDef, filtering by phase (planOnly=true for plan_task, false for main_task).

Complete returns a checkpoint signaling task completion.

EndSpan ends the span and records error status if present.

Eventf is like Event but includes a message attribute.

FormatDuration returns a human-readable duration string for console output.

GroupRules groups the given file paths by their resolved rule content. Files are placed in the same group only when their source, matched pattern, and

HomeConfigPath returns the default path to ~/.opencodereview/config.json.

initEmbeddedLoader configures tiktoken to use embedded BPE data instead of fetching from network. Call this once during application startup, before an

IsKnown reports whether the tool is not UNKNOWN.

LLMFailures returns the total number of LLM request failures recorded during this session.