@marinoscar/platform-web 0.1.0-next.3 → 0.1.0-next.5

package/dist/nodes/ui/NodeVitalsDialog.d.ts

@@ -0,0 +1,48 @@
+/**
+ * A worker node's full vitals snapshot (issue #606) — the detail behind the
+ * fleet table's compact "Vitals" cell.
+ *
+ * Opened from the "View vitals" row action on `WorkersPage.tsx`,
+ * so it is reachable from the desktop grid, the tablet expander and the phone
+ * card from one declaration, for every `nodes:read` holder (reading vitals is
+ * not a write).
+ *
+ * The page hands this dialog the CURRENT row on every render, not a copy taken
+ * when it opened, so the fleet poll keeps it live: an operator watching a node
+ * drain sees its slots fall without closing and reopening anything.
+ *
+ * ACCESSIBILITY: every bar is a `progressbar` with an accessible name and an
+ * `aria-valuetext` that states the reading in words, and the same reading is
+ * printed beside it — no value is carried by bar length or colour alone.
+ * Stale vitals are said in words (an `Alert`), not just greyed.
+ */
+import type { PageSlot } from '../../core/index.js';
+import type { NodeVitalsCounters, WorkerNode } from '../headless/index.js';
+interface NodeVitalsDialogProps {
+    /** The row to show, or `null` when closed. */
+    node: WorkerNode | null;
+    /** The page's single render clock — see `WorkersPage.tsx`. */
+    now: Date;
+    onClose: () => void;
+    /** The page's `slots.VitalsPanel`: extra content after the vitals. */
+    VitalsPanel?: PageSlot<NodeVitalsPanelSlotProps>;
+}
+/**
+ * What the Worker Nodes page passes its `VitalsPanel` slot: the node whose
+ * vitals dialog is open, as the fleet poll last read it (it updates while the
+ * dialog stays open).
+ *
+ * @stability experimental
+ */
+export interface NodeVitalsPanelSlotProps {
+    /** The node the dialog describes. */
+    node: WorkerNode;
+}
+/** The counters shown, in reading order, with the words an operator uses. */
+export declare const VITALS_COUNTER_ROWS: {
+    key: keyof NodeVitalsCounters;
+    label: string;
+}[];
+export declare function NodeVitalsDialog({ node, now, onClose, VitalsPanel }: NodeVitalsDialogProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=NodeVitalsDialog.d.ts.map

package/dist/nodes/ui/NodeVitalsDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeVitalsDialog.d.ts","sourceRoot":"","sources":["../../../src/nodes/ui/NodeVitalsDialog.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAwBH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAe3E,UAAU,qBAAqB;IAC7B,8CAA8C;IAC9C,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,8DAA8D;IAC9D,GAAG,EAAE,IAAI,CAAC;IACV,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,sEAAsE;IACtE,WAAW,CAAC,EAAE,QAAQ,CAAC,wBAAwB,CAAC,CAAC;CAClD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,qCAAqC;IACrC,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,EAAE;IAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAWjF,CAAC;AAsDF,wBAAgB,gBAAgB,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,qBAAqB,+BAsM1F"}

package/dist/nodes/ui/NodeVitalsDialog.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * A worker node's full vitals snapshot (issue #606) — the detail behind the
+ * fleet table's compact "Vitals" cell.
+ *
+ * Opened from the "View vitals" row action on `WorkersPage.tsx`,
+ * so it is reachable from the desktop grid, the tablet expander and the phone
+ * card from one declaration, for every `nodes:read` holder (reading vitals is
+ * not a write).
+ *
+ * The page hands this dialog the CURRENT row on every render, not a copy taken
+ * when it opened, so the fleet poll keeps it live: an operator watching a node
+ * drain sees its slots fall without closing and reopening anything.
+ *
+ * ACCESSIBILITY: every bar is a `progressbar` with an accessible name and an
+ * `aria-valuetext` that states the reading in words, and the same reading is
+ * printed beside it — no value is carried by bar length or colour alone.
+ * Stale vitals are said in words (an `Alert`), not just greyed.
+ */
+import { Alert, Box, Button, Dialog, DialogActions, DialogContent, DialogTitle, LinearProgress, Stack, Table, TableBody, TableCell, TableHead, TableRow, Tooltip, Typography, useMediaQuery, useTheme, } from '@mui/material';
+import { useId } from 'react';
+import { formatDateTime, nodeCapabilityItems, nodeVitalRows } from '../headless/index.js';
+import { areVitalsStale, diskFreeRatio, formatBytes, formatCpu, formatEventLoopDelay, formatOptionalBytes, formatPercent, formatUptime, formatVitalsReported, isLowDisk, ratio, } from './workerVitals.js';
+/** The counters shown, in reading order, with the words an operator uses. */
+export const VITALS_COUNTER_ROWS = [
+    { key: 'claims', label: 'Claims' },
+    { key: 'succeeded', label: 'Succeeded' },
+    { key: 'failed', label: 'Failed' },
+    { key: 'rateLimited', label: 'Rate limited' },
+    { key: 'emptyPolls', label: 'Empty polls' },
+    { key: 'claimFailures', label: 'Claim failures' },
+    { key: 'leaseRenewals', label: 'Lease renewals' },
+    { key: 'leaseRenewFailures', label: 'Lease renew failures' },
+    { key: 'heartbeatFailures', label: 'Heartbeat failures' },
+    { key: 'watchdogTrips', label: 'Watchdog trips' },
+];
+function Field({ label, children }) {
+    return (_jsxs(Box, { sx: { minWidth: 160, flexGrow: 1 }, children: [_jsx(Typography, { variant: "caption", color: "text.secondary", sx: { display: 'block' }, children: label }), _jsx(Typography, { variant: "body2", component: "div", sx: { mt: 0.25 }, children: children })] }));
+}
+function Meter({ label, fraction, text, warning = false }) {
+    const id = useId();
+    return (_jsxs(Box, { sx: { minWidth: 200, flexGrow: 1, flexBasis: 200 }, children: [_jsxs(Stack, { direction: "row", sx: { justifyContent: 'space-between', gap: 1 }, children: [_jsx(Typography, { id: id, variant: "caption", color: "text.secondary", children: label }), _jsx(Typography, { variant: "caption", sx: { fontWeight: 600 }, children: text })] }), fraction !== null && (_jsx(LinearProgress, { variant: "determinate", value: Math.min(100, Math.max(0, fraction * 100)), color: warning ? 'warning' : 'primary', "aria-labelledby": id, "aria-valuetext": text, sx: { mt: 0.5, height: 6, borderRadius: 3 } }))] }));
+}
+function formatCount(value) {
+    return value === undefined ? '—' : value.toLocaleString();
+}
+export function NodeVitalsDialog({ node, now, onClose, VitalsPanel }) {
+    const theme = useTheme();
+    // The same `down('sm')` compact-window read the settings UI uses (CLAUDE.md
+    // rule 5): a full screen on a phone rather than a dialog that scrolls inside
+    // a scroll.
+    const isCompactWindow = useMediaQuery(theme.breakpoints.down('sm'));
+    const titleId = useId();
+    const vitals = node?.lastVitals ?? null;
+    const stale = node ? areVitalsStale(node) : false;
+    const reported = node ? formatVitalsReported(node.lastVitalsAt, now) : null;
+    const heap = vitals ? ratio(vitals.heapUsedBytes, vitals.heapLimitBytes) : null;
+    const diskFree = vitals ? diskFreeRatio(vitals) : null;
+    const slots = vitals ? ratio(vitals.slotsUsed, vitals.slotsTotal) : null;
+    const lowDisk = isLowDisk(vitals);
+    // App-defined vitals (`vitals.extra`) and the node's reported capabilities:
+    // both self-reported and bounded, both printed as plain text.
+    const extraRows = vitals ? nodeVitalRows(vitals.extra) : [];
+    const capabilities = node ? nodeCapabilityItems(node.capabilities) : [];
+    return (_jsxs(Dialog, { open: node !== null, onClose: onClose, fullWidth: true, maxWidth: "md", fullScreen: isCompactWindow, "aria-labelledby": titleId, children: [_jsx(DialogTitle, { id: titleId, children: node ? `Vitals — ${node.name} (${node.hostname})` : 'Vitals' }), _jsxs(DialogContent, { dividers: true, children: [node && !vitals && (_jsx(Typography, { color: "text.secondary", "data-testid": "node-vitals-empty", children: "This node has not reported vitals yet. Nodes running an older CLI do not send them. Its health is still derived from its heartbeat." })), node && vitals && (_jsxs(Stack, { spacing: 3, children: [_jsxs(Box, { children: [reported && (_jsx(Tooltip, { title: formatDateTime(node.lastVitalsAt), children: _jsx(Typography, { variant: "body2", color: "text.secondary", component: "span", children: reported }) })), stale && (_jsxs(Alert, { severity: "warning", sx: { mt: 1 }, children: ["This node is ", node.health, ": these are the last vitals it sent and may no longer describe it."] }))] }), _jsxs(Stack, { direction: "row", spacing: 3, useFlexGap: true, sx: { flexWrap: 'wrap' }, children: [_jsx(Meter, { label: "Heap used", fraction: heap, text: heap !== null
+                                            ? `${formatBytes(vitals.heapUsedBytes)} of ${formatBytes(vitals.heapLimitBytes)} (${formatPercent(heap)})`
+                                            : formatOptionalBytes(vitals.heapUsedBytes) }), _jsx(Meter, { label: "State directory disk used", fraction: diskFree !== null ? 1 - diskFree : null, warning: lowDisk, text: diskFree !== null
+                                            ? `${formatBytes(vitals.stateDirFreeBytes)} free of ${formatBytes(vitals.stateDirTotalBytes)} (${formatPercent(diskFree)} free${lowDisk ? ', low' : ''})`
+                                            : formatOptionalBytes(vitals.stateDirFreeBytes) }), _jsx(Meter, { label: "Job slots in use", fraction: slots, text: slots !== null
+                                            ? `${vitals.slotsUsed} of ${vitals.slotsTotal} (${formatPercent(slots)})`
+                                            : '—' })] }), _jsxs(Stack, { direction: "row", spacing: 2, useFlexGap: true, sx: { flexWrap: 'wrap' }, children: [_jsx(Field, { label: "CPU", children: formatCpu(vitals.cpuPercent) }), _jsx(Field, { label: "Resident memory (RSS)", children: formatOptionalBytes(vitals.rssBytes) }), _jsx(Field, { label: "Event-loop delay p99", children: formatEventLoopDelay(vitals.eventLoopDelayP99Ms) }), _jsx(Field, { label: "Uptime", children: formatUptime(vitals.uptimeSeconds) })] }), _jsxs(Stack, { direction: "row", spacing: 2, useFlexGap: true, sx: { flexWrap: 'wrap' }, children: [_jsx(Field, { label: "CLI version", children: vitals.cliVersion ?? '—' }), _jsx(Field, { label: "Node.js version", children: vitals.nodeVersion ?? '—' }), _jsx(Field, { label: "pg_dump version", children: vitals.pgDumpVersion ?? '—' })] }), extraRows.length > 0 && (_jsxs(Box, { children: [_jsx(Typography, { variant: "subtitle2", component: "h3", gutterBottom: true, children: "Reported by this node's app" }), _jsxs(Table, { size: "small", "aria-label": "App vitals", children: [_jsx(TableHead, { children: _jsxs(TableRow, { children: [_jsx(TableCell, { children: "Vital" }), _jsx(TableCell, { align: "right", children: "Value" })] }) }), _jsx(TableBody, { children: extraRows.map(({ key, label, text }) => (_jsxs(TableRow, { children: [_jsx(TableCell, { component: "th", scope: "row", children: label }), _jsx(TableCell, { align: "right", children: text })] }, key))) })] })] })), _jsxs(Box, { children: [_jsx(Typography, { variant: "subtitle2", component: "h3", gutterBottom: true, children: "Counters since the node process started" }), _jsxs(Table, { size: "small", "aria-label": "Node counters", children: [_jsx(TableHead, { children: _jsxs(TableRow, { children: [_jsx(TableCell, { children: "Counter" }), _jsx(TableCell, { align: "right", children: "Count" })] }) }), _jsx(TableBody, { children: VITALS_COUNTER_ROWS.map(({ key, label }) => (_jsxs(TableRow, { children: [_jsx(TableCell, { component: "th", scope: "row", children: label }), _jsx(TableCell, { align: "right", children: formatCount(vitals.counters?.[key]) })] }, key))) })] })] })] })), node && capabilities.length > 0 && (_jsxs(Box, { sx: { mt: vitals ? 3 : 0 }, children: [_jsx(Typography, { variant: "subtitle2", component: "h3", id: `${titleId}-capabilities`, gutterBottom: true, children: "Capabilities reported by this node" }), _jsx(Box, { component: "ul", "aria-labelledby": `${titleId}-capabilities`, sx: { m: 0, pl: 2.5, typography: 'body2' }, "data-testid": "node-capabilities", children: capabilities.map(({ key, version }) => (_jsxs("li", { children: [key, version !== undefined && (_jsxs(Typography, { component: "span", variant: "body2", color: "text.secondary", children: [' ', "\u2014 ", version] }))] }, key))) })] })), node && VitalsPanel && (_jsx(Box, { component: "section", "aria-label": "Additional vitals", sx: { mt: 3 }, children: _jsx(VitalsPanel, { node: node }) }))] }), _jsx(DialogActions, { children: _jsx(Button, { onClick: onClose, children: "Close" }) })] }));
+}
+//# sourceMappingURL=NodeVitalsDialog.js.map

package/dist/nodes/ui/NodeVitalsDialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeVitalsDialog.js","sourceRoot":"","sources":["../../../src/nodes/ui/NodeVitalsDialog.tsx"],"names":[],"mappings":"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"}

package/dist/nodes/ui/PageHeader.d.ts

@@ -0,0 +1,23 @@
+import type { ReactElement, ReactNode } from 'react';
+/**
+ * What the worker-node page hands its `slots.Header`.
+ *
+ * @stability experimental
+ */
+export interface NodesPageHeaderProps {
+    /** The page title (the card's title). */
+    title: string;
+    /** The page subtitle (the card's description). */
+    description: string;
+    /** The viewer lacks the page's write permission (`jobs:write` or `nodes:write`). */
+    readOnly: boolean;
+    /**
+     * The page's header-level actions: always `null` here, because the page keeps
+     * its buttons in the body. Present so the props extend the page-slot
+     * contract's `PageHeaderSlotProps`.
+     */
+    actions: ReactNode;
+}
+/** The default header: `h1`, then the subtitle (and " (read-only)"). */
+export declare function DefaultPageHeader({ title, description, readOnly }: NodesPageHeaderProps): ReactElement;
+//# sourceMappingURL=PageHeader.d.ts.map

package/dist/nodes/ui/PageHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageHeader.d.ts","sourceRoot":"","sources":["../../../src/nodes/ui/PageHeader.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGrD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,OAAO,EAAE,SAAS,CAAC;CACpB;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,oBAAoB,GAAG,YAAY,CAYtG"}

package/dist/nodes/ui/PageHeader.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Typography } from '@mui/material';
+/** The default header: `h1`, then the subtitle (and " (read-only)"). */
+export function DefaultPageHeader({ title, description, readOnly }) {
+    return (_jsxs(_Fragment, { children: [_jsx(Typography, { variant: "h4", component: "h1", gutterBottom: true, children: title }), _jsxs(Typography, { color: "text.secondary", sx: { mb: 3 }, children: [description, readOnly && ' (read-only)'] })] }));
+}
+//# sourceMappingURL=PageHeader.js.map

package/dist/nodes/ui/PageHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageHeader.js","sourceRoot":"","sources":["../../../src/nodes/ui/PageHeader.tsx"],"names":[],"mappings":";AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAsB3C,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAwB;IACtF,OAAO,CACL,8BACE,KAAC,UAAU,IAAC,OAAO,EAAC,IAAI,EAAC,SAAS,EAAC,IAAI,EAAC,YAAY,kBACjD,KAAK,GACK,EACb,MAAC,UAAU,IAAC,KAAK,EAAC,gBAAgB,EAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,aAC7C,WAAW,EACX,QAAQ,IAAI,cAAc,IAChB,IACZ,CACJ,CAAC;AACJ,CAAC"}

package/dist/nodes/ui/WorkersPage.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Admin → Operations → Worker Nodes (`/admin/settings/workers`).
+ *
+ * Issue #271, epic #254; moved into `@marinoscar/platform-web/jobs` by #854, then into `@marinoscar/platform-web/nodes` by #881
+ * from the reference app's `pages/Admin/WorkersPage.tsx`, same DOM and styles.
+ * A REGISTRY CARD and nothing else, per CLAUDE.md's MANDATORY Settings UI
+ * Pattern: one entry in the app's `ADMIN_SECTIONS` (spread from
+ * `jobsAdminSections.operations`), one route gated on the same permission
+ * string the API enforces, and no tab anywhere. The hub, the Console rail and the compact
+ * AppBar title all pick this page up from that single declaration.
+ *
+ * A fleet an operator cannot see is a fleet they cannot trust, and the two
+ * questions they actually have are:
+ *
+ *   1. "Is every worker alive and doing something?" — the fleet table.
+ *   2. "Which credentials exist, and can I kill one right now?" — the
+ *      credentials section BELOW IT, on this same page.
+ *
+ * =============================================================================
+ * WHY CREDENTIALS ARE A SECTION HERE AND NOT A SECOND REGISTRY CARD
+ * =============================================================================
+ *
+ * Because the second question is an INCIDENT-RESPONSE action and must not
+ * require a shell — or, for the same reason, a navigation. CLAUDE.md's rule is
+ * that a destination gate is about REACHABILITY and a gate inside a page is
+ * about CONTENT; credentials are content of "the machines attached to this
+ * deployment". `NodeCredentials.tsx` carries the full
+ * argument, including the two alternatives that were rejected: a
+ * `/admin/settings/nodes/credentials` card (two clicks between "this worker is
+ * compromised" and revoking its token), and reusing the Personal Access Tokens
+ * page (a different permission, a different audience, and a `nod_` credential
+ * is not a PAT — it is confined to `/api/nodes/*` and cannot mint another
+ * credential, while a PAT is the user's whole identity).
+ *
+ * The third alternative, a bespoke table, was rejected here: both tables are
+ * the `datatable` slice, which is what gives them the phone card layout, the
+ * tablet expander, the column picker, the CSV export, the persisted layout and
+ * the axe-tested keyboard model for free — and what means the accessibility
+ * contract is asserted once, in the shared conformance suite, rather than
+ * re-litigated per page.
+ *
+ * =============================================================================
+ * HEALTH IS THE API'S VERDICT. THIS PAGE NEVER DERIVES IT.
+ * =============================================================================
+ *
+ * Every pill reads `node.health`, computed by `deriveNodeHealth` against the
+ * `nodes.staleHeartbeatSeconds` system setting at read time. The summary strip
+ * TALLIES those verdicts; it does not re-derive them from `lastHeartbeatAt`,
+ * which would require a threshold invented in this file — and that threshold
+ * would be wrong the moment an administrator changed the setting, leaving the
+ * pill and the database disagreeing about which machines are dead. See
+ * `workersTable.tsx` for the same rule stated at the column level.
+ *
+ * =============================================================================
+ * TWO SCOPES OF ACTION, IN TWO PLACES
+ * =============================================================================
+ *
+ *   1. **Per node** — delete this node. A `DataTableRowAction`, so it appears
+ *      in the desktop grid's action cell, the tablet row expander and the phone
+ *      card header from one declaration, with a confirmation that says plainly
+ *      what happens to the work it was holding.
+ *   2. **Per credential** — create, revoke. In the section below, for the
+ *      reasons above.
+ *
+ * Beside them sits one READ action, "View vitals" (#606), offered to every
+ * `nodes:read` holder: the node's full self-reported snapshot in
+ * `NodeVitalsDialog`. The compact form is the table's "Vitals" column, and the
+ * fleet-wide saturation and low-disk counts are in the summary strip — see
+ * `workerVitals.tsx` for why none of it re-derives freshness.
+ *
+ * There is deliberately NO selection and no bulk bar: nothing on this page acts
+ * on a set of nodes, and a checkbox column that gates no action is a column of
+ * dead controls plus a tab stop per row for a keyboard user.
+ *
+ * =============================================================================
+ * POLLING, AND WHY IT STOPS WITH THE TAB
+ * =============================================================================
+ *
+ * A node's health changes with nobody touching it — that is the entire content
+ * of a heartbeat — so this is one of the two admin surfaces where a poll is the
+ * honest design. The shared `useVisiblePolling` (the headless entry's one
+ * implementation, extracted by #271 from `useJobs` rather than copied) tears the interval down while the tab is hidden and
+ * fetches immediately on return. A fleet page left open on a second monitor
+ * should not poll all day; a fleet page that resumes by waiting out a full
+ * interval is worse than one that never paused, because hour-old health pills
+ * that look live are the one wrong answer this page must not give.
+ *
+ * The poll REFRESHES rather than reloads: neither hook raises its loading flag
+ * for a refresh, so rows stay on screen and the tables keep their scroll
+ * offset, their expansion and their focus.
+ */
+import type { ReactElement } from 'react';
+import type { PageSlot, PageSlotsBase, TableSlots } from '../../core/index.js';
+import type { NodesTableColumn, WorkerNode } from '../headless/index.js';
+import type { NodeVitalsPanelSlotProps } from './NodeVitalsDialog.js';
+import type { NodesPageHeaderProps } from './PageHeader.js';
+/**
+ * The slots of {@link WorkersPage}: the page-slot contract over a fleet row, and
+ * `VitalsPanel`.
+ *
+ * `Header` keeps the props it always had and gains `actions` (`null`).
+ * `Toolbar` is drawn above the fleet table, `Columns` / `RowActions` /
+ * `DetailPanel` act on it, and `VitalsPanel` adds content after the vitals in
+ * the "View vitals" dialog.
+ *
+ * @example
+ * ```tsx
+ * <WorkersPage slots={{ RowActions: ({ row }) => <PingNode node={row} />, VitalsPanel: ({ node }) => <DiskForecast node={node} /> }} />
+ * ```
+ *
+ * @extensionPoint slot
+ * @stability experimental
+ */
+export interface WorkersPageSlots extends PageSlotsBase, TableSlots<WorkerNode, NodesTableColumn<WorkerNode>> {
+    /** Replaces the title and subtitle block. */
+    Header?: PageSlot<NodesPageHeaderProps>;
+    /** Extra section after the vitals in the node vitals dialog. */
+    VitalsPanel?: PageSlot<NodeVitalsPanelSlotProps>;
+}
+/**
+ * The props of {@link WorkersPage}. Every prop is optional; the app's route
+ * renders `<WorkersPage />` as is.
+ *
+ * @extensionPoint slot
+ * @stability experimental
+ */
+export interface WorkersPageProps {
+    /** Where a viewer without `nodes:read` is sent. Default `'/'`. */
+    fallbackPath?: string;
+    /** Replaceable and additional parts of the page. */
+    slots?: WorkersPageSlots;
+}
+/**
+ * Admin → Operations → Worker Nodes: the fleet summary, the fleet table with
+ * each node's vitals, and the node credentials (create, reveal once, revoke).
+ * Gated on `nodes:read`; deleting a node and creating or revoking a
+ * credential need `nodes:write`.
+ *
+ * @param props - see {@link WorkersPageProps}.
+ * @returns the page.
+ *
+ * @example
+ * ```tsx
+ * <Route path="/admin/settings/workers" element={
+ *   <RequirePermission permission="nodes:read" fallback={<Navigate to="/" replace />}><WorkersPage /></RequirePermission>
+ * } />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function WorkersPage(props?: WorkersPageProps): ReactElement;
+//# sourceMappingURL=WorkersPage.d.ts.map

package/dist/nodes/ui/WorkersPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkersPage.d.ts","sourceRoot":"","sources":["../../../src/nodes/ui/WorkersPage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAe1C,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAQ/E,OAAO,KAAK,EAAE,gBAAgB,EAAuB,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAI9F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAO5D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,gBAAiB,SAAQ,aAAa,EAAE,UAAU,CAAC,UAAU,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC3G,6CAA6C;IAC7C,MAAM,CAAC,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACxC,gEAAgE;IAChE,WAAW,CAAC,EAAE,QAAQ,CAAC,wBAAwB,CAAC,CAAC;CAClD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAwCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,KAAK,GAAE,gBAAqB,GAAG,YAAY,CAgUtE"}