DisplayAddr rewrites a wildcard listen address (empty host, 0.0.0.0, or ::) to a localhost form so printed URLs are always openable in a browser. Non-

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 (stdio transport), initializes the connection, and caches the list of available tools. The context governs t

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

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.

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

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

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

captureStderr captures everything written to os.Stderr during fn. Mirrors captureStdout; used to assert structured usage emitted on the failure path.

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.

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. Patterns are res

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.

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

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

Run main() with make_poster mocked; return (rc, captured_auth_header).

savedSecretReplaceHint builds the replace hint text without leading indent.