@morscherlab/mint-sdk 1.5.0-beta.1 → 1.5.0-beta.3

package/src/composables/index.ts

@@ -1,6 +1,5 @@
 // Package-root composables: the L1 and L2 names of spec 3.3. Subpath composables are
-// exported from `lab.ts`, `shell.ts`, `data.ts` and `runtime.ts`; `deprecatedRootExports.ts`
-// keeps the other 1.3 root names until MINT 1.5.
+// exported from `lab.ts`, `shell.ts`, `data.ts` and `runtime.ts`.
 export { useTheme } from './useTheme'
 export { useToast } from './useToast'
 export { usePlatform } from './usePlatform'

package/src/composables/useExperimentSelector.ts

@@ -30,6 +30,8 @@ export interface UseExperimentSelectorOptions {
   immediate?: boolean
   /** Keep `statusCounts` in step with the non-status filters (one stats request per change). */
   withStatusCounts?: boolean
+  /** Filter values to start from, for example the ones a caller saved at the last visit. */
+  initialFilters?: Partial<ExperimentFilters>
 }
 
 export interface UseExperimentSelectorReturn {
@@ -89,6 +91,7 @@ export function useExperimentSelector(
     allowedExperimentTypes: optionAllowedExperimentTypes,
     apiBaseUrl,
     withStatusCounts = false,
+    initialFilters,
   } = options
   const platformBase = apiBaseUrl ?? getPlatformApiUrl()
   const api = useApi()
@@ -124,6 +127,7 @@ export function useExperimentSelector(
     experimentType: undefined,
     datePreset: undefined,
     mine: undefined,
+    ...initialFilters,
   })
 
   function normalizeExperimentTypes(values: string[] | null | undefined): string[] | null {

package/src/composables/useJobsEndpoint.ts

@@ -677,16 +677,27 @@ export function useJobsEndpoint(
     ]))
     jobs.value = nextJobs
     for (const job of nextJobs) settleJobWaiters(job)
-    for (const jobId of previousJobIds) {
-      if (!nextJobIds.has(jobId)) {
-        rejectJobWaiters(jobId, new Error(`Job ${jobId} is no longer available`))
-      }
+    for (const jobId of [...jobWaiters.keys()]) {
+      if (!nextJobIds.has(jobId)) void confirmMissingJob(jobId)
     }
     pruneResultState()
     pruneJobRevisions()
     return nextJobs
   }
 
+  /**
+   * A stream snapshot built before a submit can arrive after the submit reply,
+   * so a waited job missing from it is gone only once the server says so.
+   */
+  async function confirmMissingJob(jobId: string): Promise<void> {
+    try {
+      await getJob(jobId)
+    } catch (cause) {
+      if (isRetryableJobLookupError(cause)) return
+      rejectJobWaiters(jobId, new Error(`Job ${jobId} is no longer available`))
+    }
+  }
+
   function upsertJob(
     input: GeneratedAnalysisJobInput,
     fallbackDefinitionId?: string,

package/src/composables/useOnboarding.ts

@@ -108,7 +108,7 @@ export interface OnboardingState {
   showNews: (id: string) => void
   next: () => void
   back: () => void
-  /** End the run (× or Esc). Every step of the tour counts as seen. */
+  /** End the run (× or Esc). Every step of every tour of the app counts as seen; Help can still play them. */
   dismiss: () => void
   complete: (taskId: string) => void
   setChecklistHidden: (hidden: boolean) => void
@@ -381,8 +381,8 @@ export function provideOnboarding(definition: OnboardingDefinition, options: Pro
 
   function dismiss() {
     autoStartAbort?.abort()
-    const tour = run?.tour
-    if (tour) markSeen(...tour.steps.map((step) => stepKey(tour, step)))
+    // × on a tour ends all tours of the app, so the user closes tours at most once per app.
+    if (run?.tour) markSeen(...(definition.tours ?? []).flatMap((tour) => tour.steps.map((step) => stepKey(tour, step))))
     stop()
   }
 

package/src/generated-ui/main.ts

@@ -2,6 +2,7 @@ import { createPinia } from 'pinia'
 import { createApp, h } from 'vue'
 
 import GeneratedPluginView from '../components/GeneratedPluginView.vue'
+import { useSettingsStore } from '../stores/settings'
 import '../styles/index.css'
 
 function generatedApiBase(location: Location): string {
@@ -13,9 +14,10 @@ const app = createApp({
   name: 'MintGeneratedUiApp',
   render: () => h(GeneratedPluginView, {
     baseUrl: generatedApiBase(window.location),
-    showStandaloneLabel: true,
   }),
 })
 
 app.use(createPinia())
+// Theme, palette and density apply before the first paint, as in the platform.
+useSettingsStore().initialize()
 app.mount('#app')

package/src/index.ts

@@ -16,8 +16,5 @@ export * from './composables'
 // Stores
 export * from './stores'
 
-// Root names outside L1 and L2, deprecated until MINT 1.5
-export * from './deprecatedRootExports'
-
 // Types
 export type * from './types'

package/src/styles/components/alert-box.css

@@ -31,7 +31,7 @@
 .mint-alert__icon--info    { background-color: var(--mint-info-bg);    color: var(--mint-info); }
 .mint-alert__icon--neutral { background-color: var(--bg-tertiary);     color: var(--text-secondary); }
 .mint-alert__icon--primary { background-color: var(--color-primary-soft); color: var(--color-primary); }
-.mint-alert__icon--cta     { background-color: var(--color-primary-soft); color: var(--color-cta-hover); }
+.mint-alert__icon--cta     { background-color: var(--color-primary-soft); color: var(--_ink-primary); }
 
 .mint-alert__content {
   flex: 1;

package/src/styles/components/app-sidebar.css

@@ -97,8 +97,8 @@
   min-width: 1.375rem;
   padding: 0.125rem 0.375rem;
   border-radius: var(--radius);
-  background: color-mix(in srgb, var(--color-cta) 14%, transparent);
-  color: var(--color-cta);
+  background: color-mix(in srgb, var(--color-primary) 14%, transparent);
+  color: var(--color-primary);
   font-size: 0.6875rem;
   font-weight: 700;
   line-height: 1.1;
@@ -369,7 +369,7 @@
   width: 11px;
   height: 11px;
   border-radius: 9999px;
-  background: white;
+  background: var(--control-knob);
   box-shadow: var(--shadow-sm);
   transition: left 180ms var(--mint-ease-out-quart);
 }
@@ -469,7 +469,7 @@
   padding: 0 0.25rem;
   border-radius: var(--radius);
   background: var(--mint-sidebar-tone);
-  color: white;
+  color: var(--text-on-accent);
   font-size: 0.6875rem;
   font-weight: 700;
   line-height: 1rem;
@@ -492,7 +492,7 @@
 .mint-sidebar__rail-badge--cta,
 .mint-sidebar__tag--cta,
 .mint-sidebar__group-action--cta {
-  --mint-sidebar-tone: var(--color-cta);
+  --mint-sidebar-tone: var(--color-primary);
 }
 
 .mint-sidebar__rail-badge--success,

package/src/styles/components/button.css

@@ -68,17 +68,17 @@
 }
 
 .mint-button--cta {
-  background-color: var(--color-cta);
+  background-color: var(--color-primary);
   color: var(--text-on-accent);
 }
 
 .mint-button--cta:hover:not(.mint-button--disabled) {
-  background-color: var(--color-cta-hover);
+  background-color: var(--color-primary-hover);
 }
 
 .mint-button--danger {
   background-color: var(--mint-error);
-  color: white;
+  color: var(--text-on-danger);
 }
 
 .mint-button--danger:hover:not(.mint-button--disabled) {

package/src/styles/components/checkbox.css

@@ -133,7 +133,7 @@
 .mint-checkbox__native:disabled + .mint-checkbox__box.mint-checkbox__box--indeterminate {
   background-color: var(--text-muted);
   border-color: var(--text-muted);
-  color: #FFFFFF;
+  color: var(--control-knob);
 }
 
 .mint-checkbox__box--sm {

package/src/styles/components/collapsible-card.css

@@ -159,7 +159,7 @@
 
 .mint-collapsible-card__badge--cta,
 .mint-collapsible-card__action--cta {
-  --mint-sidebar-badge-color: var(--color-cta);
+  --mint-sidebar-badge-color: var(--color-primary);
 }
 
 .mint-collapsible-card__badge--success,

package/src/styles/components/confirm-dialog.css

@@ -48,8 +48,8 @@
 }
 
 .mint-confirm__icon--cta {
-  background-color: color-mix(in srgb, var(--color-cta) 12%, transparent);
-  color: var(--color-cta);
+  background-color: color-mix(in srgb, var(--color-primary) 12%, transparent);
+  color: var(--color-primary);
 }
 
 .mint-confirm__icon--neutral {

package/src/styles/components/file-uploader.css

@@ -160,9 +160,9 @@
   font-size: 0.6875rem;
   font-weight: 700;
   font-family: var(--font-mono);
-  color: var(--badge-color);
-  background-color: color-mix(in srgb, var(--badge-color) 10%, transparent);
-  border: 1px solid color-mix(in srgb, var(--badge-color) 20%, transparent);
+  color: var(--text-secondary);
+  background-color: var(--bg-tertiary);
+  border: 1px solid var(--border-color);
 }
 
 .mint-file-uploader__file-meta {

package/src/styles/components/icon-button.css

@@ -57,17 +57,17 @@
 }
 
 .mint-icon-button--cta {
-  background-color: var(--color-cta);
+  background-color: var(--color-primary);
   color: var(--text-on-accent);
 }
 
 .mint-icon-button--cta:hover:not(.mint-icon-button--disabled) {
-  background-color: var(--color-cta-hover);
+  background-color: var(--color-primary-hover);
 }
 
 .mint-icon-button--danger {
   background-color: var(--mint-error);
-  color: white;
+  color: var(--text-on-danger);
 }
 
 .mint-icon-button--danger:hover:not(.mint-icon-button--disabled) {

package/src/styles/components/loading-spinner.css

@@ -33,7 +33,7 @@
 
 /* Tones */
 .mint-spinner--primary { color: var(--color-primary); }
-.mint-spinner--cta     { color: var(--color-cta); }
+.mint-spinner--cta     { color: var(--color-primary); }
 .mint-spinner--success { color: var(--mint-success); }
 .mint-spinner--warning { color: var(--mint-warning); }
 .mint-spinner--error   { color: var(--mint-error); }

package/src/styles/components/onboarding.css

@@ -39,6 +39,44 @@ html.dark {
   transition: background-color var(--mint-transition), border-color var(--mint-transition);
 }
 
+/* The close button sits inside the chip border, so the chip keeps room for it. */
+.mint-onboarding-help__chip-group {
+  position: relative;
+  display: inline-flex;
+}
+
+.mint-onboarding-help__chip-group .mint-onboarding-help__chip {
+  padding-right: 2rem;
+}
+
+.mint-onboarding-help__chip-close {
+  position: absolute;
+  top: 50%;
+  right: 0.25rem;
+  display: grid;
+  place-items: center;
+  width: 1.5rem;
+  height: 1.5rem;
+  padding: 0;
+  border: 0;
+  border-radius: var(--radius-sm);
+  background: transparent;
+  color: var(--text-muted);
+  cursor: pointer;
+  transform: translateY(-50%);
+  transition: background-color var(--mint-transition), color var(--mint-transition);
+}
+
+.mint-onboarding-help__chip-close:hover {
+  background: var(--bg-tertiary);
+  color: var(--text-primary);
+}
+
+.mint-onboarding-help__chip-close:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring-offset);
+}
+
 .mint-onboarding-help__chip:hover {
   background: var(--bg-hover);
 }
@@ -360,6 +398,7 @@ html.dark {
 
 @media (prefers-reduced-motion: reduce) {
   .mint-onboarding-help__chip,
+  .mint-onboarding-help__chip-close,
   .mint-onboarding-help__bar > span,
   .mint-onboarding-help__progress > span,
   .mint-onboarding__hole {

package/src/styles/components/pill.css

@@ -33,7 +33,7 @@
    (soft-tint background, dot, outline border); `--mint-pill-ink` the text. A
    `color` prop sets `--mint-pill-tone` inline. */
 .mint-pill--primary { --mint-pill-tone: var(--color-primary); --mint-pill-ink: var(--color-primary-hover); }
-.mint-pill--cta     { --mint-pill-tone: var(--color-cta);     --mint-pill-ink: var(--color-cta-hover); }
+.mint-pill--cta     { --mint-pill-tone: var(--color-primary);     --mint-pill-ink: var(--color-primary-hover); }
 .mint-pill--success { --mint-pill-tone: var(--mint-success);  --mint-pill-ink: var(--mint-success-hover); }
 .mint-pill--warning { --mint-pill-tone: var(--mint-warning);  --mint-pill-ink: var(--mint-warning-text); }
 .mint-pill--error   { --mint-pill-tone: var(--mint-error);    --mint-pill-ink: var(--mint-error-hover); }

package/src/styles/components/plugin-icon.css

@@ -16,10 +16,10 @@
 .mint-plugin-icon--topbar { width: 2.25rem; height: 2.25rem; }
 .mint-plugin-icon--lg { width: 3rem;   height: 3rem;   }
 
-/* Tones (deprecated with the tone/color props, removed in 1.5): the v2 tile no longer reads the variable. */
+/* Tones (deprecated with the tone/color props, removed in 2.0): the v2 tile no longer reads the variable. */
 .mint-plugin-icon--neutral { --mint-plugin-icon-tone: var(--text-secondary); }
 .mint-plugin-icon--primary { --mint-plugin-icon-tone: var(--color-primary); }
-.mint-plugin-icon--cta     { --mint-plugin-icon-tone: var(--color-cta); }
+.mint-plugin-icon--cta     { --mint-plugin-icon-tone: var(--color-primary); }
 .mint-plugin-icon--success { --mint-plugin-icon-tone: var(--mint-success); }
 .mint-plugin-icon--warning { --mint-plugin-icon-tone: var(--mint-warning); }
 .mint-plugin-icon--error   { --mint-plugin-icon-tone: var(--mint-error); }

package/src/styles/components/presence-avatars.css

@@ -1,18 +1,18 @@
 /* PresenceAvatars: an avatar stack that opens a list of who is here.
  * The editing cue is a ring plus a pencil badge, so it does not depend on
- * colour only. Light mode uses --color-cta-hover (3:1 on the card), dark
- * mode --color-cta. --mint-presence-surface is the colour the avatars are
+ * colour only. Light mode uses --color-primary-hover (3:1 on the card), dark
+ * mode --color-primary. --mint-presence-surface is the colour the avatars are
  * cut out of; set it when the stack sits on another surface. */
 
 .mint-presence {
-  --mint-presence-editing: var(--color-cta-hover);
+  --mint-presence-editing: var(--color-primary-hover);
   --mint-presence-surface: var(--bg-secondary);
   position: relative;
   display: inline-flex;
 }
 
 :where(html.dark) .mint-presence {
-  --mint-presence-editing: var(--color-cta);
+  --mint-presence-editing: var(--color-primary);
 }
 
 .mint-presence__trigger {

package/src/styles/components/progress-bar.css

@@ -46,7 +46,7 @@
 .mint-progress__bar--success { background-color: var(--mint-success); }
 .mint-progress__bar--warning { background-color: var(--mint-warning); }
 .mint-progress__bar--error   { background-color: var(--mint-error); }
-.mint-progress__bar--cta     { background-color: var(--color-cta); }
+.mint-progress__bar--cta     { background-color: var(--color-primary); }
 .mint-progress__bar--neutral { background-color: var(--text-muted); }
 .mint-progress__bar--info    { background-color: var(--color-primary); } /* 6b: progress fill is always primary; --mint-info is for the running dot */
 

package/src/styles/components/section-card.css

@@ -27,6 +27,11 @@
   min-height: 0;
 }
 
+/* A collapsed fill card gives its track back to its siblings. */
+.mint-section-card--fill.mint-section-card--collapsed {
+  flex: none;
+}
+
 .mint-section-card--fill .mint-section-card__body {
   flex: 1;
   min-height: 0;
@@ -41,7 +46,7 @@
   min-height: 2.5rem;
   /* 4px block padding: a 28px header control plus padding plus the 1px rule
      stays inside the 40px strip (6px made it 41px). */
-  padding: 0.25rem 0.625rem 0.25rem 0.75rem;
+  padding: 0.25rem 0.625rem 0.25rem var(--mint-section-card-inset);
   border-bottom: 1px solid var(--border-color);
   flex-shrink: 0;
 }
@@ -50,6 +55,45 @@
   border-bottom-color: var(--border-light);
 }
 
+/* A collapsed card is its header alone: no rule under it. */
+.mint-section-card__header--collapsed {
+  border-bottom-color: transparent;
+}
+
+.mint-section-card__toggle {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--mint-section-card-gap);
+  margin: 0;
+  padding: 0;
+  border: 0;
+  background: none;
+  color: inherit;
+  font: inherit;
+  cursor: pointer;
+}
+
+.mint-section-card__toggle:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring-offset);
+  border-radius: var(--radius-sm);
+}
+
+.mint-section-card__chevron {
+  width: 0.875rem;
+  height: 0.875rem;
+  color: var(--text-muted);
+  transition: transform var(--mint-transition);
+}
+
+.mint-section-card__toggle[aria-expanded="false"] .mint-section-card__chevron {
+  transform: rotate(-90deg);
+}
+
+.mint-section-card__toggle:hover .mint-section-card__chevron {
+  color: var(--text-secondary);
+}
+
 /* Muted icon, no tinted chip: every accent renders the same. */
 .mint-section-card__icon-chip {
   display: inline-flex;
@@ -97,7 +141,8 @@
   display: flex;
   align-items: center;
   justify-content: space-between;
-  padding: 0.5rem 1rem;
+  /* Text starts on the card inset; controls end where the header's do. */
+  padding: 0.5rem 0.625rem 0.5rem var(--mint-section-card-inset);
   border-top: 1px solid var(--border-color);
   background: var(--bg-primary);
   font-size: 0.75rem;
@@ -118,7 +163,7 @@
   display: flex;
   align-items: center;
   gap: var(--mint-section-card-gap);
-  padding: 0.375rem 0.75rem;
+  padding: 0.375rem var(--mint-section-card-inset);
   background: var(--bg-secondary);
   transition: background-color var(--mint-transition);
 }
@@ -153,12 +198,26 @@ button.mint-section-card__row:hover {
 /* Comfortable density gives the header and rows back their height. */
 [data-density="comfortable"] .mint-section-card__header {
   min-height: 2.75rem;
-  padding: 0.25rem 0.75rem 0.25rem 0.875rem;
+  padding-right: 0.75rem;
+}
+
+[data-density="comfortable"] .mint-section-card__footer {
+  padding-right: 0.75rem;
 }
 
 [data-density="comfortable"] .mint-section-card__row {
   padding-top: 0.5rem;
   padding-bottom: 0.5rem;
-  /* Same left inset as the header, so row content lines up under the header. */
-  padding-left: 0.875rem;
+}
+
+/* A table that is the card body's own child starts and ends on the card's text
+   inset, so its first column lines up under the header title. A table inside a
+   padded wrapper keeps its padding, and the checkbox and actions columns stay
+   centred controls. The table's size padding uses !important, so this must too. */
+.mint-section-card__body > .mint-dataframe :is(.mint-dataframe__th, .mint-dataframe__td):first-child:not(.mint-dataframe__th--checkbox, .mint-dataframe__td--checkbox) {
+  padding-left: var(--mint-section-card-inset) !important;
+}
+
+.mint-section-card__body > .mint-dataframe :is(.mint-dataframe__th, .mint-dataframe__td):last-child:not(.mint-dataframe__th--actions, .mint-dataframe__td--actions) {
+  padding-right: var(--mint-section-card-inset) !important;
 }

package/src/styles/components/sequence-input.css

@@ -226,7 +226,7 @@
 .mint-sequence-input__problem--error .mint-sequence-input__problem-shape { fill: var(--mint-error); }
 
 .mint-sequence-input__problem-mark {
-  stroke: white;
+  stroke: var(--text-on-danger);
   stroke-width: 1.6;
   stroke-linecap: round;
 }

package/src/styles/components/slider.css

@@ -56,7 +56,7 @@
   box-sizing: border-box;
   transform: translateX(-50%) translateY(-50%);
   border-radius: 9999px;
-  background-color: #FFFFFF;
+  background-color: var(--control-knob);
   border: 1px solid color-mix(in srgb, var(--text-secondary) 40%, transparent);
   box-shadow: var(--shadow-sm);
   pointer-events: none;

package/src/styles/components/toggle.css

@@ -151,7 +151,7 @@
   top: 50%;
   left: 2px;
   border-radius: 9999px;
-  background-color: #FFFFFF;
+  background-color: var(--control-knob);
   box-shadow: var(--shadow-sm);
   transition: transform 180ms cubic-bezier(0.25, 1, 0.5, 1);
   pointer-events: none;

package/src/styles/variables.css

@@ -3,8 +3,6 @@
  * @import '@morscherlab/mint-sdk/styles';
  */
 
-@import url('https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=Geist+Mono:wght@400;500;600&display=swap');
-
 /* Tailwind v4's layer order, declared first so the SDK's base and utilities
    layers sort the same way with or without Tailwind in the host. */
 @layer theme, base, components, utilities;
@@ -61,12 +59,16 @@
   --mint-primary: var(--color-primary);
   /* Text and icons on an accent fill (filled buttons, Save). */
   --text-on-accent: #FFFFFF;
-  /* Retired hues, aliased to the accent until 1.5 (mint doctor warns on use). */
+  /* Text on a --mint-error fill (danger buttons); white in both themes, 3.76:1 on #EF4444. */
+  --text-on-danger: #FFFFFF;
+  /* Knob of a toggle or slider, and the mark of a disabled checkbox; white in both themes. */
+  --control-knob: #FFFFFF;
+  /* Retired hues, aliased to the accent until 2.0 (mint doctor warns on use). */
   --color-cta: var(--color-primary);
   --color-cta-hover: var(--color-primary-hover);
   --color-purple: var(--color-primary);
 
-  /* Entity colors — retired hues, aliased to slate until 1.5. Entities are told
+  /* Entity colors — retired hues, aliased to slate until 2.0. Entities are told
      apart by icon and label, not by hue. Only -hover has no neutral token. */
   --color-experiment: var(--text-secondary-strong);
   --color-experiment-hover: #334155;
@@ -136,6 +138,9 @@
   --mint-gutter: 0.5rem;
   /* Distance from the outermost cards to the window edge, in every density. */
   --mint-page-inset: 1rem;
+  /* Text inset of a SectionCard: its title, row text and table edge columns
+     start here, and page chrome over a card (breadcrumbs) can line up with it. */
+  --mint-section-card-inset: 0.75rem;
 
   /* Semantic colors */
   --mint-success: #10B981;
@@ -379,6 +384,7 @@ html.dark [data-palette="forest"] {
 /* Comfortable density (html[data-density], written by the settings store):
    the pre-v2 control heights and a wider gutter. */
 [data-density="comfortable"] {
+  --mint-section-card-inset: 0.875rem;
   --form-height-sm: 2rem;
   --form-height-md: 2.25rem;
   --form-height-lg: 3rem;

package/src/types/index.ts

@@ -219,7 +219,6 @@ export type {
   InstrumentLiveProgress,
   InstrumentLiveStatus,
   InstrumentState,
-  InstrumentStatus,
   InstrumentStatusReporter,
   SampleInfo,
   SampleInfo as InstrumentSampleInfo,

package/src/types/instrument.ts

@@ -24,24 +24,6 @@ export interface SequenceProgress {
   sample_durations?: readonly number[]
 }
 
-/** @deprecated Scheduled for removal in MINT 1.4; instrument monitor types move to the mld-ms plugins. */
-export interface InstrumentStatus {
-  instrument_id: string
-  instrument_name?: string | null
-  monitor_id?: string | null
-  state: InstrumentState
-  active_method?: string | null
-  current_sample?: SampleInfo | null
-  sequence_progress?: SequenceProgress | null
-  timestamp?: string | Date
-  last_seen?: string | Date | null
-  connected?: boolean
-  sequence_file?: string | null
-  sequence_row_index?: number | null
-  current_raw_file?: string | null
-  method_elapsed_pct?: number | null
-}
-
 /** A state the platform derives for an instrument: its reported state, `never` (no report yet) or `inactive`. */
 export type InstrumentBadgeState = InstrumentState | 'never' | 'inactive'
 
@@ -91,7 +73,12 @@ export interface InstrumentLiveStatus {
   current_sample?: SampleInfo | null
   sequence_progress?: InstrumentLiveProgress | null
   has_unacknowledged_alerts: boolean
+  /** False when `latest_critical_at` is before `alerts_since`. */
   has_unacknowledged_critical: boolean
+  /** Time of the newest unacknowledged critical alert, as the plugin reported it (ISO 8601). */
+  latest_critical_at?: string | null
+  /** Start of the platform alert window (ISO 8601); null when the window is off. */
+  alerts_since?: string | null
   /** Server receive time of the latest report (ISO 8601). */
   last_seen: string
   /** When the state last changed (ISO 8601). */