ReqManagedAgents.Environment.Spec (ReqManagedAgents v0.10.0)

Copy Markdown View Source

Content-addressed identity of the runtime environment an agent is provisioned into — the environment mirror of ReqManagedAgents.Agent.Spec. config is provider-verbatim (opaque; the library never interprets it); runtimes is typed — the library renders it, so new/1 validates every runtime through ReqManagedAgents.Provisioner.Runtime.new/1 before it can reach the bootstrap renderer.

new/1 routes any top-level key that isn't :name or :runtimes into config — a flat map like %{runtimes: [...], networking: %{...}, type: "cloud"} is coerced with config: %{networking: %{...}, type: "cloud"}, so provider fields at the top level are never silently dropped. An explicit :config key wins on collision with a same-named stray key.

digest/1 folds this identity into the provision content-address at both hashing layers (the Provisioner cache key and the Bedrock harness name), so two provisions of the same Agent.Spec into different environments no longer collide. name is excluded from the digest (it is the base, not the identity), exactly as in Agent.Spec.digest/1.

Summary

Types

t()

Functions

digest(spec)

Deterministic content-address over the environment's identity fields ({runtimes, config}, name excluded), using the same Provisioner.hash/1 helper as the rest of the provisioner. This is what makes an environment content-addressable at both provisioning layers.

new(spec)

Coerce a map, an existing %Spec{}, or nil into a validated environment spec.

Types

t()

@type t() :: %ReqManagedAgents.Environment.Spec{
  config: map(),
  name: String.t() | nil,
  runtimes: [ReqManagedAgents.Provisioner.Runtime.t()]
}

Functions

digest(spec)

@spec digest(t()) :: String.t()

Deterministic content-address over the environment's identity fields ({runtimes, config}, name excluded), using the same Provisioner.hash/1 helper as the rest of the provisioner. This is what makes an environment content-addressable at both provisioning layers.

new(spec)

@spec new(t() | map() | nil) :: {:ok, t() | nil} | {:error, :invalid_environment_spec}

Coerce a map, an existing %Spec{}, or nil into a validated environment spec.

nil means "no environment" and is valid ({:ok, nil}). A map or struct has each runtime validated/coerced via Runtime.new/1; any invalid runtime fails the whole coercion with {:error, :invalid_environment_spec}, so no unvalidated runtime can reach the bootstrap renderer. Both atom- and string-keyed maps are accepted (mirroring Agent.Spec.new/1's tolerance).