upgrade_kiln
Update the Kiln package to the latest version after user confirmation. Defers update if a print is active to avoid interruption.
Instructions
Update the Kiln package to the latest version — for the user.
The Apple-grade upgrade path. When a newer Kiln is available (or a
hosted call returns an upgrade-required signal), OFFER to handle it:
ask "want me to update Kiln for you now?" and call this with
confirm=True once they agree. Don't make the user run a pip command.
AGENT CONTRACT (important):
* NEVER call this while a print is active — wait until it finishes.
Swapping Kiln mid-print is unsafe.
* Confirm with the user first; this changes their installed
software. Pass confirm=True only after they say yes.
* On success the new version is on disk but the running Kiln still
has the old code loaded — relay the restart instruction from the
result so the user applies it at a safe moment (not mid-print).
Args:
confirm: Set True to actually perform the update. Called without
it, this returns the offer to show the user and changes
nothing.
force: Override the mid-print safety defer — only when the user
explicitly insists.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | ||
| confirm | No |