grant
Authorize another agent to read a defined subset of memory records using exact-match selectors (scope, tag, key, or IDs), and record the authorization for audit.
Instructions
Give another agent READ access to a SUBSET of this store's memories, and record the act.
Pass EXACTLY ONE selector: scope (a memory's meta scope), tag, key (a supersession key), or ids
(explicit record ids). Membership is exact-match on a stored field -- no embedder, no similarity
threshold, no LLM -- so the set a grant authorises is the same tomorrow as it is today. There is no
query selector on purpose: a grant whose membership came from a similarity score would silently widen
after a re-embed or a corpus change.
by names the granting agent (a grant issued by an agent covers only records THAT agent owns; omit it
for an operator-wide grant). Read with recall_as(agent, ...), end it with revoke(...). Both acts
land in the write-receipt chain, so grant_log() and the audit bundle show who could read what, and
when it was withdrawn. Passing no selector is refused rather than read as "everything".
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": {
"agent": "<agent>"
},
"name": "grant"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| by | No | ||
| ids | No | ||
| key | No | ||
| tag | No | ||
| note | No | ||
| agent | Yes | ||
| scope | No |