auto_recover
Recover a failed 3D print through a guided workflow: inspect the failure, propose recovery actions, and run only after confirming the returned action digest.
Instructions
Recover a failed print in one guided operation.
Needs Kiln Pro.
This tool may ask this computer to act on your printer (upload, start, pause, resume, set a speed preset). It first answers with the actions it wants and why, and runs nothing; call it again with run_actions set to the actions_digest it answered with to carry out exactly those actions through Kiln's own tools here, with every check those tools make.
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": {
"printer_name": "<printer_name>"
},
"name": "auto_recover"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_info | No | Current job metadata; ``material`` sets how a resume file is built. A path in it is not opened. | |
| telemetry | No | What you know about the print now, beside the reading the computer takes (``spaghetti_detected``, ``filament_detected``, ...). Where the two name the same thing and differ, the reading wins and the difference is said. | |
| failure_id | No | Not read: each call judges a fresh reading. A call that passes one is told so. Default: "". | |
| gcode_path | No | The sliced file that is printing: what a resume file is built from (a paused print resumed where it stopped) or what is started on another printer when ``retry_mode`` moves the job. Through Kiln's servers it is sent with the call. Default: "". | |
| retry_mode | No | ``"off"`` (default) | ``"same_bed"`` | ``"fleet"`` | ``"auto"`` (``"auto"`` tries the same bed first, then another of your printers). Moving the job to another printer needs the fleet plan; the refusal names it. Default: "off". | |
| run_actions | No | Leave empty on the first call: the tool answers with the actions it wants and an actions_digest, and runs nothing. Call again with that digest here to carry out exactly those actions. Default: "". | |
| auto_confirm | No | Does nothing: an action runs only when ``run_actions`` hands back the digest of the list shown. Kept so older calls still parse. Default: true. | |
| printer_name | Yes | Printer to recover on, as the computer attached to it names it. | |
| printer_type | No | Backend hint (``"bambu"``, ``"moonraker"``, ``"octoprint"``, ...) for skip capability. Default: "". | |
| part_attached | No | Your word on whether the half-printed part is still stuck to the plate (``true``) or gone (``false``), when no picture settles it. Omitted, the answer asks once before a resume is offered. | |
| plate_objects | No | The ``objects`` list from ``list_plate_objects`` (each with ``label_id``, ``name``, ``bbox``, ``area_mm2``), for the skip-failed-objects path. Without it, a ``.gcode.3mf`` passed as ``gcode_path`` is read for them (``job_info["plate_number"]`` picks the plate). | |
| snapshot_path | No | A picture of the print now (from ``printer_snapshot``), judged with ``vision_strictness``. Without one the answer says the verdict was reached without looking. Default: "". | |
| failed_objects | No | Which plate object(s) failed, by ``label_id`` or name (same matching as ``plan_object_skip``). Used only when ``allow_skip_failed_objects`` is True. | |
| telemetry_history | No | Earlier readings (each answer's ``observation``), for trend-based detection. | |
| vision_strictness | No | ``"advisory"`` (default) | ``"strict"``. Advisory reports what a brought picture shows without stopping on it; strict pauses on a sharp change. Default: "advisory". | |
| try_untested_resume | No | Opt this printer in to a Kiln-built resume on a model Kiln has not yet seen one work on. Defaults to ``False``, which leaves the resume unoffered there. Default: false. | |
| alternative_printers | No | Narrows which of your other printers may take the job when ``retry_mode`` moves it; those printers are read on the computer attached to them. | |
| monitoring_interval_s | No | Seconds until the next reading is worth taking (``next_check_s``). Default 30s. Default: 30.0. | |
| monitoring_max_wall_s | No | Not read: each call is one reading, and how long to keep polling is yours to decide. Kept so older calls still parse. Default: 600.0. | |
| baseline_snapshot_path | No | An earlier picture of the same print, so ``snapshot_path`` can show a change. Default: "". | |
| allow_skip_failed_objects | No | Off by default. When True and the plate localizes to specific failed object(s) on a printer with known skip capability, proposes skipping just those objects instead of the standard abort/retry path. Default: false. |