adk_config_registry (erlang_adk v0.10.0)
View SourceImmutable, operator-owned registry for trusted agent configuration.
Untrusted agent files carry only binary IDs. The corresponding provider, MCP, OpenAPI, tool-pack, credential-profile, runtime-policy, workflow, and agent-template descriptors live in this registry and may therefore contain opaque runtime handles which must never be decoded from model or user input.
replace/2 creates a new generation. A snapshot obtained before the replacement remains immutable and continues resolving the old generation, so one config compilation can never observe a mixed catalog.
Summary
Functions
Return content-free catalog metadata suitable for diagnostics.
Resolve a bounded list of trusted IDs after authenticating the immutable snapshot once. This is the bulk boundary used by declarative configuration so N references never trigger N full registry/HMAC scans.
Types
-type kind() ::
provider | mcp | openapi | tool_pack | credential | runtime_policy | workflow | agent_template.
-type registry() :: {adk_config_registry, 1, pos_integer(), binary(), binary(), binary(), snapshot()}.
-opaque snapshot()
Functions
Return content-free catalog metadata suitable for diagnostics.
-spec generation(registry() | snapshot()) -> {ok, pos_integer()} | {error, invalid_config_registry}.
-spec kinds() -> [kind()].
-spec lookup_many(registry() | snapshot(), [{kind(), binary()}]) -> {ok, [term()]} | {error, term()}.
Resolve a bounded list of trusted IDs after authenticating the immutable snapshot once. This is the bulk boundary used by declarative configuration so N references never trigger N full registry/HMAC scans.
-spec new() -> {ok, registry()}.