resume_interrupted_print
Destructive
Resume an interrupted FDM print by planning recovery actions first, then executing them after a digest confirmation.
Instructions
Resume an interrupted print with one call on any supported FDM printer (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": {
"original_gcode_path": "<original_gcode_path>"
},
"name": "resume_interrupted_print"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| layer | No | The layer to resume FROM. Default 0 → auto-resolve from ``printer_status.job.current_layer``. Pass explicitly if the printer was power-cycled and current_layer is stale. Default: 0. | |
| use_ams | No | Bambu-only. Tri-state routing for the resumed print's filament source (``"auto"`` / ``"true"`` / ``"false"``). Default ``"auto"`` — inspects the current AMS state and picks the tray that's actively loaded (``tray_now``); falls back to external spool when nothing is loaded. Ignored on non-Bambu adapters. Pass ``"false"`` to feed from the external spool regardless of AMS state. Default: "auto". | |
| ams_mapping | No | Bambu-only. Explicit AMS slot mapping per extruder (e.g. ``[2]`` = pull from tray 2). Default ``None`` — lets ``start_print`` auto-resolve from AMS state or 3MF plate metadata. Ignored on non-Bambu adapters. | |
| 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: "". | |
| printer_name | No | Which printer. Default empty → active printer. Default: "". | |
| material_type | No | Sets the overlap layers in the resume file Kiln builds. Default ``"PLA"``. Default: "PLA". | |
| target_ams_slot | No | Optional 0-indexed AMS slot to force for a material-changing resume. When supplied, Kiln emits the same slot into the resume preamble and the ``start_print`` call. Default: -1. | |
| require_ams_match | No | True (the default) refuses the resume when AMS status cannot prove the requested filament route; False proceeds on the caller's word. Default: true. | |
| prime_extrusion_mm | No | Extruder purge length in mm at the safe Z-lift position, default 5.0. It re-pressurizes the hotend after the cancel-to-start transition, which would otherwise leave the extruder retracted and printing air. Set lower only when the melt is known intact; set 0 only when you have primed another way. Default: 5.0. | |
| original_gcode_path | Yes | Path to the ORIGINAL (pre-pause) PrusaSlicer gcode. Required — kiln can't infer this from the printer's reported filename alone because Bambu only exposes the 3MF name (the source gcode may live in a slicer profile temp dir the agent knows and the printer doesn't). | |
| target_filament_type | No | Optional expected tray material. Without ``target_ams_slot``, Kiln resolves exactly one matching loaded tray from AMS status or fails closed. Default: "". | |
| target_filament_color | No | Optional expected tray color (hex or common name). Used with the same hard verification as ``target_filament_type``. Default: "". | |
| manual_material_change_confirmed | No | Non-Bambu safety gate for requested material/color changes. Set True only after a human/operator has loaded the target material into the active feed path; otherwise Kiln refuses before canceling or uploading anything. Default: false. |