Store a memory. Use this whenever the user shares a fact, decision, or preference worth recalling later. Prefer one clear fact per call.

verbatim=True stores the text exactly as given, skipping fact-extraction. Returns {"id", "status", "importance"} or {"error"}.

Semantic search over memories. Always call this BEFORE answering questions that depend on prior context, decisions, or user preferences.

Returns {"query", "count", "results": [{"id","content","score"}]}.

Fetch one memory by id, including its full content and metadata.

Update a memory in place (keeps version history). Use this to CORRECT a stored fact instead of remembering a contradicting copy. Pass the new content.

Delete a memory by id.

List recent memories in a collection.

Show the version history of a memory (how it changed over time, including supersessions). Useful to see what a fact used to be.

List entities in the knowledge graph (people, organizations, tools, places), optionally filtered by entity_type. Use for "who/what do I know about" questions.

Bi-temporal timeline for one entity: what facts were true about it and when. Use this for "what changed" / "what was true at time X" questions about a person, company, or thing.

Query the knowledge graph for relationships and facts. Give a natural-language query OR an entity (+ optional relation_type). Pass an ISO timestamp to ask what was true at that point in time (bi-temporal). depth = graph hops (1-5).

Surface contradicting facts in the knowledge graph (e.g. two different values for the same attribute). Pass a memory_id to check one memory, or omit to scan. Use before trusting a fact that feels ambiguous.

Ask how confident the agent should be before acting on something, grounded in stored memory and past decision outcomes. Call this before a consequential autonomous action. Returns a confidence score and a recommended action.

Record a decision the agent made and, if known, its outcome (success | failure | partial). This feeds hebbrix_confidence so future recommendations improve. Log both the choice and how it turned out.

List the collections (memory spaces / tenants) available to this API key.

Tier, usage, limits, and expiry for this agent's account. In agent mode (auto-provisioned account), relay the claim command to the human when usage status is 'warning' or worse — claiming is one command and keeps all memories.