Save, find & manage objects

A store, not invisible memory

Your store contains only objects explicitly written through its tools. It does not automatically archive conversations or build a hidden profile. An object has a stable key, kind, JSON value, labels, version, timestamps, and optional behavioral fields.

Choose the right retrieval

1. 1Know the key? Ask for that exact object: get_object returns its full saved value.
2. 2Want every note or todo? Use list_objects with kind and label filters, and follow next_cursor until null.
3. 3Looking for a topic? Use concise words likely present in the saved object. search_objects performs lexical discovery with structured filters; get_object retrieves full content.

Updates and deletion

Saving to an existing key updates that object. Ask the agent to preserve unrelated fields, inspect the current value, and use version checks where supported. Delete only a clearly identified key; deletion is not a reversible trash operation. Your agent should clarify an ambiguous request rather than guess.

The agent interprets your natural-language request. The store executes deterministic queries; it does not provide semantic or embedding-based search.