memory_remember

Remember durable facts, decisions and preferences. Default channel scope stays in this channel. Guild scope explicitly shares within this guild. User scope is private to its owner across enabled locations. Private conversations default to user scope. Never broaden the audience of private source material.

User guide / All capabilities

Contract

Effect: write. Evidence role: discovery_only.

Save audience-scoped memory.

Parameters

This is the current provider-facing JSON Schema, generated from the runtime definition.

{
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "description": "Short label, 2–64 characters."
    },
    "value": {
      "type": "string",
      "description": "Concise fact, 2–2000 characters."
    },
    "scope": {
      "type": "string",
      "enum": [
        "channel",
        "guild",
        "user",
        "preference"
      ],
      "description": "Audience. Defaults to channel. Portable preference accepts only response_length=brief/adaptive/detailed, tone=balanced/casual/formal, or language=language code (pt, en-US). It follows this authenticated user across enabled locations without exposing source links."
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Supporting source message links or URLs."
    }
  },
  "required": [
    "key",
    "value"
  ]
}

Execution requirements

The ordinary admission and tool execution checks apply.

Expected postconditions

Inspect the returned status, summary and data; do not infer success from a tool call alone.