Updates

Update behavior

aicage keeps images current by checking versions and digests at runtime and in CI.

Summary

• Base images are rebuilt in CI on a schedule or manually.
• Prebuilt agent images are rebuilt in CI when the agent version or base image changes.
• Images that must be built locally are rebuilt when the agent version or base image changes.
• Custom agents and extensions are rebuilt locally when their inputs change.

Update triggers matrix

Item	Trigger	Built on
Base image	Scheduled	CI
Custom base image	Upstream digest of from_image changes	Client
Prebuilt agent image	Agent version or base image change	CI
Build-local agent image	Agent version or base image change	Client
Custom agent image	Agent version or base image change	Client
Extension image	Extension changes or base/agent changes	Client

What triggers local rebuilds

Local rebuilds happen when any of these change:

• The agent version (from version.sh).
• The base image digest (pulled from the registry).
• The extension contents.

This is automated; you do not need to manually manage image rebuilds.