complete_print_recovery
Finalize a print recovery session by recording success or failure. When recovery fails and alternative printers are provided, the response includes a reroute recommendation based on progress and printer status.
Instructions
Mark a recovery session as completed.
On failure (success=False) AND when ``alternative_printers``
is supplied AND kiln-pro is installed, the response carries
a ``reroute_recommendation`` block — the rerouter's seven-rule
verdict on whether the failed job should move to one of the
alternatives. Recommendation only; the agent must run the
actual reroute via ``submit_job`` / ``start_print``.
Args:
session_id: The session_id to complete.
success: Whether the recovery was ultimately successful.
notes: Final notes about the recovery outcome.
alternative_printers: Optional fleet of alternative
printer dicts (each with ``printer_id`` plus optional
``is_idle``, ``supported_materials``,
``build_volume_mm``, ``success_rate``). When
supplied alongside ``success=False``, the response
will include a ``reroute_recommendation`` from the
pro rerouter (patent KILN-003 claim 5). Single-printer
setups can omit this.
completion_pct_at_failure: How far the failed print got
(0.0–1.0). Below 10% the rerouter prefers
same-device restart over reroute. Defaults to 0
(treated as low progress).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | ||
| success | Yes | ||
| session_id | Yes | ||
| alternative_printers | No | ||
| completion_pct_at_failure | No |