spur-board 0.9.0 → 0.9.1

package/dist/cli.mjs

@@ -1,6 +1,6 @@
-import { H as requiredSecretKeys, N as ERRORS, U as SLACK_BOT_SCOPES, V as configSchema, l as OPERATIONS, n as SYSTEMD_SERVICE_SETTINGS } from "./src-C-NNf__4.mjs";
-import { a as errorExitCode, i as CliError, n as requestOperation, o as renderCliError, r as requestTokenEnrollment, s as escapeTerminalControls } from "./client-Co0Pogjy.mjs";
-import { a as memoryVerdictCache, c as loadEnrollmentConfig, i as fileVerdictCache, l as resolveDaemonAddress, n as cliPackageVersion, o as configFile, s as loadClientConfig, t as checkCatalog } from "./config-DL_Tm7un.mjs";
+import { H as requiredSecretKeys, N as ERRORS, U as SLACK_BOT_SCOPES, V as configSchema, l as OPERATIONS, n as SYSTEMD_SERVICE_SETTINGS } from "./src-DyDmiehC.mjs";
+import { a as errorExitCode, i as CliError, n as requestOperation, o as renderCliError, r as requestTokenEnrollment, s as escapeTerminalControls } from "./client-C4Ee3Gfs.mjs";
+import { a as memoryVerdictCache, c as loadEnrollmentConfig, i as fileVerdictCache, l as resolveDaemonAddress, n as cliPackageVersion, o as configFile, s as loadClientConfig, t as checkCatalog } from "./config-BmT8hPi8.mjs";
 import { createHash, randomBytes, randomUUID } from "node:crypto";
 import { chmodSync, closeSync, constants, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, readlinkSync, realpathSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { homedir, hostname, userInfo } from "node:os";

package/dist/{client-Co0Pogjy.mjs → client-C4Ee3Gfs.mjs}

@@ -1,4 +1,4 @@
-import { F as errorEnvelopeSchema, I as successEnvelopeSchema, N as ERRORS, P as errorContextSchema, d as renderJsonError } from "./src-C-NNf__4.mjs";
+import { F as errorEnvelopeSchema, I as successEnvelopeSchema, N as ERRORS, P as errorContextSchema, d as renderJsonError } from "./src-DyDmiehC.mjs";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 import { request } from "node:http";

package/dist/client.mjs

@@ -1,2 +1,2 @@
-import { n as requestOperation, r as requestTokenEnrollment, t as fetchCatalogVersion } from "./client-Co0Pogjy.mjs";
+import { n as requestOperation, r as requestTokenEnrollment, t as fetchCatalogVersion } from "./client-C4Ee3Gfs.mjs";
 export { fetchCatalogVersion, requestOperation, requestTokenEnrollment };

package/dist/{config-DL_Tm7un.mjs → config-BmT8hPi8.mjs}

@@ -1,5 +1,5 @@
-import { V as configSchema, l as OPERATIONS, s as buildCatalogSnapshot } from "./src-C-NNf__4.mjs";
-import { i as CliError, t as fetchCatalogVersion } from "./client-Co0Pogjy.mjs";
+import { V as configSchema, l as OPERATIONS, s as buildCatalogSnapshot } from "./src-DyDmiehC.mjs";
+import { i as CliError, t as fetchCatalogVersion } from "./client-C4Ee3Gfs.mjs";
 import { randomUUID } from "node:crypto";
 import { closeSync, constants, fstatSync, lstatSync, mkdirSync, openSync, readFileSync, realpathSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";

package/dist/daemon.mjs

@@ -1,4 +1,4 @@
-import { A as parseActorId, B as RESERVED_PROJECT, C as prFactsSchema, D as actorIdSchema, E as ticketFactsSchema, H as requiredSecretKeys, I as successEnvelopeSchema, M as taskKeySchema, N as ERRORS, O as encodeActorId, S as SESSION_STATUSES, T as sessionFactsSchema, U as SLACK_BOT_SCOPES, V as configSchema, _ as messageRefSchema, a as entityRefSchema, b as eventPayloadSchemas, c as roleCanUseOperation, g as interactionRefSchema, h as inboundEventSchema, i as batchSchema, j as parseRef$1, k as errorCodeOf, l as OPERATIONS, m as conversationRefSchema, o as sourceCursorSchema, p as SPACE_IDS, r as AdapterError, s as buildCatalogSnapshot, t as BOARD_TICK_MS, u as renderHttpProblem, v as userIdSchema, w as prRefSchema, x as SESSION_HEALTH_STATES, y as EVENT_KINDS, z as DEFAULT_SLACK_COMMAND } from "./src-C-NNf__4.mjs";
+import { A as parseActorId, B as RESERVED_PROJECT, C as prFactsSchema, D as actorIdSchema, E as ticketFactsSchema, H as requiredSecretKeys, I as successEnvelopeSchema, M as taskKeySchema, N as ERRORS, O as encodeActorId, S as SESSION_STATUSES, T as sessionFactsSchema, U as SLACK_BOT_SCOPES, V as configSchema, _ as messageRefSchema, a as entityRefSchema, b as eventPayloadSchemas, c as roleCanUseOperation, g as interactionRefSchema, h as inboundEventSchema, i as batchSchema, j as parseRef$1, k as errorCodeOf, l as OPERATIONS, m as conversationRefSchema, o as sourceCursorSchema, p as SPACE_IDS, r as AdapterError, s as buildCatalogSnapshot, t as BOARD_TICK_MS, u as renderHttpProblem, v as userIdSchema, w as prRefSchema, x as SESSION_HEALTH_STATES, y as EVENT_KINDS, z as DEFAULT_SLACK_COMMAND } from "./src-DyDmiehC.mjs";
 import { createRequire } from "node:module";
 import { createHash, randomUUID } from "node:crypto";
 import { closeSync, existsSync, fstatSync, ftruncateSync, mkdirSync, openSync, readFileSync, readdirSync, writeSync } from "node:fs";
@@ -9828,6 +9828,53 @@ function commentOf(body) {
 		default: return null;
 	}
 }
+/** The kinds whose rows wait in one of `spaces`. */
+function kindsIn(spaces) {
+	return OUTBOX_KINDS.filter((kind) => {
+		const space = KIND_SPACE[kind];
+		return space !== null && spaces.includes(space);
+	});
+}
+/**
+* Raises the gateway's one transport item while it has health rows and clears it once none are
+* left. Call it in the transaction that changed the rows, only when they changed.
+*/
+async function syncTransportItem(trx, gateway, at) {
+	const itemKey = `transport:${gateway}`;
+	const rows = await trx.selectFrom("transport_health").select(["reason", "since"]).where("gateway", "=", gateway).orderBy("since").orderBy("space").execute();
+	const first = rows[0];
+	if (first !== void 0) {
+		const reason = rows.find((r) => r.reason !== "down")?.reason ?? "connection lost";
+		const text = `${gateway} delivery down since ${first.since} (${reason})`;
+		const item = await raiseItem(trx, {
+			itemKey,
+			kind: "transport_health",
+			text,
+			url: "",
+			taskId: null,
+			blockId: null,
+			priority: 1,
+			suppressFeed: true,
+			at
+		});
+		if (item.text !== text) await trx.updateTable("operator_item").set({ text }).where("id", "=", item.id).execute();
+		return;
+	}
+	const active = await trx.selectFrom("operator_item").select("id").where("item_key", "=", itemKey).where("cleared_at", "is", null).executeTakeFirst();
+	if (active !== void 0) await clearItem(trx, active.id, at);
+}
+/**
+* Makes the next tick probe every space of `gateway` that has a health row: the probe clock is
+* set one interval back and waiting rows there become due at `at` (ISO-8601 UTC). Returns the
+* number of spaces armed; 0 when no outage is recorded.
+*/
+async function retryTransport(trx, gateway, at) {
+	const rows = await trx.updateTable("transport_health").set({ probe_at: (/* @__PURE__ */ new Date(Date.parse(at) - HEALTH_PROBE_MS)).toISOString() }).where("gateway", "=", gateway).returning("space").execute();
+	const kinds = kindsIn(rows.map((row) => row.space));
+	if (kinds.length === 0) return rows.length;
+	await trx.updateTable("outbox").set({ next_at: at }).where("state", "=", "pending").where("kind", "in", kinds).where("next_at", ">", at).execute();
+	return rows.length;
+}
 async function setComment(trx, body, patch) {
 	const commentId = commentOf(body);
 	if (commentId === null) return;
@@ -9912,6 +9959,8 @@ function createSender(options) {
 	const now = options.now ?? (() => /* @__PURE__ */ new Date());
 	const spaceIntervalMs = options.spaceIntervalMs ?? SPACE_INTERVAL_MS;
 	let downSince;
+	/** Set once this outage's down rows were written; reset on `up`. */
+	let downRecorded = false;
 	/** The last tick started; a new tick runs after it, so two ticks never interleave. */
 	let ticking = Promise.resolve();
 	/** Sets the comments of `rows` that carry one to `superseded`. */
@@ -9947,14 +9996,14 @@ function createSender(options) {
 	* there, so a row that retried before the outage gets a full window once the space recovers.
 	*/
 	async function suspendWindows(trx, spaces) {
-		const kinds = OUTBOX_KINDS.filter((kind) => {
-			const space = KIND_SPACE[kind];
-			return space !== null && spaces.includes(space);
-		});
+		const kinds = kindsIn(spaces);
 		if (kinds.length === 0) return;
 		await trx.updateTable("outbox").set({ first_attempt_at: null }).where("state", "in", ["pending", "in_flight"]).where("kind", "in", kinds).execute();
 	}
-	/** tx 1: cancels stale rows, raises down-health and claims at most one due row per lane. */
+	/**
+	* tx 1: cancels stale rows, raises down-health and claims at most one due row per lane.
+	* `ranThreshold` says the outage's down rows were written; the caller records that after commit.
+	*/
 	async function claim(trx, at) {
 		const nowIso = new Date(at).toISOString();
 		await reconcileDoorbells(trx, new Date(at), options.config);
@@ -9978,16 +10027,19 @@ function createSender(options) {
 		}
 		await kill(trx, stale, "superseded");
 		await cascade(trx);
-		if (gateway !== void 0 && downSince !== void 0 && at - downSince > DOWN_THRESHOLD_MS) {
+		let ranThreshold = false;
+		if (gateway !== void 0 && !downRecorded && downSince !== void 0 && at - downSince > DOWN_THRESHOLD_MS) {
 			const since = new Date(downSince).toISOString();
-			await trx.insertInto("transport_health").values(SPACE_IDS.map((space) => ({
+			const inserted = await trx.insertInto("transport_health").values(SPACE_IDS.map((space) => ({
 				gateway: gatewayKind,
 				space,
 				reason: "down",
 				since,
 				probe_at: since
-			}))).onConflict((oc) => oc.columns(["gateway", "space"]).doNothing()).execute();
+			}))).onConflict((oc) => oc.columns(["gateway", "space"]).doNothing()).returning("space").execute();
 			await suspendWindows(trx, SPACE_IDS);
+			if (inserted.length > 0) await syncTransportItem(trx, gatewayKind, new Date(at));
+			ranThreshold = true;
 		}
 		const live = await trx.selectFrom("outbox").leftJoin("outbox as parent", "parent.id", "outbox.parent_outbox_id").selectAll("outbox").select(["parent.state as parentState", "parent.external_ref as parentRef"]).where("outbox.state", "=", "pending").where("outbox.next_at", "<=", nowIso).execute();
 		const sentAt = new Map((gateway === void 0 ? [] : await trx.selectFrom("space_slot").select(["space", "sent_at"]).where("gateway", "=", gatewayKind).execute()).map((slot) => [slot.space, Date.parse(slot.sent_at)]));
@@ -10039,7 +10091,10 @@ function createSender(options) {
 			attempts: eb("attempts", "+", 1),
 			attempt_started: 0
 		})).where("id", "=", c.id).execute();
-		return claims.sort((a, b) => Number(a.space === null) - Number(b.space === null));
+		return {
+			claims: claims.sort((a, b) => Number(a.space === null) - Number(b.space === null)),
+			ranThreshold
+		};
 	}
 	/**
 	* Stamps the start of a send, just before its IO: the row's retry window if none is open and,
@@ -10227,7 +10282,9 @@ function createSender(options) {
 					conversation_ref: conversation,
 					message_ref: outcome.message
 				});
-				if (space !== null) await trx.deleteFrom("transport_health").where("gateway", "=", gatewayKind).where("space", "=", space).execute();
+				if (space !== null) {
+					if ((await trx.deleteFrom("transport_health").where("gateway", "=", gatewayKind).where("space", "=", space).returning("space").execute()).length > 0) await syncTransportItem(trx, gatewayKind, new Date(at));
+				}
 				return;
 			}
 			case "retry": {
@@ -10252,13 +10309,13 @@ function createSender(options) {
 			}
 			case "failed":
 				if (outcome.scope === "message" || space === null) return postFailed({ last_error: outcome.reason });
-				await trx.insertInto("transport_health").values({
+				if ((await trx.insertInto("transport_health").values({
 					gateway: gatewayKind,
 					space,
 					reason: outcome.reason,
 					since: nowIso,
 					probe_at: new Date(startedAt).toISOString()
-				}).onConflict((oc) => oc.columns(["gateway", "space"]).doNothing()).execute();
+				}).onConflict((oc) => oc.columns(["gateway", "space"]).doUpdateSet({ reason: outcome.reason }).where("transport_health.reason", "=", "down")).returning("space").execute()).length > 0) await syncTransportItem(trx, gatewayKind, new Date(at));
 				await suspendWindows(trx, [space]);
 				await row.set({
 					state: "pending",
@@ -10272,7 +10329,8 @@ function createSender(options) {
 	async function runTick(signal) {
 		if (signal?.aborted) return;
 		const claimedAt = now().getTime();
-		const claims = await scanTransaction(store, (trx) => claim(trx, claimedAt));
+		const { claims, ranThreshold } = await scanTransaction(store, (trx) => claim(trx, claimedAt));
+		if (ranThreshold) downRecorded = true;
 		for (const [i, c] of claims.entries()) {
 			if (signal?.aborted) {
 				const ids = claims.slice(i).map((c) => c.id);
@@ -10325,8 +10383,20 @@ function createSender(options) {
 			return run;
 		},
 		recordConnection(state, at) {
-			if (state === "up") downSince = void 0;
-			else downSince ??= at.getTime();
+			const run = ticking.then(async () => {
+				if (state === "down") {
+					downSince ??= at.getTime();
+					return;
+				}
+				downSince = void 0;
+				downRecorded = false;
+				if (gateway === void 0) return;
+				await scanTransaction(store, async (trx) => {
+					if ((await trx.deleteFrom("transport_health").where("gateway", "=", gatewayKind).where("reason", "=", "down").returning("space").execute()).length > 0) await syncTransportItem(trx, gatewayKind, at);
+				});
+			});
+			ticking = run.catch(() => void 0);
+			return run;
 		}
 	};
 }
@@ -10352,7 +10422,10 @@ function view(item, task) {
 function notApplicable(hint) {
 	return new CommandError("retry_not_applicable", hint);
 }
-/** Item actions: retry runs the action behind the item's kind; close dismisses it. Both clear it. */
+/**
+* Item actions: retry runs the action behind the item's kind; close dismisses it. Both clear it,
+* except a retry on a transport item, which the sender clears when the transport is back.
+*/
 function createItemMutations(deps) {
 	async function retryAction(trx, item, at) {
 		const closeHint = `close it with \`board item close I${String(item.id)}\`.`;
@@ -10382,6 +10455,10 @@ function createItemMutations(deps) {
 				const { item, task } = await loadItem(trx, input.item);
 				if (task?.membership === "archived") throw new CommandError("task_archived", "Add the task again before retrying its item.");
 				if (item.cleared_at !== null) throw notApplicable("The item is already cleared.");
+				if (item.kind === "transport_health") {
+					if (await retryTransport(trx, item.item_key.slice(10), ctx.at) === 0) throw notApplicable("No transport outage is recorded; the item clears on its own.");
+					return view(item, task);
+				}
 				await retryAction(trx, item, ctx.at);
 				await clearItem(trx, item.id, new Date(ctx.at), ctx.actor);
 				return view(item, task);
@@ -10617,7 +10694,7 @@ function interval(config, source) {
 }
 /** Reads the board's latest facts, items and source availability. */
 async function getStatus(deps, projectId, visibleProjects, includeBoardItems = visibleProjects === void 0) {
-	const { store, config, clock, completeSince } = deps;
+	const { store, config, clock, completeSince, gateways = [] } = deps;
 	const projects = projectId === void 0 ? config.projects.filter((project) => visibleProjects === void 0 || visibleProjects.has(project.id)) : config.projects.filter((project) => project.id === projectId && (visibleProjects === void 0 || visibleProjects.has(project.id)));
 	if (projects.length === 0) throw new CommandError("not_found", "Check the project ID.");
 	const projectIds = new Set(projects.map((project) => project.id));
@@ -10690,6 +10767,23 @@ async function getStatus(deps, projectId, visibleProjects, includeBoardItems = v
 	});
 	const host = await store.db.selectFrom("meta").select("value").where("key", "=", "host_load_episode").executeTakeFirst();
 	const spur = sourceById.get("spur");
+	const healthRows = await store.db.selectFrom("transport_health").select([
+		"gateway",
+		"space",
+		"reason",
+		"since"
+	]).orderBy("since").orderBy("space").execute();
+	const transport = [.../* @__PURE__ */ new Set([...gateways, ...healthRows.map((row) => row.gateway)])].sort().map((gateway) => {
+		const down = healthRows.filter((row) => row.gateway === gateway);
+		const first = down[0];
+		return {
+			gateway,
+			state: first === void 0 ? "up" : "down",
+			since: first?.since ?? null,
+			reason: first?.reason ?? null,
+			spaces: down.map((row) => row.space).sort()
+		};
+	});
 	return {
 		tasks,
 		items,
@@ -10698,7 +10792,8 @@ async function getStatus(deps, projectId, visibleProjects, includeBoardItems = v
 		sources,
 		warmingUp: sources.some((source) => source.warmingUp),
 		spurUnavailable: spur?.blind_reason === null || spur === void 0 ? null : `Spur unavailable: ${spur.blind_message ?? spur.blind_reason}`,
-		hostLoad: host?.value !== void 0 && host.value !== "null" ? "Host under load" : null
+		hostLoad: host?.value !== void 0 && host.value !== "null" ? "Host under load" : null,
+		transport
 	};
 }
 //#endregion
@@ -10892,7 +10987,7 @@ function createTaskQueries(config) {
 const catalog = await buildCatalogSnapshot(OPERATIONS);
 /** Concrete handlers shared by the daemon's HTTP and inbound transports. */
 function createOperationRegistry(deps) {
-	const { config, clock, completeSince } = deps;
+	const { config, clock, completeSince, gateways } = deps;
 	const items = createItemMutations(deps);
 	const membership = createMembershipMutations(config);
 	const links = createLinkMutations(config);
@@ -10940,7 +11035,8 @@ function createOperationRegistry(deps) {
 					store: { db: trx },
 					config,
 					clock,
-					completeSince
+					completeSince,
+					gateways
 				}, input.project, visibleProjects(config, actor), authorize([{ grant: "operator" }], actor, {
 					config,
 					target: { kind: "missing" }
@@ -16242,7 +16338,10 @@ function slackSettings(config, secrets) {
 		requestTimeoutMs: DELIVERY_REQUEST_TIMEOUT_MS
 	};
 }
-/** Own the timer and wait for the last queued sender tick before the store closes. */
+/**
+* Own the timer and wait for the last queued sender tick and connection update before the store
+* closes.
+*/
 function createOutboxModule(ctx, gateway, options = {}) {
 	const spur = options.spur ?? createSpurPort();
 	const sender = createSender({
@@ -16254,6 +16353,7 @@ function createOutboxModule(ctx, gateway, options = {}) {
 	});
 	let timer;
 	let active = Promise.resolve();
+	let updating = Promise.resolve();
 	let stopped = false;
 	let signal;
 	const schedule = () => {
@@ -16282,8 +16382,17 @@ function createOutboxModule(ctx, gateway, options = {}) {
 			stopped = true;
 			if (timer !== void 0) clearTimeout(timer);
 			await active;
+			await updating;
 		},
-		pulse: tick
+		pulse: tick,
+		connection(state) {
+			if (stopped) return Promise.resolve();
+			const update = sender.recordConnection(state, new Date(ctx.clock.now())).catch((err) => {
+				ctx.log.error({ err }, "transport state update failed");
+			});
+			updating = Promise.all([updating, update]).then(() => void 0);
+			return update;
+		}
 	};
 }
 //#endregion
@@ -16401,10 +16510,14 @@ function createDaemonModules(ctxFor, ports = {}) {
 		clock: board.clock,
 		...ports.productVersion === void 0 ? {} : { productVersion: ports.productVersion }
 	});
+	const ctx = ctxFor("gateway-slack");
+	const settings = slackSettings(ctx.config, ctx.secrets);
+	const gateway = ports.gateway ?? (settings === null ? void 0 : createSlackGateway(settings));
 	const registry = createOperationRegistry({
 		config: board.config,
 		clock: board.clock,
 		completeSince: core.completeSince,
+		gateways: gateway === void 0 ? [] : [gateway.kind],
 		reapplyInbound: () => inbound?.reapply
 	});
 	const notifier = createSystemdNotifier({
@@ -16435,16 +16548,16 @@ function createDaemonModules(ctxFor, ports = {}) {
 			notifier.watchdog();
 		}
 	}));
-	const ctx = ctxFor("gateway-slack");
-	const settings = slackSettings(ctx.config, ctx.secrets);
-	const gateway = ports.gateway ?? (settings === null ? void 0 : createSlackGateway(settings));
 	const inbound = gateway === void 0 || ports.gateway === void 0 && settings?.appToken === void 0 ? void 0 : createInboundModule(ctxFor("inbound"), gateway, registry);
 	if (settings !== null && inbound === void 0) ctx.log.info("Slack inbound disabled: SLACK_APP_TOKEN is absent");
+	const outbox = createOutboxModule(ctxFor("outbox"), gateway, ports.spur === void 0 ? {} : { spur: ports.spur });
 	if (gateway !== void 0) entries.push({
 		name: "gateway-slack",
 		stopStage: "final",
 		module: {
-			start: () => gateway.start(inbound === void 0 ? () => Promise.resolve() : (event) => inbound.sink(event)),
+			start: () => gateway.start(async (event) => {
+				await Promise.all([inbound?.sink(event), event.kind === "connection" ? outbox.connection(event.state) : void 0]);
+			}),
 			async stop() {
 				try {
 					await gateway.stop();
@@ -16459,7 +16572,6 @@ function createDaemonModules(ctxFor, ports = {}) {
 		stopStage: "pollers",
 		module: inbound
 	});
-	const outbox = createOutboxModule(ctxFor("outbox"), gateway, ports.spur === void 0 ? {} : { spur: ports.spur });
 	entries.push({
 		name: "outbox",
 		stopStage: "outbox",

package/dist/mcp.mjs

@@ -1,6 +1,6 @@
-import { N as ERRORS, f as renderMcpError, l as OPERATIONS } from "./src-C-NNf__4.mjs";
-import { i as CliError, n as requestOperation } from "./client-Co0Pogjy.mjs";
-import { a as memoryVerdictCache, r as compareCatalogs, s as loadClientConfig, t as checkCatalog } from "./config-DL_Tm7un.mjs";
+import { N as ERRORS, f as renderMcpError, l as OPERATIONS } from "./src-DyDmiehC.mjs";
+import { i as CliError, n as requestOperation } from "./client-C4Ee3Gfs.mjs";
+import { a as memoryVerdictCache, r as compareCatalogs, s as loadClientConfig, t as checkCatalog } from "./config-BmT8hPi8.mjs";
 import { randomUUID } from "node:crypto";
 import { readFileSync } from "node:fs";
 import { z } from "zod";

package/dist/{src-C-NNf__4.mjs → src-DyDmiehC.mjs}

@@ -1638,7 +1638,14 @@ const OPERATIONS = [
 			sources: z.array(sourceViewSchema).describe("Freshness and availability of each source."),
 			warmingUp: z.boolean().describe("Whether required sources still need a complete poll."),
 			spurUnavailable: z.string().nullable().describe("One combined Spur availability line, or null when available."),
-			hostLoad: z.string().nullable().describe("Host-load episode line, or null when absent.")
+			hostLoad: z.string().nullable().describe("Host-load episode line, or null when absent."),
+			transport: z.array(z.strictObject({
+				gateway: z.string().min(1).describe("Chat gateway kind."),
+				state: z.enum(["up", "down"]).describe("down while delivery to any space of the gateway is suspended."),
+				since: z.iso.datetime().nullable().describe("When the earliest outage started, ISO 8601 UTC, or null when up."),
+				reason: z.string().nullable().describe("Reason of the earliest outage, or null when up."),
+				spaces: z.array(z.enum(SPACE_IDS)).describe("Spaces whose delivery is suspended.")
+			}).describe("Transport health of one gateway.")).describe("Transport health of each chat gateway.")
 		}),
 		grants: operatorOrProjectAgent,
 		errors: ["not_found"],
@@ -1667,7 +1674,8 @@ const OPERATIONS = [
 				sources: [],
 				warmingUp: true,
 				spurUnavailable: null,
-				hostLoad: null
+				hostLoad: null,
+				transport: []
 			}
 		}]
 	}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spur-board",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "license": "MIT",
   "engines": {
     "node": "^24.12.0 || ^26.0.0"