Check that the tools still work
health_checkRun live checks against a library's website to confirm every Stacks tool still works and report exactly what broke if the site changed. Use it when a tool returns SITE_CHANGED.
Instructions
Run live checks against a library's website to confirm every Stacks tool still works, and report exactly what broke if the site changed. Checks page landmarks (TinyFish Fetch) and the data contract of each tool using known-good queries (TinyFish Browser). Set deep to also start a TinyFish Agent that inspects a failing page and explains what changed. Takes about 20 to 40 seconds. Run this when a tool returns SITE_CHANGED.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "health_check"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deep | No | If a check fails, start an Agent run to diagnose the failing page (result via get_job_result). | |
| library | No | Library system id such as "tpl" (Toronto), "vpl" (Vancouver), "chipublib" (Chicago). Get it from find_library. A city or library name also works. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| checks | Yes | ||
| healthy | Yes | False if any check failed. | |
| library | Yes | ||
| summary | Yes | ||
| checked_at | Yes | ||
| tinyfish_calls | Yes | TinyFish calls this check made, by endpoint. | |
| diagnosis_error | Yes | Why the Agent diagnosis could not be started, if it could not. | |
| diagnosis_job_id | Yes | Pass to get_job_result for the Agent's diagnosis of the failing page. | |
| platform_version | Yes | Version of the library platform seen on the site now. | |
| verified_platform_version | Yes | Platform version these tools were last verified against. |