@type t() :: %Synaptic.Voice.Capability{
  confirmation: :policy | :always | :never,
  description: String.t(),
  examples: [String.t()],
  executor: :direct | :workflow,
  handler: nil | function(),
  limitations: [String.t()],
  metadata: map(),
  name: String.t(),
  parameters: map(),
  required_scopes: [String.t() | atom()],
  risk: atom()
}