Skip to content

SearchOptions

SearchOptions = Omit<FilterOptions, "where"> & object

Options for client.thing.search. Search does not support field-value where predicates in v1; use thing.query for typed structured filtering.

When about is set or resolveCollections is true, result pages may be sparse — keep paginating until nextCursor is absent.

optional about?: string

Restrict the search to assertions about this wref target.

optional mode?: "text" | "vector" | "hybrid"

Search mode: text (BM25), vector (semantic), or hybrid (combined). Defaults to text.

optional resolveCollections?: boolean

Expand collection members in the result; pages may be sparse when set.

optional excludeInfraShapes?: boolean

Exclude internal infrastructure shapes from results.

https://docs.warmhub.ai/sdk/read-semantics/#search-modes