@tai42/studio-sdk 20.0.0 → 22.0.0

package/dist/state-binding/adapter.js

@@ -3,9 +3,9 @@
  *
  * A named template `update` jq declares an input object (its `params` / declared
  * input keys). A binding must map the run's OUTPUT (and the run's INPUT) into that
- * object; that mapping is the `adapter` — a single jq program over `{ output, input }`
- * that CONSTRUCTS the update jq's declared input (which the update jq then reads as
- * `.input` alongside the record).
+ * object; that mapping is the `adapter` — a single jq program over the tool output
+ * (its `.`) with the run input bound as `$input`, that CONSTRUCTS the update jq's
+ * declared input (which the update jq then reads as `$input`, over the record).
  *
  * The editor authors the adapter as a ROW form: one row per declared input key,
  * each row picking one of three value sources — a picked field (from the run's
@@ -21,13 +21,19 @@ const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
 export function jqKey(key) {
     return IDENTIFIER.test(key) ? key : JSON.stringify(key);
 }
-/** A picked field rendered as a jq path, e.g. `.output.user.name` / `.input["odd key"]`. */
+/**
+ * A picked field rendered as a jq path: an output field reads off the program root
+ * (`.user.name`, `.["odd key"]`, the whole output `.`), an input field off the bound run
+ * input (`$input.user.name`, the whole input `$input`).
+ */
 export function fieldPathToJq(root, path) {
-    let out = `.${root}`;
+    let out = root === 'input' ? '$input' : '';
     for (const segment of path) {
-        out += IDENTIFIER.test(segment) ? `.${segment}` : `[${JSON.stringify(segment)}]`;
+        out += IDENTIFIER.test(segment)
+            ? `.${segment}`
+            : `${out === '' ? '.' : ''}[${JSON.stringify(segment)}]`;
     }
-    return out;
+    return out === '' ? '.' : out;
 }
 /** The jq fragment ONE row's value compiles to — the row's "show jq". */
 export function rowValueJq(source) {
@@ -58,7 +64,7 @@ export function rowValueJq(source) {
 }
 /**
  * Compile a mapping form into ONE adapter jq that constructs the update jq's
- * declared input over `{ output, input }`. An empty form compiles to the
+ * declared input over the tool output and `$input`. An empty form compiles to the
  * empty object `{}`; a blank target, a duplicate target, or an invalid source is a
  * loud error.
  */
@@ -93,7 +99,7 @@ export function defaultRowsForInput(params) {
 // `compileAdapter` emits a canonical, PARSEABLE shape so a stored adapter reopens as
 // the form it was authored in (never UI-only state): the object
 // `{ <key>: (<value>), … }` where `<key>` is a bare identifier or a JSON string and
-// `<value>` is one of — a field path `.output…` / `.input…`, a JSON literal, or a raw
+// `<value>` is one of — a field path `.…` (output) / `$input…` (input), a JSON literal, or a raw
 // jq expression. `parseAdapter` inverts it; `parse(compileAdapter(rows).jq) === rows`
 // for every row kind whose literal is already canonical JSON. A shape it does not
 // recognise returns `null` — the editor falls back to the raw-jq escape hatch.
@@ -102,11 +108,22 @@ const BRACKET_SEGMENT = /^\[("(?:[^"\\]|\\.)*")\]/;
 const ADAPTER_KEY = /^("(?:[^"\\]|\\.)*"|[A-Za-z_][A-Za-z0-9_]*)\s*:\s*\(/;
 /** Recover a field source from a pure path expression, or `null` if it is not one. */
 export function parseFieldPath(value) {
-    const head = /^\.(output|input)/.exec(value);
-    if (head === null)
+    let root;
+    let rest;
+    if (value === '.')
+        return { kind: 'field', root: 'output', path: [] };
+    if (value.startsWith('$input')) {
+        root = 'input';
+        rest = value.slice('$input'.length);
+    }
+    else if (value.startsWith('.')) {
+        root = 'output';
+        // A root bracket (`.["odd key"]`) drops its leading dot; a root key keeps it (`.a`).
+        rest = value.startsWith('.[') ? value.slice(1) : value;
+    }
+    else {
         return null;
-    const root = head[1];
-    let rest = value.slice(head[0].length);
+    }
     const path = [];
     while (rest.length > 0) {
         if (rest.startsWith('.')) {

package/dist/state-binding/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/state-binding/adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/state-binding/adapter.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tai42/studio-sdk",
-  "version": "20.0.0",
+  "version": "22.0.0",
   "description": "The Studio plugin contract, shared UI components, and hooks that every feature builds on.",
   "license": "Apache-2.0",
   "author": "tai42 <oss@tai42.ai>",
@@ -96,7 +96,7 @@
     "@radix-ui/react-select": "^2.3.2",
     "@radix-ui/react-tabs": "^1.1.21",
     "@radix-ui/react-tooltip": "^1.2.16",
-    "@tai42/api-client": "20.0.0"
+    "@tai42/api-client": "22.0.0"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json && node scripts/copy-assets.mjs",
@@ -104,7 +104,8 @@
     "lint": "eslint src scripts --max-warnings 0",
     "format:check": "prettier --check \"src/**/*.{ts,tsx,css}\" \"scripts/**/*.mjs\"",
     "test": "vitest run",
-    "api:check": "api-extractor run --config config/api-extractor.index.json && api-extractor run --config config/api-extractor.host.json && api-extractor run --config config/api-extractor.testing.json && api-extractor run --config config/api-extractor.schema-form.json",
-    "api:update": "api-extractor run --local --config config/api-extractor.index.json && api-extractor run --local --config config/api-extractor.host.json && api-extractor run --local --config config/api-extractor.testing.json && api-extractor run --local --config config/api-extractor.schema-form.json"
+    "api:build": "tsc -b tsconfig.build.json --clean && pnpm run build",
+    "api:check": "pnpm run api:build && api-extractor run --config config/api-extractor.index.json && api-extractor run --config config/api-extractor.host.json && api-extractor run --config config/api-extractor.testing.json && api-extractor run --config config/api-extractor.schema-form.json",
+    "api:update": "pnpm run api:build && api-extractor run --local --config config/api-extractor.index.json && api-extractor run --local --config config/api-extractor.host.json && api-extractor run --local --config config/api-extractor.testing.json && api-extractor run --local --config config/api-extractor.schema-form.json"
   }
 }

package/src/components/chip-group.tsx

@@ -0,0 +1,157 @@
+/**
+ * `ChipGroup` — a tap-to-select grid of pill chips (`.tai-chip`), in two modes.
+ *
+ * `single` is a `role="radiogroup"` of `role="radio"` chips carrying `aria-checked`:
+ * exactly one value is selected, the arrow keys move the selection, and only the
+ * selected chip (or the first, when none is) sits in the tab order. `multi` is a
+ * group of toggle buttons carrying `aria-pressed`: any number are selected, the
+ * arrow keys move focus, and Space/Enter (the native button activation) toggles the
+ * focused chip.
+ *
+ * Roving tabindex and arrow-key movement are owned here — there is no multi-select
+ * primitive to borrow — so both modes share one keyboard model: ←/↑ to the previous
+ * chip, →/↓ to the next (wrapping), Home/End to the ends, skipping disabled chips.
+ * The handler rides each chip (a button, an interactive element) rather than the
+ * container, so no static element carries an interaction. Like `RadioGroup`, the
+ * group takes its accessible name from an enclosing group `Field`, not a label of
+ * its own.
+ */
+import type { KeyboardEvent, ReactNode } from 'react';
+import { useRef, useState } from 'react';
+
+import { useFieldControl } from './field';
+
+/** One selectable chip: its answer `value` and the visible `label`. */
+export interface ChipOption {
+  readonly value: string;
+  readonly label: string;
+  readonly disabled?: boolean;
+}
+
+export type ChipGroupProps =
+  | {
+      /** Exactly one value selected — a `radiogroup` of radios. */
+      readonly mode: 'single';
+      readonly options: readonly ChipOption[];
+      readonly value: string;
+      readonly onValueChange: (value: string) => void;
+      readonly disabled?: boolean;
+    }
+  | {
+      /** Any number selected — a group of `aria-pressed` toggle buttons. */
+      readonly mode: 'multi';
+      readonly options: readonly ChipOption[];
+      readonly value: readonly string[];
+      readonly onValueChange: (value: readonly string[]) => void;
+      readonly disabled?: boolean;
+    };
+
+export function ChipGroup(props: ChipGroupProps): ReactNode {
+  const { options, disabled = false } = props;
+  const field = useFieldControl();
+  const chipRefs = useRef<(HTMLButtonElement | null)[]>([]);
+
+  const isSelected = (option: ChipOption): boolean =>
+    props.mode === 'single' ? props.value === option.value : props.value.includes(option.value);
+
+  // The chip in the tab order: the (first) selected one, else the first enabled
+  // one — so Tab lands on the active choice and the arrows rove from there.
+  const [rovingIndex, setRovingIndex] = useState<number>(() => {
+    const selected = options.findIndex(isSelected);
+    if (selected >= 0) return selected;
+    const firstEnabled = options.findIndex((option) => option.disabled !== true);
+    return firstEnabled >= 0 ? firstEnabled : 0;
+  });
+
+  const enabledIndices = options
+    .map((option, index) => (option.disabled === true ? -1 : index))
+    .filter((index) => index >= 0);
+
+  const focusChip = (index: number): void => {
+    setRovingIndex(index);
+    chipRefs.current[index]?.focus();
+  };
+
+  const select = (option: ChipOption): void => {
+    if (props.mode === 'single') {
+      props.onValueChange(option.value);
+      return;
+    }
+    const chosen = new Set(props.value);
+    if (chosen.has(option.value)) chosen.delete(option.value);
+    else chosen.add(option.value);
+    // Keep the OPTIONS' declared order, so the emitted array reads the way the form
+    // lists the choices rather than the order the chips were pressed.
+    props.onValueChange(options.map((candidate) => candidate.value).filter((v) => chosen.has(v)));
+  };
+
+  const onChipKeyDown = (event: KeyboardEvent<HTMLButtonElement>): void => {
+    if (disabled || enabledIndices.length === 0) return;
+    const position = enabledIndices.indexOf(rovingIndex);
+    let nextPosition: number;
+    switch (event.key) {
+      case 'ArrowRight':
+      case 'ArrowDown':
+        nextPosition = (position + 1) % enabledIndices.length;
+        break;
+      case 'ArrowLeft':
+      case 'ArrowUp':
+        nextPosition = (position - 1 + enabledIndices.length) % enabledIndices.length;
+        break;
+      case 'Home':
+        nextPosition = 0;
+        break;
+      case 'End':
+        nextPosition = enabledIndices.length - 1;
+        break;
+      default:
+        return;
+    }
+    event.preventDefault();
+    const nextIndex = enabledIndices[nextPosition];
+    if (nextIndex === undefined) return;
+    const nextOption = options[nextIndex];
+    if (nextOption === undefined) return;
+    focusChip(nextIndex);
+    // A radiogroup selects as it moves; a multi-select group only moves focus and
+    // leaves Space/Enter to toggle.
+    if (props.mode === 'single') props.onValueChange(nextOption.value);
+  };
+
+  return (
+    <div
+      role={props.mode === 'single' ? 'radiogroup' : 'group'}
+      className="tai-row"
+      aria-describedby={field['aria-describedby']}
+    >
+      {options.map((option, index) => {
+        const selected = isSelected(option);
+        return (
+          <button
+            key={option.value}
+            ref={(element) => {
+              chipRefs.current[index] = element;
+            }}
+            type="button"
+            className="tai-chip"
+            role={props.mode === 'single' ? 'radio' : undefined}
+            aria-checked={props.mode === 'single' ? selected : undefined}
+            aria-pressed={props.mode === 'multi' ? selected : undefined}
+            // `role="group"` does not support `aria-invalid` (ARIA 1.2), so the
+            // chips carry the enclosing errored Field's invalid state.
+            aria-invalid={field['aria-invalid']}
+            tabIndex={index === rovingIndex ? 0 : -1}
+            disabled={disabled || option.disabled === true}
+            onClick={() => {
+              focusChip(index);
+              select(option);
+            }}
+            onKeyDown={onChipKeyDown}
+          >
+            {option.label}
+          </button>
+        );
+      })}
+    </div>
+  );
+}

package/src/components/components.css

@@ -1061,11 +1061,16 @@
       color var(--tai-motion-fast) ease;
   }
 
-  .tai-chip:not(.tai-chip-static):not([aria-pressed='true']):hover:not(:disabled) {
+  .tai-chip:not(.tai-chip-static):not([aria-pressed='true']):not([aria-checked='true']):hover:not(
+      :disabled
+    ) {
     background: var(--tai-color-surface);
   }
 
-  .tai-chip[aria-pressed='true'] {
+  /* A selected chip, pressed (a multi-select toggle) OR checked (a single-select
+     radio chip): both wear the accent tint. */
+  .tai-chip[aria-pressed='true'],
+  .tai-chip[aria-checked='true'] {
     background: var(--tai-color-accent-tint);
     border-color: var(--tai-color-accent);
     color: var(--tai-color-accent-on-tint);
@@ -1073,7 +1078,8 @@
 
   /* A selected chip KEEPS its tint on hover and strengthens its border instead —
      the one part that moves in both themes (see the segment rule above). */
-  .tai-chip[aria-pressed='true']:hover:not(:disabled) {
+  .tai-chip[aria-pressed='true']:hover:not(:disabled),
+  .tai-chip[aria-checked='true']:hover:not(:disabled) {
     border-color: var(--tai-color-accent-hover);
   }
 
@@ -2075,6 +2081,13 @@
     border-bottom: 1px solid var(--tai-color-border);
   }
 
+  /* The bar already pads its edges, so the brand drops its own inline padding here:
+     at 320 px the brand, the three-option theme switch and the menu button then fit
+     on one row, and the switch never wraps into a box taller than the bar. */
+  .tai-topbar .tai-brand {
+    padding-inline: 0;
+  }
+
   /* -- Master / detail ---------------------------------------------------------------
      `data-pane` drives the layout at every width: `list` gives the list the full
      width with no empty detail pane; `detail` shows a balanced two-pane split.

package/src/components/execution-key-picker.tsx

@@ -39,7 +39,7 @@ export function isExecutionKeyListEmpty(query: ExecutionKeyQuery): boolean {
 function keyFingerprint(key: TokensPayload[number]): string | undefined {
   const data = key.policy_data;
   if (typeof data !== 'object' || data === null) return undefined;
-  const value = (data as Record<string, unknown>).key_fingerprint;
+  const value = data.key_fingerprint;
   return typeof value === 'string' ? value : undefined;
 }
 

package/src/components/extension-grouping.ts

@@ -4,26 +4,19 @@
  * `ExtensionPicker`. Kept free of React so the grouping logic is unit-tested
  * directly.
  *
- * The `/api/extensions` catalog is a flat list of `{ name, kind }` entries. Two
+ * The `/api/extensions` catalog is a flat list of `{ name, kind, multiple }` entries. Two
  * independent groupings live here:
  *  - `groupIntoFamilies` groups a tool's composed branch VARIANTS (which share a
  *    base tool name and append underscore suffixes — `tool`, `tool_a`, `tool_a_b`)
  *    back into one FAMILY keyed by that base name (the catalog view);
- *  - `groupByKind` groups the catalog by extension KIND (the picker view), where
- *    the `backend` kind is the single non-stackable one.
+ *  - `groupByKind` groups the catalog by extension KIND (the picker view), each
+ *    group carrying the served `multiple` flag of its kind.
  * `kindVariant` maps each serialized `kind` value to a design-system Badge variant.
  */
 import type { Extension } from '@tai42/api-client';
 
 import type { BadgeProps } from './badge';
 
-/**
- * The single non-stackable extension kind: at most one `backend` extension may
- * appear in a combo (the `backend` kind is declared non-stackable, `multiple=False`).
- * The `ExtensionPicker` enforces single-select for this kind.
- */
-export const NON_STACKABLE_KIND = 'backend';
-
 /** One base tool and every extension entry that branches from it. */
 export interface ExtensionFamily {
   /** The base tool name (the segment before the first underscore). */
@@ -36,8 +29,9 @@ export interface ExtensionFamily {
 export interface ExtensionKindGroup {
   /** The serialized kind value (`wrapper` / `transformer` / `backend`). */
   readonly kind: string;
-  /** Whether this kind is non-stackable (single-select in the picker). */
-  readonly nonStackable: boolean;
+  /** Whether a combo may carry several extensions of this kind; `false` is single-select
+   *  in the picker. Served per kind by the catalog. */
+  readonly multiple: boolean;
   /** The kind's entries, ordered by name. */
   readonly members: readonly Extension[];
 }
@@ -79,23 +73,29 @@ export function groupIntoFamilies(extensions: readonly Extension[]): ExtensionFa
 /**
  * Group a flat extension list by `kind`, for the picker. Groups are ordered by
  * kind and each group's members by name, so the render order is stable regardless
- * of the server's list order. The `backend` group is flagged non-stackable.
+ * of the server's list order. Each group carries its kind's served `multiple`; a kind
+ * whose entries disagree is a catalog fault and throws.
  */
 export function groupByKind(extensions: readonly Extension[]): ExtensionKindGroup[] {
-  const byKind = new Map<string, Extension[]>();
+  const byKind = new Map<string, { multiple: boolean; members: Extension[] }>();
   for (const extension of extensions) {
-    const members = byKind.get(extension.kind);
-    if (members) {
-      members.push(extension);
-    } else {
-      byKind.set(extension.kind, [extension]);
+    const group = byKind.get(extension.kind);
+    if (group === undefined) {
+      byKind.set(extension.kind, { multiple: extension.multiple, members: [extension] });
+      continue;
     }
+    if (group.multiple !== extension.multiple) {
+      throw new Error(
+        `extension kind ${extension.kind} is served as both single- and multi-select`,
+      );
+    }
+    group.members.push(extension);
   }
   return [...byKind.entries()]
-    .map(([kind, members]) => ({
+    .map(([kind, group]) => ({
       kind,
-      nonStackable: kind === NON_STACKABLE_KIND,
-      members: [...members].sort((a, b) => a.name.localeCompare(b.name)),
+      multiple: group.multiple,
+      members: [...group.members].sort((a, b) => a.name.localeCompare(b.name)),
     }))
     .sort((a, b) => a.kind.localeCompare(b.kind));
 }

package/src/components/extension-picker.tsx

@@ -6,10 +6,9 @@
  * live in the SDK). It is PRESENTATIONAL: the caller fetches `available` and owns
  * the selected `value`; this component fetches nothing.
  *
- * The catalog is GROUPED by `kind`. The `backend` kind is the single NON-STACKABLE
- * one (`multiple=False`), so it is SINGLE-SELECT — checking a backend
- * extension replaces any other backend already in the combo; every other kind is
- * freely multi-select. Selection order is preserved (the combo is ordered — the
+ * The catalog is GROUPED by `kind`. A kind the catalog serves as not `multiple` is
+ * SINGLE-SELECT — checking one of its extensions replaces any other of that kind
+ * already in the combo; a `multiple` kind is freely multi-select. Selection order is preserved (the combo is ordered — the
  * stacking order that produces the branch tool name), so a newly-checked extension
  * appends to the end and unchecking removes in place.
  *
@@ -60,20 +59,20 @@ export function ExtensionPicker({
   }
 
   /**
-   * Toggle a single extension. For a NON-STACKABLE kind (`backend`), checking one
-   * first strips any other selected member of that kind before appending, so the
-   * combo carries at most one backend; unchecking just removes it. Order is
-   * preserved: a newly-checked name lands at the end.
+   * Toggle a single extension. For a kind the catalog serves as not `multiple`,
+   * checking one first strips any other selected member of that kind before
+   * appending, so the combo carries at most one of it; unchecking just removes it.
+   * Order is preserved: a newly-checked name lands at the end.
    */
-  const toggle = (extension: Extension, nonStackable: boolean, checked: boolean): void => {
+  const toggle = (extension: Extension, multiple: boolean, checked: boolean): void => {
     if (!checked) {
       onChange(value.filter((name) => name !== extension.name));
       return;
     }
     if (selected.has(extension.name)) return;
-    const siblingNames = nonStackable
-      ? new Set(available.filter((e) => e.kind === extension.kind).map((e) => e.name))
-      : undefined;
+    const siblingNames = multiple
+      ? undefined
+      : new Set(available.filter((e) => e.kind === extension.kind).map((e) => e.name));
     const kept =
       siblingNames === undefined ? [...value] : value.filter((name) => !siblingNames.has(name));
     onChange([...kept, extension.name]);
@@ -87,7 +86,7 @@ export function ExtensionPicker({
               and the single-select qualifier rides beside it as secondary text. */}
           <div className="tai-row">
             <Badge variant={kindVariant(group.kind)}>{group.kind}</Badge>
-            {group.nonStackable ? <span className="tai-muted">(single-select)</span> : null}
+            {group.multiple ? null : <span className="tai-muted">(single-select)</span>}
           </div>
           <div className="tai-row">
             {group.members.map((extension) => (
@@ -97,7 +96,7 @@ export function ExtensionPicker({
                 checked={selected.has(extension.name)}
                 disabled={disabled}
                 onCheckedChange={(checked) => {
-                  toggle(extension, group.nonStackable, checked);
+                  toggle(extension, group.multiple, checked);
                 }}
               />
             ))}

package/src/components/fleet-report.tsx

@@ -14,8 +14,8 @@
  * framing and points the operator back at re-running the deregister, because a
  * reload would re-attach the very server being detached — the wrong remediation.
  *
- * A `converged` summary (every worker applied, or a lone-worker local-only change)
- * renders NOTHING — the calling surface shows its own success. A `degraded` summary
+ * A `converged` summary (every worker applied, or a lone-worker local-only change) with
+ * no worker awaiting a respawn renders NOTHING — the calling surface shows its own success. A `degraded` summary
  * (the bus was reached but a sibling did not confirm) or an `unreachable` summary (the
  * bus itself failed) renders a loud `role="alert"` panel naming the honest per-worker
  * outcomes: `failed` / `missing` / `departed` / `timed_out` / `resyncing` / `recycling` /
@@ -23,6 +23,10 @@
  * server-supplied string (a worker name, an error/detail message) renders as escaped
  * React text, never an HTML sink.
  *
+ * Whatever the status, a worker whose reload named recycle-class settings awaiting a
+ * respawn is listed in a warning status panel beside it: the reload applied every other
+ * change, and those settings take effect only when that worker restarts.
+ *
  * Every state — the headline and each worker's outcome — is a `tai-status` line: an
  * icon MARK plus a word LABEL, with the tone color only reinforcing them, so the
  * report is readable without color perception.
@@ -30,6 +34,7 @@
 import type {
   FleetFailureOutcome,
   FleetReportSummary,
+  FleetWorkerAwaitingRespawn,
   FleetWorkerFailure,
 } from '@tai42/api-client';
 import type { ReactNode } from 'react';
@@ -74,9 +79,10 @@ const OUTCOME_STATUS: Record<FleetFailureOutcome, StatusTone> = {
 };
 
 /**
- * Render a fleet broadcast's failure state. Returns `null` for a converged/absent
- * report (nothing to warn about) so callers can always mount it unconditionally
- * beside their own success line.
+ * Render a fleet broadcast's failure state and its workers awaiting a respawn. Returns
+ * `null` for an absent report or a converged one with no worker awaiting a respawn
+ * (nothing to warn about) so callers can always mount it unconditionally beside their
+ * own success line.
  */
 export interface FleetReportProps {
   readonly summary: FleetReportSummary | null;
@@ -193,8 +199,50 @@ function DegradedReport({
   );
 }
 
-export function FleetReport({ summary, action = 'save' }: FleetReportProps): ReactNode {
-  if (summary === null || summary.status === 'converged') return null;
+/**
+ * The panel for workers whose reload named recycle-class settings awaiting a respawn:
+ * the reload applied everything else, and these take effect only when the worker
+ * restarts. Guidance the operator acts on, not a failure, so it is a warning status
+ * rather than an alert.
+ */
+function AwaitingRespawnReport({
+  awaiting,
+}: {
+  readonly awaiting: readonly FleetWorkerAwaitingRespawn[];
+}): ReactNode {
+  const count = awaiting.length;
+  return (
+    <div role="status" className="tai-warn-state tai-stack tai-stack-2">
+      <strong className="tai-status tai-status-warn">
+        <AlertTriangleIcon />
+        {`${String(count)} worker${count === 1 ? ' needs' : 's need'} a restart to apply some settings`}
+      </strong>
+      <p>
+        These settings changed in the stored environment after the worker started. The reload
+        applied every other change; these take effect only when the worker restarts. Restart it
+        through your deployment&rsquo;s supervisor (on a bare server, restart the server).
+      </p>
+      <ul className="tai-stack tai-stack-2">
+        {awaiting.map((worker) => (
+          <li key={worker.name} className="tai-row">
+            <span className="tai-mono">{worker.name}</span>
+            <span className="tai-muted">waits for a restart:</span>
+            <span className="tai-mono">{worker.keys.join(', ')}</span>
+          </li>
+        ))}
+      </ul>
+    </div>
+  );
+}
+
+function FailureReport({
+  summary,
+  action,
+}: {
+  readonly summary: FleetReportSummary;
+  readonly action: FleetAction;
+}): ReactNode {
+  if (summary.status === 'converged') return null;
 
   // Only a saved config change carries the "Change saved" framing; a reload or a
   // deregister saved nothing.
@@ -218,3 +266,14 @@ export function FleetReport({ summary, action = 'save' }: FleetReportProps): Rea
     />
   );
 }
+
+export function FleetReport({ summary, action = 'save' }: FleetReportProps): ReactNode {
+  if (summary === null) return null;
+  if (summary.status === 'converged' && summary.awaiting.length === 0) return null;
+  return (
+    <>
+      <FailureReport summary={summary} action={action} />
+      {summary.awaiting.length > 0 ? <AwaitingRespawnReport awaiting={summary.awaiting} /> : null}
+    </>
+  );
+}