Tell Add
tell_addLog a newly named sound fault to a song’s append-only tell ledger, including the person’s verbatim words, source, and timestamp. Use it only when they first name a fault; handle repeats separately.
Instructions
Log a new tell: a fault the person hears in a sound and names ("boxy", "the distortion type is wrong"), in the song's tell ledger (/notes/tells.jsonl, append-only). id: short kebab-case (dist-type); what: the fault in your words; words: theirs, verbatim, 20 words or fewer; source: where they said it (a voice note id, an exam, a picture round); when: UTC ISO of when they said it (default now); where: the song, clip or window. Reach for it the first time the person names a fault in how something sounds; a repeat is tell_heard.
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": {
"project": "<project>",
"id": "<id>",
"what": "<what>"
},
"name": "tell_add"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| what | Yes | ||
| when | No | ||
| where | No | ||
| words | No | ||
| source | No | ||
| project | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |