Search documents indexed via Index.add_files()/add_text() - the agent's reference knowledge base, not its own memory. Use recall instead for notes the agent itself chose to remember.

Read-only, no side effects. Results are ranked best-match-first by a hybrid of keyword and semantic similarity, not necessarily indexing order. If k exceeds how many documents exist, every document is returned rather than raising an error.

Recall notes previously saved via remember - the agent's own memory, not indexed reference documents. Use search instead for the knowledge base.

Read-only, no side effects. Results are ranked best-match-first by a hybrid of keyword and semantic similarity, not necessarily the order they were remembered. If k exceeds how many memories exist, every memory is returned rather than raising an error.

Save a new note to this agent's memory. Returns the new memory's id. Always inserts - calling this twice with the same text creates two separate memories, since this server doesn't have deduplication enabled by default.

If the server was configured with a memory cap (max_memories), the oldest unpinned memory may be evicted to make room for this one. pinned=True exempts a memory from that eviction permanently - there's no way to un-pin it later through this tool.