Helper function: expand tabs

parseRipgrepJSONOutput parses `rg --json` output format. Each line is a JSON object; we only extract entries with type=="match". This correctly handle

safeResolvePath safely resolves path

setMessageThoughtSignature stores the thought signature in the Message's Extra field. This is used for non-functionCall responses where the signature

Validate path and command combination

BuildSearchOption creates a SearchOption for ANN search with the configured metric type.

MultiModalRead reads file content with multimodal support for images and PDFs. For non-image/non-PDF files, it delegates to the standard Read method.

NewHNSWIndexBuilder creates a new HNSWIndexBuilder with default parameters. Default: M=16, EfConstruction=200

NewIVFPQIndexBuilder creates a new IVFPQIndexBuilder with default parameters. Default: NList=128, M=16, NBits=8

NewLangsmithHandler creates a new CallbackHandler

NewRetriever creates a new Milvus2 retriever with the provided configuration. It returns an error if the configuration is invalid.

NewSparse creates a new Sparse search mode.

Retrieve 根据查询文本检索相关文档

SetContentBlockCacheControl sets a cache control on a content block. When a manual control is set, the top-level auto-cache will not override it.

SetMessageCacheControl sets a cache breakpoint on the message with the given cache control settings. A nil CacheControl or zero-value TTL means the SD

SetTrace 将 trace 选项设置到 context 中

Store stores the documents into the indexer.

WithEfConstruction sets the search width during index building.

WithExpiration returns an [Option] that sets the expiration duration for cached embeddings in the [Embedder].

WithSessionName 设置 Langsmith 的项目名称

decodeBase64Data decodes a base64 data URL string into raw bytes. It correctly handles the "data:[<mediatype>];base64," prefix.

genInputAndConf generates input messages and configuration for Gemini API

--- Capability-missing gates --- newBackendNoShell builds a Backend with no shell wired so we can assert that the terminal-backed tools surface ErrCap