Save Tunc Orb data
data_writeSave new data to the user's Tunc Orb: create a named record, or append entries to a log (it is created when absent). Use it when the user asks you to save, record or hand off something, such as a note, decision, approval, result, processed-item state or resume point. Records and logs are kept until deleted. Give each record a clear name and a one-line about so it can be found again, and look the name up with data_read first so you do not create an overlapping record. create never overwrites an existing record and append only adds entries, so no record or log entry is changed or removed: change a record with data_update and remove data with data_delete. When storage is full, saving removes the user's oldest saved files first to make room and the result says how many were removed; records and logs are never removed to make room. Batch log entries. Each call sends at most 64 KiB (one value, or one batch of log entries); a record can hold up to 16 MiB, so grow a larger one with data_update patches. When a record points at a stored file, keep the file's artifact_id, not its viewer link: the id opens the file with art_read, and the link is only for people. The service handles encryption and storage; when you retry a call, send the same mutation_id so it never applies twice.
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": {
"operation": "<operation>"
},
"name": "data_write"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Exact record or log name (UTF-8, at most 512 bytes, never normalized). Required for every operation. Collections are naming conventions such as contacts/<id>. | |
| text | No | UTF-8 text payload (exact bytes are kept). create only: exactly one of value or text. | |
| about | No | One line (at most 160 characters) saying what the record or log holds, so other agents can find it. Required for create and for append when the log does not exist yet. | |
| value | No | JSON payload (any JSON value; null is a real value). create only: exactly one of value or text, at most 64 KiB. Keep records small: save a larger file as a file and keep its artifact_id here. | |
| entries | No | append only: 1-100 entries, at most 64 KiB in total. The service assigns entry IDs and order. | |
| shelf_id | No | Shelf to use (a stable ID from data_read operation=shelves). Omit to use the current default shelf, which is resolved once and pinned for this call and its retries. | |
| operation | Yes | create: new record only if the name is free (name, about, one payload). append: add entries to a log, creating it when absent (name, entries; about when creating). | |
| mutation_id | No | Optional: an ID you choose once for this change (a UUID, or a mut_ ID from an earlier result) and send again when you retry, so the change never applies twice. Omit it and the service assigns one; the result carries it for data_read operation=status. |