List Clarity Step Frames
listClarityStepFramesReturn one representative screenshare frame for each current-process step. Explicit frame evidence wins. Otherwise, a timestamped screenshare transcript source selects the closest persisted frame at or after that timestamp, with the closest earlier frame as fallback. Pass window (1-5) to also receive that many neighbouring frames on each side as candidates, for recovering when the selected frame does not show the step. Pass size=thumb for 768px copies that are cheaper to download and inspect. Signed URLs are short-lived and can be null when signing is unavailable.
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": {
"process_id": "<process_id>",
"snapshot_id": "<snapshot_id>"
},
"name": "listClarityStepFrames"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | full: the persisted screenshot (1920px wide). thumb: a 768px-wide copy, cheaper to download and to inspect visually; use it to check whether a frame shows the step, then fetch full for the document. | full |
| window | No | Number of neighbouring persisted frames to return on each side of the selected frame as `candidates` (0-5, default 0). Use to recover when the selected frame does not show the step. | |
| step_ids | No | Optional comma-separated step ids to resolve, for example `task-a,task-b` (maximum 100). Omit to resolve every step. | |
| process_id | Yes | The clarity process id | |
| snapshot_id | Yes | The current-process snapshot id |