← Schema index / Config Reference

files schema

Canonical generated docsThis section is generated from caco config schema --json. The table below preserves the runtime field path, type, required/default markers, and canonical description for every value in this slice.

Project file-cache size limits and image compression defaults.

Field pathTypeRequiredDefaultCanonical description
filessectionoptionalProject file-cache size limits and image compression defaults.
└ files.max_file_sizestringoptional5MBMaximum final file size accepted by caco file add (e.g. 5MB, 5MiB, 5242880).
└ files.image_handlingmapoptionalDefault image handling and compression policy for caco file add.
└ files.image_handling.default_behaviorstringoptionalpreserveDefault handling for image inputs: preserve, compress, or reject.
└ files.image_handling.auto_compressbooloptionalExplicitly enable or disable image compression before file-cache storage.
└ files.image_handling.compression_formatstringoptionaljpegOutput format when compression is active: jpeg, png, or webp.
└ files.image_handling.compression_qualityu8optional85Compression quality in the inclusive range 1..=100.
└ files.auto_syncmapoptionalDaemon-side periodic file-cache auto-sync policy.
└ files.auto_sync.enabledbooloptionalfalseEnable the daemon's periodic file-cache auto-sync so node-local/mobile uploads propagate to the mesh without a manual caco file sync. Defaults to false (opt-in).
└ files.auto_sync.interval_secsu64optional900Seconds between automatic file-cache syncs. Defaults to 900 (15 minutes); floored at a small minimum.
└ files.auto_sync.modestringoptionalbothAuto-sync mode: push, pull, or both. Defaults to both (matches caco file sync).