Apply mutations
mutateApply field mutations to a model and run the reactive pipeline (derivations recompute, constraints enforce, effects dispatch). 'mutations' is a flat map keyed by canonical JSON Path address, e.g. {"$.order.qty": 3}. A ROLLBACK constraint violation returns isError with the structured list of violated constraints. Returns the actionable summary (derivedUpdated / flaggedConstraints / dispatchedEffects); pass includeTraces:true for the full derivation/constraint trace (the same payload 'explain' serves — omit it and call explain only when a value looks wrong).
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": {
"id": "<id>",
"mutations": "<mutations>"
},
"name": "mutate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The model id. | |
| mutations | Yes | Map of canonical JSON Path address to new value, e.g. {"$.order.qty": 3, "$.order.discount": 0.1}. | |
| includeTraces | No | Include the full derivation/constraint trace in the result (default false). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| traces | No | Full derivation/constraint traces (only when includeTraces:true). | |
| success | No | True when the mutation committed. | |
| metaUpdated | No | Meta paths recomputed. | |
| mutatedPaths | No | Base paths written. | |
| derivedUpdated | No | Derived paths recomputed. | |
| dispatchedEffects | No | Ids of effects dispatched. | |
| flaggedConstraints | No | Ids of FLAG-policy constraints that fired. |