@spec assert_capability_coherence(module()) :: Jido.Chat.CapabilityMatrix.t()

Asserts that capability statuses and native callbacks are coherent.

@spec assert_capability_result(module(), atom(), term()) :: term()

Asserts the normalized result shape for a declared capability.

Use this in capability_test/3 blocks after the provider operation runs.

@spec assert_json_round_trip(struct()) :: struct()

Asserts JSON-safe serialization and revival for a typed value.

@spec assert_media(
  Jido.Chat.Media.t(),
  keyword()
) :: Jido.Chat.Media.t()

Asserts canonical media fields and returns the media value.

@spec assert_message_identifier(
  Jido.Chat.Response.t()
  | Jido.Chat.Message.t()
  | Jido.Chat.Incoming.t()
) ::
  String.t()

Asserts and returns a stable external message identifier.

@spec assert_normalized_response(term()) :: Jido.Chat.Response.t()

Asserts a normalized Jido.Chat.Response result with a message identifier.

@spec assert_unsupported_operations(module()) :: :ok

Asserts unsupported declarations are coherent without calling provider operations.

@spec assert_webhook_event(module(), Jido.Chat.WebhookRequest.t() | map(), keyword()) ::
  Jido.Chat.EventEnvelope.t()

Asserts that a webhook request becomes a typed event envelope.