budgetAgentTestTemplate returns a minimal template sufficient to drive dispatchSubtasks without plan/dedup/summary phases.

buildOpenAIParams converts the shared ChatRequest into OpenAI SDK parameters.

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

cloned returns a copy of the manifest whose coverage slices are owned copies, so every Finalize caller gets an independent, non-aliased snapshot. The

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.

emptySHA256 is the canonical digest of an empty input, which hashFields must return for an empty field sequence.

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

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

initOTLPHTTPProviders sets up OTLP HTTP exporters for traces and metrics. Unlike the gRPC path this uses WithEndpointURL rather than WithEndpoint, so

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

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

makeBudgetDiffs returns n small, non-deleted diffs that survive filterDiffs and filterLargeDiffs.

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

mergeBase computes the merge-base for range mode. Returns "" for other modes.

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

readJSONLLines visits each physical JSONL record without bufio.Scanner's fixed token ceiling. session_end embeds the complete run manifest and can leg

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.

ruleConfigSHA256 is the deterministic identity of the resolved rule configuration this run operates with: the resolver's effective rule-text layers (c

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.