Function ValidateEnvelopeConversation

internal/network/validate.go:272–302

ValidateEnvelopeConversation enforces kind-specific container and work fields.

(env Envelope)

// ValidateEnvelopeConversation enforces kind-specific container and work fields.
func ValidateEnvelopeConversation(env Envelope) error {
	if env.WorkID != nil {
		if err := ValidateWorkID(*env.WorkID); err != nil {
			return err
		}
	}
	if isDiscoveryKind(env.Kind) {
		return validateDiscoveryEnvelopeOmitsConversation(env)
	}
	if !isConversationKind(env.Kind) {
		return nil
	}
	if _, err := ConversationRefFromEnvelope(env); err != nil {
		return err
	}
	switch env.Kind {
	case KindCapability:
		if env.WorkID == nil {
			return fmt.Errorf("%w: capability work_id is required", ErrMissingField)
		}
	case KindReceipt:
		if env.WorkID == nil {
			return fmt.Errorf("%w: receipt work_id is required", ErrMissingField)
		}
	case KindTrace:
		if env.WorkID == nil {
			return fmt.Errorf("%w: trace work_id is required", ErrMissingField)
		}
	}
	return nil
}

// ConversationRefFromEnvelope returns the validated container reference for a conversation envelope.
func ConversationRefFromEnvelope(env Envelope) (ConversationRef, error) {