Cache Runs
cache_runsCache runs to disk by fetching with optional filters for repeatable access.
Instructions
Fetch and cache runs to disk with optional filters for efficient repeated access.
Args:
runType (enum, optional): Filter by 'deploy' or 'refresh'
runStatus (enum, optional): Filter by 'completed' | 'failed' | 'canceled' | 'running' | 'waitingToRun'
environmentID (string, optional): Filter by environment ID
detail (boolean, optional): Fetch expanded run details. Defaults to false
pageSize (number, optional): API page size for collection. Defaults to 250, max 500
orderBy (string, optional): Sort field for paginated collection. Defaults to id
orderByDirection ('asc'|'desc', optional): Sort direction
Returns: Cache metadata with resourceUri (coalesce://cache/...) for accessing the cached data via MCP resource read.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| detail | No | When true, fetches expanded run details. Defaults to false. | |
| orderBy | No | Optional sort field used for paginated collection. Defaults to id. | |
| runType | No | Optional run type filter | |
| pageSize | No | Optional API page size used while collecting the full snapshot. Defaults to 250. | |
| runStatus | No | Optional run status filter | |
| environmentID | No | Optional environment ID filter | |
| orderByDirection | No | Optional sort direction used for paginated collection. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| detail | No | ||
| fileUri | No | ||
| message | No | ||
| metaUri | No | ||
| orderBy | No | ||
| runType | No | ||
| cachedAt | No | ||
| pageSize | No | ||
| toolName | No | ||
| pageCount | No | ||
| runStatus | No | ||
| sizeBytes | No | ||
| totalRuns | No | ||
| autoCached | No | ||
| totalNodes | No | ||
| totalUsers | No | ||
| resourceUri | No | ||
| workspaceID | No | ||
| environmentID | No | ||
| maxInlineBytes | No | ||
| orderByDirection | No |