Keep a shared memory
memory_addKeep a short fact about the user in their RelayLink shared memory, so every assistant they connect has it. whoami's Preferences line says how this account keeps memory. 'Kept only when asked' means call this only when the user asks you to remember something, with userAsked: true. 'Kept as you work' means you may also call it when you decide to remember something durable about them in your own memory: how they like to be worked with, what they are working on, a standing fact about them. Tell the user something is saved only after this answers 'Saved to RelayLink memory' or 'Saved to RelayLink memory already' — the second means the same fact was already there and is kept, so say so rather than claiming a new save; if it answers anything else, say it was not saved. One fact, in a sentence or a short paragraph, at most 1,000 characters, refused rather than trimmed if it is longer. When a fact you already have here turns out to be wrong or has changed, pass its id as replaces so the old one goes rather than leaving two that contradict each other. Do NOT add a memory because you have just read one — reading it on whoami or in memory_search and using it is not a new observation, and mirroring it back is how two assistants fill this store with copies of each other. Do not keep anything the user says is private, temporary, project-specific, or only for this assistant; a preference tied to a project or with an end date is notebook_save's, and so is anything they are writing down rather than being. Never store a password, key, token or recovery code. This is the user's own record: it never reaches a contact and is never written into a package. ERROR: plan_limit_reached means this was NOT saved, the account being at its memory capacity — relay the count and the options in full; never shorten or evict other memories to make room.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"text": "<text>"
},
"name": "memory_add"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | The fact, in a sentence or a short paragraph, at most 1,000 characters. | |
| source | No | user_said if the user stated this in their own message to you; assistant_noted (the default) if you worked it out. | |
| replaces | No | The id of a memory this corrects, from whoami or memory_search. The old one is removed in the same write. | |
| userAsked | No | true only if the user asked you, in their own message, to remember or save this. Required when the account keeps shared memory only when asked. |