execute_composition
Commit a proposed composition: drives the DAG through the workflow engine, each step records a reputation outcome, the composition's reputation is finalized when the run ends. When PCC_COMPOSE_EXECUTE_REAL=true is set on the gateway, steps submit real jobs via JobFacade and the workflow run is durable (@pcc/workflow). When the flag is off, the NOOP runner returns synthetic success — useful in dev/test. Re-executing an already-run composition replays the stored result (idempotent — reputation deltas are applied exactly once).
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>"
},
"name": "execute_composition"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Composition id from propose_composition. Must be in `proposed` status and not expired. | |
| idempotencyKey | No | Optional string, 1-120 characters. The gateway validates it but doesn't use it. |