| name | discover-notes |
| type | primitive |
| description | Global embedding-based search across all Notes; returns a Collection of matches |
Discover-Notes
INPUT CONTRACT
query (required): Natural-language search stringout (required): $variable for the resulting Collectionlimit (optional, default 5): Max number of Notes returned (top-K by similarity)threshold (optional, default 0.3): Minimum cosine similarity for a match
REQUIREMENTS:
query and out must be provided
BEHAVIOR
Runs an embedding-based search over every Note in the current infospace and returns the top-limit Notes above threshold as a Collection. Each hit is wrapped in a structured search-result Note (same shape as search-web / semantic-scholar results). An empty-case (no matches) still returns success with an empty Collection.
limit is a hard top-K cap. There is no way to express "all matches above threshold" — if you need higher recall (e.g. the goal says "all existing Notes that X"), pass an explicit larger limit (50+ is reasonable for a few-hundred-Note infospace). With the default of 5 the planner cannot distinguish "exhaustive" from "undersampled".
EXAMPLES
