lb_search

Searches all nodes in your knowledge graph. Supports three search modes and optional filters for PARA scope and tags.

Parameters

Parameter	Type	Required	Default	Description
query	string	Yes	—	The search query
mode	string	No	—	Search mode: keyword, semantic, or hybrid. Defaults to hybrid at the service layer if omitted.
para_item_id	string	No	—	Restrict results to nodes tagged with this PARA item
tags	string[]	No	—	Restrict results to nodes with all specified tags
limit	number	No	20	Number of results to return (1–100)

Response

{
  "nodes": [...],
  "has_more": false
}

Each node in the array includes the node ID, title, summary, tags, and relevance metadata.

Search modes

Mode	Description
keyword	Full-text search using SQLite FTS5. Exact and prefix matches. Fast.
semantic	Vector similarity search using embeddings. Finds conceptually related content even without keyword overlap.
hybrid	Combines keyword and semantic results using Reciprocal Rank Fusion (RRF). Best overall recall. Default.

Filter behavior

Filter enforcement varies by mode:

• keyword mode — para_item_id and tags filters are applied strictly at the database level. Only nodes matching all filters are returned.
• semantic and hybrid modes — filters are best-effort. The vector index does not support hard filtering, so results are filtered post-retrieval. Fewer results than limit may be returned even when more matching nodes exist.

When precise filter enforcement is required, use keyword mode.