Register, store, and watch typed configuration values for the engine.
iiiverifiedexact versions are immutable; binary and bundle artifacts are digest-pinned.
Read a configuration by id. Expands ${VAR:default} placeholders against the live process env unless raw=true is passed.
When `true`, return the stored value verbatim (including `${VAR}` placeholders). When `false` (default), expand `${VAR:default}` against the live process env.
List every registered configuration with id, name, description, and schema. Sorted by id; never returns the stored value.
Register a configuration id with a name, description, and JSON Schema. Idempotent — re-registering replaces metadata and (when initial_value is provided) the value. Validates initial_value against the schema.
Description shown in `configuration::list`.
Configuration id. Must match `[a-z0-9_-]{1,64}` so it is safe as a filename in the `fs` adapter.
Optional initial value to install. Validated against `schema`.
Optional opaque metadata stored alongside the entry.
Human-readable name shown in `configuration::list`.
JSON Schema describing the value shape. `set` validates against this.
One-line description of what this configuration controls.
Stable identifier (e.g. `iii-stream`, `iii-observability`).
Optional caller-supplied metadata (owner team, change ticket, etc.).
Human-readable display name.
JSON Schema describing the shape of `value`.
Stored configuration body. May contain `${VAR:default}` placeholders.
Retrieve the schema, name, and description for a configuration id. Mirrors a single entry from configuration::list.
Replace the value of an already-registered configuration. Validates the value against the registered JSON Schema and emits a configuration:updated event.
New configuration value. Validated against the registered schema.
Current stored value (templates not expanded).
Previous stored value, or `null` when the entry had no value yet.