@zinn-digital/sdk 0.1.1416 → 0.1.1419

package/dist/generated/schema.d.ts

@@ -11221,7 +11221,7 @@ export interface paths {
         };
         /**
          * Capacity and health of every server - disk, inodes, RAM, CPU, load, sites, days-to-full (staff).
-         * @description Every hosting box and mail relay, worst first: the fullest real filesystem, inode use, RAM, CPU busy (15 min), load per core, sites placed against the box's capacity, the measured days until the fullest filesystem fills (least squares over 3 days, `null` when there is not enough history), seconds since the box last reported, and a status (`critical`, `warning`, `watch`, `ok`) computed from the SAME lines the `zinn-server-capacity` PrometheusRule pages on (75 / 85 / 95 % disk, 14 / 3 days to full). Requires staff + `platform.observability.read`.
+         * @description Every server we run, in display groups (`groups`, in order): hosting, magento, mail, cluster (each Kubernetes node, with its `sub_roles` and pods / CPU / memory requests as `units`), ci, network (owned egress, private-network gateway), launch, customer_compute and v1. Rows are the UNION of what pushes metrics, the engine's `Worker` table and the supplier inventory (Hetzner Cloud + Robot), so a billed server that pushes nothing is still a row (`source: none`, status `critical` with `not_reporting`), never an absence. Customer compute, launch-project and V1 servers carry no V2 agent by design (`agent_expected: false`, status `unmonitored`, no problems): they are listed with their `size`; launch and V1 are monitored by their own projects, and V1 capacity is read on V1's own page (`v1_capacity_url`). The dev workstation is not production and is not listed. Within each group, worst first: the fullest real filesystem, inode use, RAM, CPU busy (15 min), load per core, sites placed against the box's capacity, the measured days until the fullest filesystem fills (least squares over 3 days, `null` when there is not enough history), seconds since the box last reported, and a status (`critical`, `warning`, `watch`, `ok`) computed from the SAME lines the `zinn-server-capacity` PrometheusRule pages on (75 / 85 / 95 % disk, 14 / 3 days to full). Requires staff + `platform.observability.read`.
          *
          *     **`available: false` is not "nothing is filling up".** Every box pushes a root filesystem and a load average, so zero series is a monitoring failure. Hosting boxes the engine knows about that push nothing are listed in `silent_workers`, never dropped.
          */
@@ -96488,6 +96488,10 @@ export interface components {
         };
         ServerCapacity: {
             available: boolean;
+            /** @description The display groups, in the order the console shows them. */
+            groups: string[];
+            /** @description False when the supplier inventory could not be read - then servers that push nothing may be missing. */
+            inventory_available: boolean;
             servers: components["schemas"]["ServerUsage"][];
             silent_workers: string[];
             thresholds: {
@@ -96503,6 +96507,11 @@ export interface components {
                 stale_seconds: number;
             };
             unavailable_reason: string;
+            /**
+             * Format: uri
+             * @description V1's own capacity page, where V1 servers are monitored.
+             */
+            v1_capacity_url: string;
         };
         ServerFilesystem: {
             /** Format: int64 */
@@ -96516,8 +96525,19 @@ export interface components {
             size_bytes: number;
             used_fraction: number;
         };
+        ServerUnitUsage: {
+            /** @description True when `limit` is estimated from the server's measured RAM at the fleet's declared sites-per-RAM ratio (a worker with no declared capacity), never alerted on. */
+            estimated: boolean;
+            /** @enum {string} */
+            kind: "sites" | "pods" | "cpu_requests_millicores" | "memory_requests_bytes";
+            limit: number;
+            used: number;
+            used_fraction: number | null;
+        };
         ServerUsage: {
             accepts_deploys: boolean | null;
+            /** @description False for groups that carry no V2 agent by design (customer_compute, launch, v1). */
+            agent_expected: boolean;
             /** @description The server's hostname. */
             box: string;
             cores: number;
@@ -96525,7 +96545,11 @@ export interface components {
             days_to_full: number | null;
             disk_used_fraction: number;
             filesystems: components["schemas"]["ServerFilesystem"][];
+            /** @enum {string} */
+            group: "hosting" | "magento" | "mail" | "cluster" | "ci" | "network" | "launch" | "customer_compute" | "v1" | "other";
             inode_used_fraction: number;
+            /** @description The customer's own name for a Zinn® Compute server; empty otherwise. */
+            label: string;
             load_per_core: number | null;
             load15: number | null;
             /**
@@ -96539,13 +96563,28 @@ export interface components {
             pool: string;
             problems: ("not_reporting" | "disk_critical" | "disk_warn" | "disk_watch" | "inodes_critical" | "inodes_warn" | "inodes_watch" | "full_within_critical" | "full_within_warn" | "memory_warn" | "cpu_warn" | "load_warn" | "sites_full")[];
             region: string;
-            /** @enum {string} */
-            role: "hosting-worker" | "mail-relay";
+            /** @description The box's role label (`hosting-worker`, `mail-relay`, `cluster-node`, `owned-egress`, `privatenet-gateway`, `launch`, or the supplier's label for an unmonitored server). */
+            role: string;
             seconds_since_report: number | null;
             site_capacity: number | null;
             sites: number | null;
+            /** @description Plan or product from the supplier (`cpx32`, `AX102-3-LTD`); empty when unknown. */
+            size: string;
+            /**
+             * @description Where the figures come from: node exporter, the CI box health reporter, or nothing.
+             * @enum {string}
+             */
+            source: "metrics" | "ci_report" | "none";
             /** @enum {string} */
-            status: "critical" | "warning" | "watch" | "ok";
+            status: "critical" | "warning" | "watch" | "ok" | "unmonitored";
+            /** @description What a cluster node carries, from its node roles and taints plus what is scheduled on it (e.g. `control-plane`, `etcd`, `observability`, `database` for a CloudNativePG instance, `managed-db`). */
+            sub_roles: string[];
+            /**
+             * @description Which supplier inventory lists it; empty when none does.
+             * @enum {string}
+             */
+            supplier: "hetzner_cloud" | "hetzner_robot" | "";
+            units: components["schemas"]["ServerUnitUsage"][];
         };
         /** @description The estate's service health, as the admin overview renders it. */
         ServiceHealthOverview: {
@@ -186250,7 +186289,7 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The `primary_domain` is not available, an `Idempotency-Key` was reused with a different body, or a request with that `Idempotency-Key` is still in flight (retry once it settles). */
+            /** @description The `primary_domain` is not available (another site uses it, or another organisation holds that domain or a domain it sits under; the answer does not say which), an `Idempotency-Key` was reused with a different body, or a request with that `Idempotency-Key` is still in flight (retry once it settles). */
             409: {
                 headers: {
                     [name: string]: unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zinn-digital/sdk",
-  "version": "0.1.1416",
+  "version": "0.1.1419",
   "description": "Typed TypeScript client for the Zinn Digital Platform API, generated from its OpenAPI spec.",
   "license": "MIT",
   "author": "Neil Lock \u2014 CEO, Zinn Digital\u00ae Ltd <office@zinndigital.com>",