gpp-client 26.7.3.dev12__tar.gz → 26.9.0.dev1__tar.gz

{gpp_client-26.7.3.dev12 → gpp_client-26.9.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: gpp-client
-Version: 26.7.3.dev12
+Version: 26.9.0.dev1
 Summary: Gemini Program Platform client.
 Project-URL: Homepage, https://github.com/gemini-hlsw/gpp-client
 Project-URL: Source, https://github.com/gemini-hlsw/gpp-client

{gpp_client-26.7.3.dev12 → gpp_client-26.9.0.dev1}/src/gpp_client/generated/__init__.py

@@ -73,6 +73,8 @@ from .delete_target_by_id import (
     DeleteTargetByIdUpdateTargetsTargetsProgram,
 )
 from .enums import (
+    AltairMode,
+    AltairNdFilter,
     ArchiveDuplicationState,
     ArcType,
     AtomExecutionState,
@@ -107,6 +109,7 @@ from .enums import (
     ExecutionEventType,
     ExecutionState,
     Existence,
+    FieldLens,
     Flamingos2CustomSlitWidth,
     Flamingos2Decker,
     Flamingos2Disperser,
@@ -184,6 +187,7 @@ from .enums import (
     MosPreImaging,
     MosSlitPriority,
     ObsActiveStatus,
+    ObservationPriority,
     ObservationValidationCode,
     ObservationWorkflowState,
     Observatory,
@@ -201,6 +205,7 @@ from .enums import (
     ProgramUserRole,
     ProgramUserSupportRoleType,
     ProposalStatus,
+    ProposalSummaryGenerationState,
     ProposalSummaryStyle,
     QuasarSpectrum,
     SchedulingMode,
@@ -383,14 +388,6 @@ from .fragments import (
     GmosSouthMosDetailsExposureTimeModeTimeAndCount,
     GmosSouthMosDetailsExposureTimeModeTimeAndCountAt,
     GmosSouthMosDetailsExposureTimeModeTimeAndCountTime,
-    GnirsDetails,
-    GnirsDetailsFlamingos2Mos,
-    GnirsDetailsGmosNorthIfu,
-    GnirsDetailsGmosNorthMos,
-    GnirsDetailsGmosSouthIfu,
-    GnirsDetailsGmosSouthMos,
-    GnirsDetailsGnirsImaging,
-    GnirsDetailsGnirsSpectroscopy,
     GnirsImagingDetails,
     GnirsImagingDetailsFilters,
     GnirsImagingDetailsFiltersExposureTimeMode,
@@ -456,9 +453,14 @@ from .fragments import (
     Igrins2LongSlitDetailsExposureTimeModeTimeAndCountTime,
     Igrins2LongSlitDetailsTelluricType,
     NonsiderealTargetDetails,
+    ObservationAttachmentDetails,
+    ObservationAttachmentDetailsAttachments,
+    ObservationAttachmentDetailsAttachmentsMask,
     ObservationCore,
     ObservationCoreReference,
     ObservationDetails,
+    ObservationDetailsAttachments,
+    ObservationDetailsAttachmentsMask,
     ObservationDetailsConstraintSet,
     ObservationDetailsExecution,
     ObservationDetailsExecutionDigest,
@@ -1044,6 +1046,7 @@ from .input_types import (
     AeonMultiFacilityInput,
     AirMassRangeInput,
     AllocationInput,
+    AltairInput,
     AngleInput,
     AttachmentPropertiesInput,
     BandBrightnessIntegratedInput,
@@ -1374,6 +1377,7 @@ from .input_types import (
     WhereOrderInt,
     WhereOrderLong,
     WhereOrderObservationId,
+    WhereOrderObservationPriority,
     WhereOrderObservationWorkflowState,
     WhereOrderPosBigDecimal,
     WhereOrderPosInt,
@@ -1597,6 +1601,9 @@ __all__ = [
     "AeonMultiFacilityInput",
     "AirMassRangeInput",
     "AllocationInput",
+    "AltairInput",
+    "AltairMode",
+    "AltairNdFilter",
     "AngleInput",
     "ArcType",
     "ArchiveDuplicationState",
@@ -1744,6 +1751,7 @@ __all__ = [
     "Existence",
     "ExposureTimeModeInput",
     "FastTurnaroundInput",
+    "FieldLens",
     "Flamingos2AtomInput",
     "Flamingos2CustomMaskInput",
     "Flamingos2CustomSlitWidth",
@@ -2418,14 +2426,6 @@ __all__ = [
     "GnirsCamera",
     "GnirsCentralWavelengthConfigInput",
     "GnirsDecker",
-    "GnirsDetails",
-    "GnirsDetailsFlamingos2Mos",
-    "GnirsDetailsGmosNorthIfu",
-    "GnirsDetailsGmosNorthMos",
-    "GnirsDetailsGmosSouthIfu",
-    "GnirsDetailsGmosSouthMos",
-    "GnirsDetailsGnirsImaging",
-    "GnirsDetailsGnirsSpectroscopy",
     "GnirsDynamicInput",
     "GnirsFilter",
     "GnirsFpuIfu",
@@ -2565,9 +2565,14 @@ __all__ = [
     "ObsCalculationUpdateObscalcUpdateValueExecutionVisitsMatchesObservation",
     "ObsStatus",
     "ObscalcUpdateInput",
+    "ObservationAttachmentDetails",
+    "ObservationAttachmentDetailsAttachments",
+    "ObservationAttachmentDetailsAttachmentsMask",
     "ObservationCore",
     "ObservationCoreReference",
     "ObservationDetails",
+    "ObservationDetailsAttachments",
+    "ObservationDetailsAttachmentsMask",
     "ObservationDetailsConstraintSet",
     "ObservationDetailsExecution",
     "ObservationDetailsExecutionDigest",
@@ -2616,6 +2621,7 @@ __all__ = [
     "ObservationEditObservationEditValueTimingWindowsEndTimingWindowEndAfterRepeat",
     "ObservationEditObservationEditValueTimingWindowsEndTimingWindowEndAfterRepeatPeriod",
     "ObservationEditObservationEditValueTimingWindowsEndTimingWindowEndAt",
+    "ObservationPriority",
     "ObservationPropertiesInput",
     "ObservationTimesInput",
     "ObservationValidationCode",
@@ -2716,6 +2722,7 @@ __all__ = [
     "ProperMotionInput",
     "ProposalPropertiesInput",
     "ProposalStatus",
+    "ProposalSummaryGenerationState",
     "ProposalSummaryStyle",
     "QuasarSpectrum",
     "QueueInput",
@@ -3034,6 +3041,7 @@ __all__ = [
     "WhereOrderInt",
     "WhereOrderLong",
     "WhereOrderObservationId",
+    "WhereOrderObservationPriority",
     "WhereOrderObservationWorkflowState",
     "WhereOrderPosBigDecimal",
     "WhereOrderPosInt",

{gpp_client-26.7.3.dev12 → gpp_client-26.9.0.dev1}/src/gpp_client/generated/client.py

@@ -2491,6 +2491,19 @@ class GraphQLClient(AsyncBaseClient):
                   }
                 }
               }
+              attachments {
+                id
+                fileName
+                attachmentType
+                mask {
+                  name
+                  instrument
+                  pixelScale
+                  dispersionDirection
+                  scienceSlitCount
+                  acquisitionSlitCount
+                }
+              }
             }
 
             fragment ObservingModeDetails on ObservingMode {
@@ -3488,6 +3501,19 @@ class GraphQLClient(AsyncBaseClient):
                   }
                 }
               }
+              attachments {
+                id
+                fileName
+                attachmentType
+                mask {
+                  name
+                  instrument
+                  pixelScale
+                  dispersionDirection
+                  scienceSlitCount
+                  acquisitionSlitCount
+                }
+              }
             }
 
             fragment ObservingModeDetails on ObservingMode {
@@ -4486,6 +4512,19 @@ class GraphQLClient(AsyncBaseClient):
                   }
                 }
               }
+              attachments {
+                id
+                fileName
+                attachmentType
+                mask {
+                  name
+                  instrument
+                  pixelScale
+                  dispersionDirection
+                  scienceSlitCount
+                  acquisitionSlitCount
+                }
+              }
             }
 
             fragment ObservingModeDetails on ObservingMode {
@@ -5486,6 +5525,19 @@ class GraphQLClient(AsyncBaseClient):
                   }
                 }
               }
+              attachments {
+                id
+                fileName
+                attachmentType
+                mask {
+                  name
+                  instrument
+                  pixelScale
+                  dispersionDirection
+                  scienceSlitCount
+                  acquisitionSlitCount
+                }
+              }
             }
 
             fragment ObservingModeDetails on ObservingMode {
@@ -6489,6 +6541,19 @@ class GraphQLClient(AsyncBaseClient):
                   }
                 }
               }
+              attachments {
+                id
+                fileName
+                attachmentType
+                mask {
+                  name
+                  instrument
+                  pixelScale
+                  dispersionDirection
+                  scienceSlitCount
+                  acquisitionSlitCount
+                }
+              }
             }
 
             fragment ObservingModeDetails on ObservingMode {
@@ -7492,6 +7557,19 @@ class GraphQLClient(AsyncBaseClient):
                   }
                 }
               }
+              attachments {
+                id
+                fileName
+                attachmentType
+                mask {
+                  name
+                  instrument
+                  pixelScale
+                  dispersionDirection
+                  scienceSlitCount
+                  acquisitionSlitCount
+                }
+              }
             }
 
             fragment ObservingModeDetails on ObservingMode {
@@ -8492,6 +8570,19 @@ class GraphQLClient(AsyncBaseClient):
                   }
                 }
               }
+              attachments {
+                id
+                fileName
+                attachmentType
+                mask {
+                  name
+                  instrument
+                  pixelScale
+                  dispersionDirection
+                  scienceSlitCount
+                  acquisitionSlitCount
+                }
+              }
             }
 
             fragment ObservingModeDetails on ObservingMode {
@@ -9492,6 +9583,19 @@ class GraphQLClient(AsyncBaseClient):
                   }
                 }
               }
+              attachments {
+                id
+                fileName
+                attachmentType
+                mask {
+                  name
+                  instrument
+                  pixelScale
+                  dispersionDirection
+                  scienceSlitCount
+                  acquisitionSlitCount
+                }
+              }
             }
 
             fragment ObservingModeDetails on ObservingMode {
@@ -10492,6 +10596,19 @@ class GraphQLClient(AsyncBaseClient):
                   }
                 }
               }
+              attachments {
+                id
+                fileName
+                attachmentType
+                mask {
+                  name
+                  instrument
+                  pixelScale
+                  dispersionDirection
+                  scienceSlitCount
+                  acquisitionSlitCount
+                }
+              }
             }
 
             fragment ObservingModeDetails on ObservingMode {
@@ -11493,6 +11610,19 @@ class GraphQLClient(AsyncBaseClient):
                   }
                 }
               }
+              attachments {
+                id
+                fileName
+                attachmentType
+                mask {
+                  name
+                  instrument
+                  pixelScale
+                  dispersionDirection
+                  scienceSlitCount
+                  acquisitionSlitCount
+                }
+              }
             }
 
             fragment ObservingModeDetails on ObservingMode {
@@ -12501,6 +12631,19 @@ class GraphQLClient(AsyncBaseClient):
                   }
                 }
               }
+              attachments {
+                id
+                fileName
+                attachmentType
+                mask {
+                  name
+                  instrument
+                  pixelScale
+                  dispersionDirection
+                  scienceSlitCount
+                  acquisitionSlitCount
+                }
+              }
             }
 
             fragment ObservingModeDetails on ObservingMode {

{gpp_client-26.7.3.dev12 → gpp_client-26.9.0.dev1}/src/gpp_client/generated/custom_fields.py

@@ -15,6 +15,7 @@ from .custom_typing_fields import (
     AllConfigChangeEstimatesGraphQLField,
     AllDetectorEstimatesGraphQLField,
     AllocationGraphQLField,
+    AltairGraphQLField,
     AngleGraphQLField,
     ArchiveDuplicationGraphQLField,
     ArchiveMatchGraphQLField,
@@ -300,6 +301,8 @@ from .custom_typing_fields import (
     ProperMotionRAGraphQLField,
     ProposalGraphQLField,
     ProposalReferenceGraphQLField,
+    ProposalSummaryFailureGraphQLField,
+    ProposalSummaryGenerationGraphQLField,
     ProposalSummaryPropertiesGraphQLField,
     QueueGraphQLField,
     RadialVelocityGraphQLField,
@@ -732,6 +735,29 @@ class AllocationFields(GraphQLField):
         return self
 
 
+class AltairFields(GraphQLField):
+    """Altair (Gemini North adaptive optics) configuration. Only GNIRS observations
+    may be configured to observe behind Altair."""
+
+    mode: "AltairGraphQLField" = AltairGraphQLField("mode")
+    "The Altair guiding mode."
+    explicit_field_lens: "AltairGraphQLField" = AltairGraphQLField("explicitFieldLens")
+    "The user's field lens override, or null for AUTO. When AUTO the field lens\nfollows the guide star separation. The LGS modes always use the field lens,\nso an explicit value of OUT is rejected for them."
+    cass_rotator: "AltairGraphQLField" = AltairGraphQLField("cassRotator")
+    "The cassegrain rotator tracking mode used while observing behind Altair."
+    nd_filter: "AltairGraphQLField" = AltairGraphQLField("ndFilter")
+    "The Altair neutral density filter position."
+
+    def fields(self, *subfields: AltairGraphQLField) -> "AltairFields":
+        """Subfields should come from the AltairFields class"""
+        self._subfields.extend(subfields)
+        return self
+
+    def alias(self, alias: str) -> "AltairFields":
+        self._alias = alias
+        return self
+
+
 class AngleFields(GraphQLField):
     """An angle in a variety of units.  Values are normalized to [0, 360°) unless
     the field documents a signed quantity, in which case negative values are
@@ -784,7 +810,7 @@ class ArchiveDuplicationFields(GraphQLField):
     state: "ArchiveDuplicationGraphQLField" = ArchiveDuplicationGraphQLField("state")
     "State of the stored snapshot.  Partly derived: an observation with no\nobserving mode reads NOT_APPLICABLE whatever was stored."
     stale: "ArchiveDuplicationGraphQLField" = ArchiveDuplicationGraphQLField("stale")
-    "Whether the snapshot no longer describes the observation as it now stands:\nthe archive queries the search would run today differ from `queryUrls`.\nNever true when nothing was searched, when nothing can be searched now, or\nafter submission."
+    "Whether the snapshot no longer describes the observation as it now stands:\nthe archive queries the search would run today differ from `queryUrls`.\nNever true when nothing was searched, when nothing can be searched now, or\nwhen a refresh would be rejected: the proposal is submitted or was not\naccepted, or the observation is completed."
     match_count: "ArchiveDuplicationGraphQLField" = ArchiveDuplicationGraphQLField(
         "matchCount"
     )
@@ -4653,7 +4679,9 @@ class Flamingos2LongSlitFields(GraphQLField):
 
     @classmethod
     def default_telescope_configs(cls) -> "SlitTelescopeConfigsFields":
-        """Default telescope configs."""
+        """Default telescope configs. For a telluric derived from a MOS observation
+        these are the MOS telluric offsets, so such a telluric normally has no
+        explicit override."""
         return SlitTelescopeConfigsFields("defaultTelescopeConfigs")
 
     @classmethod
@@ -7977,9 +8005,11 @@ class GnirsIfuFields(GraphQLField):
 
     @classmethod
     def central_wavelengths(cls) -> "GnirsCentralWavelengthConfigFields":
-        """The central wavelengths at which spectra are taken, in increasing wavelength
-        order.  Each one is a separate configuration with its own exposure time mode,
-        coadds, ITC calculation and calibrations."""
+        """The central wavelengths at which spectra are taken, in the order they were
+        specified and in which the sequence executes them.  Each entry is a separate
+        configuration with its own exposure time mode, coadds, ITC calculation and
+        calibrations; a wavelength may appear more than once, each occurrence being
+        independent."""
         return GnirsCentralWavelengthConfigFields("centralWavelengths")
 
     @classmethod
@@ -8203,9 +8233,11 @@ class GnirsLongSlitFields(GraphQLField):
 
     @classmethod
     def central_wavelengths(cls) -> "GnirsCentralWavelengthConfigFields":
-        """The central wavelengths at which spectra are taken, in increasing wavelength
-        order.  Each one is a separate configuration with its own exposure time mode,
-        coadds, ITC calculation and calibrations."""
+        """The central wavelengths at which spectra are taken, in the order they were
+        specified and in which the sequence executes them.  Each entry is a separate
+        configuration with its own exposure time mode, coadds, ITC calculation and
+        calibrations; a wavelength may appear more than once, each occurrence being
+        independent."""
         return GnirsCentralWavelengthConfigFields("centralWavelengths")
 
     @classmethod
@@ -8228,6 +8260,9 @@ class GnirsLongSlitFields(GraphQLField):
 
     @classmethod
     def default_telescope_configs(cls) -> "SlitTelescopeConfigsFields":
+        """Default telescope configs for the configuration. For a telluric calibration
+        these are the telluric offsets, so a telluric normally has no explicit
+        override."""
         return SlitTelescopeConfigsFields("defaultTelescopeConfigs")
 
     @classmethod
@@ -8307,9 +8342,11 @@ class GnirsSpectroscopyFields(GraphQLField):
 
     @classmethod
     def central_wavelengths(cls) -> "GnirsCentralWavelengthConfigFields":
-        """The central wavelengths at which spectra are taken, in increasing wavelength
-        order.  Each one is a separate configuration with its own exposure time mode,
-        coadds, ITC calculation and calibrations."""
+        """The central wavelengths at which spectra are taken, in the order they were
+        specified and in which the sequence executes them.  Each entry is a separate
+        configuration with its own exposure time mode, coadds, ITC calculation and
+        calibrations; a wavelength may appear more than once, each occurrence being
+        independent."""
         return GnirsCentralWavelengthConfigFields("centralWavelengths")
 
     @classmethod
@@ -8485,6 +8522,9 @@ class GnirsSpectroscopyLongSlitFields(GraphQLField):
 
     @classmethod
     def default_telescope_configs(cls) -> "SlitTelescopeConfigsFields":
+        """Default telescope configs for the configuration. For a telluric calibration
+        these are the telluric offsets, so a telluric normally has no explicit
+        override."""
         return SlitTelescopeConfigsFields("defaultTelescopeConfigs")
 
     @classmethod
@@ -9767,8 +9807,10 @@ class ItcGnirsImagingResultSetFields(GraphQLField):
 
 
 class ItcGnirsSpectroscopyFields(GraphQLField):
-    """GNIRS spectroscopy ITC results.  Each central wavelength is a separate
-    configuration and is paired with its own result set."""
+    """GNIRS spectroscopy ITC results: one result set per entry in the observation's
+    central wavelength list, in the same order, so the nth element here corresponds
+    to the nth `centralWavelengths` element.  Each entry is a separate configuration,
+    and a central wavelength may therefore appear more than once."""
 
     itc_type: "ItcGnirsSpectroscopyGraphQLField" = ItcGnirsSpectroscopyGraphQLField(
         "itcType"
@@ -9802,7 +9844,9 @@ class ItcGnirsSpectroscopyFields(GraphQLField):
 
 class ItcGnirsSpectroscopyResultSetFields(GraphQLField):
     """Combines a GNIRS spectroscopy central wavelength with an `ItcResultSet`. In
-    other words, ITC results for all targets but a single central wavelength."""
+    other words, ITC results for all targets but a single entry in the observation's
+    central wavelength list.  The wavelength does not identify the entry, since it
+    may be repeated; see `ItcGnirsSpectroscopy.gnirsSpectroscopyScience`."""
 
     @classmethod
     def central_wavelength(cls) -> "WavelengthFields":
@@ -10466,6 +10510,8 @@ class ObservationFields(GraphQLField):
     "The Calibration role of this observation"
     observer_notes: "ObservationGraphQLField" = ObservationGraphQLField("observerNotes")
     "Notes for the observer"
+    priority: "ObservationGraphQLField" = ObservationGraphQLField("priority")
+    "The PI's declared priority for this observation, relative to the other\nobservations of the same program. Defaults to MEDIUM."
 
     @classmethod
     def configuration(cls) -> "ConfigurationFields":
@@ -11273,6 +11319,11 @@ class ProgramFields(GraphQLField):
         """Observatory archive properties related to this program."""
         return GoaPropertiesFields("goa")
 
+    @classmethod
+    def proposal_summary_generation(cls) -> "ProposalSummaryGenerationFields":
+        """State of this program's proposal summary regeneration."""
+        return ProposalSummaryGenerationFields("proposalSummaryGeneration")
+
     resource_limit: "ProgramGraphQLField" = ProgramGraphQLField("resourceLimit")
     "Maximum number of resources (observations, groups, targets, attachments, and\nprogram notes, combined) that may be associated with this program."
     resource_count: "ProgramGraphQLField" = ProgramGraphQLField("resourceCount")
@@ -11298,6 +11349,7 @@ class ProgramFields(GraphQLField):
             "ProgramReferenceInterface",
             "ProgramUserFields",
             "ProposalFields",
+            "ProposalSummaryGenerationFields",
             "UserInvitationFields",
         ],
     ) -> "ProgramFields":
@@ -11686,6 +11738,65 @@ class ProposalReferenceFields(GraphQLField):
         return self
 
 
+class ProposalSummaryFailureFields(GraphQLField):
+    """One failed render of a proposal summary regeneration."""
+
+    partner: "ProposalSummaryFailureGraphQLField" = ProposalSummaryFailureGraphQLField(
+        "partner"
+    )
+    "The partner whose render failed.  Null for the single render of a proposal\nwith no partner splits."
+    message: "ProposalSummaryFailureGraphQLField" = ProposalSummaryFailureGraphQLField(
+        "message"
+    )
+    "Why this render failed, in terms an investigator can act on."
+
+    def fields(
+        self, *subfields: ProposalSummaryFailureGraphQLField
+    ) -> "ProposalSummaryFailureFields":
+        """Subfields should come from the ProposalSummaryFailureFields class"""
+        self._subfields.extend(subfields)
+        return self
+
+    def alias(self, alias: str) -> "ProposalSummaryFailureFields":
+        self._alias = alias
+        return self
+
+
+class ProposalSummaryGenerationFields(GraphQLField):
+    """State of a program's proposal summary regeneration.
+
+    GENERATING is expected to terminate under normal operation (timeouts and retries), but may remain GENERATING if rendering is unavailable."""
+
+    state: "ProposalSummaryGenerationGraphQLField" = (
+        ProposalSummaryGenerationGraphQLField("state")
+    )
+    "The state of `ProposalSummaryGeneration`."
+    requested_at: "ProposalSummaryGenerationGraphQLField" = (
+        ProposalSummaryGenerationGraphQLField("requestedAt")
+    )
+    "When the oldest render still outstanding was requested. Null when state is IDLE."
+
+    @classmethod
+    def failures(cls) -> "ProposalSummaryFailureFields":
+        """The renders of the last regeneration that failed, one entry per partner.
+        Empty unless state is FAILED."""
+        return ProposalSummaryFailureFields("failures")
+
+    def fields(
+        self,
+        *subfields: Union[
+            ProposalSummaryGenerationGraphQLField, "ProposalSummaryFailureFields"
+        ],
+    ) -> "ProposalSummaryGenerationFields":
+        """Subfields should come from the ProposalSummaryGenerationFields class"""
+        self._subfields.extend(subfields)
+        return self
+
+    def alias(self, alias: str) -> "ProposalSummaryGenerationFields":
+        self._alias = alias
+        return self
+
+
 class ProposalSummaryPropertiesFields(GraphQLField):
     """Properties of an ODB-generated proposal summary PDF."""
 
@@ -13822,15 +13933,34 @@ class TargetEnvironmentFields(GraphQLField):
         "blindOffsetType"
     )
     "The type of blind offset (automatic or manual) if a blind offset exists."
+    guide_probe: "TargetEnvironmentGraphQLField" = TargetEnvironmentGraphQLField(
+        "guideProbe"
+    )
+    "The guide probe the automatic guide star search uses: the explicit probe if\nset, otherwise the default. Null when no default can be determined."
+    default_guide_probe: "TargetEnvironmentGraphQLField" = (
+        TargetEnvironmentGraphQLField("defaultGuideProbe")
+    )
+    "The default guide probe for the observing mode and asterism track type. Null\nwhen the observation has no observing mode or targets, or when the mode does\nnot support guiding."
+    explicit_guide_probe: "TargetEnvironmentGraphQLField" = (
+        TargetEnvironmentGraphQLField("explicitGuideProbe")
+    )
+    "The user selected guide probe, if any, set via\n`TargetEnvironmentInput.explicitGuideProbe`."
     cass_rotator: "TargetEnvironmentGraphQLField" = TargetEnvironmentGraphQLField(
         "cassRotator"
     )
-    "The cassegrain rotator tracking mode."
+    "The cassegrain rotator tracking mode: the value stored with the Altair\nconfiguration when the observation has one, otherwise derived from the\ninstrument."
+
+    @classmethod
+    def altair(cls) -> "AltairFields":
+        """Altair adaptive optics configuration, only for GNIRS observations. Null when
+        the observation does not observe behind Altair."""
+        return AltairFields("altair")
 
     def fields(
         self,
         *subfields: Union[
             TargetEnvironmentGraphQLField,
+            "AltairFields",
             "BasePositionFields",
             "CoordinatesFields",
             "GuideAvailabilityPeriodFields",

{gpp_client-26.7.3.dev12 → gpp_client-26.9.0.dev1}/src/gpp_client/generated/custom_mutations.py

@@ -704,7 +704,9 @@ class Mutation:
         """Re-runs the Archive Duplication Search for an observation, replacing its
         stored result with what the Gemini Observatory Archive holds now.
 
-        Rejected once the observation's proposal has been submitted."""
+        Rejected while the proposal is submitted or was not accepted, and for a
+        completed observation whatever the proposal status.  Allowed again once the
+        proposal is accepted, so newly added or changed targets can be checked."""
         arguments: dict[str, dict[str, Any]] = {
             "input": {"type": "RefreshArchiveDuplicationInput!", "value": input}
         }
@@ -798,12 +800,16 @@ class Mutation:
     def regenerate_proposal_summaries(
         cls, input: RegenerateProposalSummariesInput
     ) -> RegenerateProposalSummariesResultFields:
-        """Regenerate the proposal summary PDFs for a proposal: one per partner it
-        applies to, each in that partner's style, replacing the existing SUMMARY
-        attachments once rendered.
-        Rendering is asynchronous and completion shows up as the program's SUMMARY
-        attachments.
-        Requires write access to the program (staff, or membership as PI, CoI or support)."""
+        """Regenerate the proposal summary PDFs: one per partner, in that partner's
+        style, replacing the SUMMARY attachments once rendered.
+
+        Rendering is asynchronous, the new attachments and the flip back to IDLE
+        arrive in one programEdit event.
+
+        A request while GENERATING is a no-op, or queues at most one more render if the
+        previous one is already rendering.  The state stays GENERATING either way.
+
+        Requires write access to the program (staff, PI, CoI or support)."""
         arguments: dict[str, dict[str, Any]] = {
             "input": {"type": "RegenerateProposalSummariesInput!", "value": input}
         }