rterm-backend 2.7.5 → 2.7.6

package/bin/gybackend.js

@@ -382209,6 +382209,87 @@ var EvidenceSealer = class {
   }
 };
 
+// ../../packages/backend/src/services/sre/monitorStatusService.ts
+var MonitorStatusService = class {
+  constructor(monitor, terminalService, now = () => Date.now()) {
+    this.monitor = monitor;
+    this.terminalService = terminalService;
+    this.now = now;
+  }
+  /** Build the full monitor status report. */
+  report() {
+    const publisherWired = this.monitor.publisher !== null;
+    const entries = [];
+    const issues = [];
+    const terminals = this.terminalService.getDisplayTerminals();
+    const now = this.now();
+    for (const terminal of terminals) {
+      const terminalId = terminal.id;
+      const connected = terminal.runtimeState === "ready";
+      const platform2 = terminal.remoteOs ?? terminal.type ?? "unknown";
+      const sessions = this.monitor.sessions;
+      const session = sessions?.get(terminalId);
+      const hasSession = session !== void 0;
+      const inFlight = session?.inFlight === true;
+      const lastCollectAt = session?.lastCollectAt ?? 0;
+      const lastCollectAgoMs = lastCollectAt > 0 ? now - lastCollectAt : -1;
+      let diagnosis = "ok";
+      if (!connected) {
+        diagnosis = "terminal_not_connected";
+      } else if (!hasSession) {
+        diagnosis = "no_monitor_session";
+      } else if (inFlight) {
+        diagnosis = "collection_stuck_in_flight";
+      } else if (lastCollectAt === 0) {
+        diagnosis = "never_collected";
+      } else if (lastCollectAgoMs > 3e4) {
+        diagnosis = `stale_collection (${Math.round(lastCollectAgoMs / 1e3)}s ago)`;
+      }
+      entries.push({
+        terminalId,
+        connected,
+        platform: platform2,
+        hasSession,
+        inFlight,
+        lastCollectAt,
+        lastCollectAgoMs,
+        diagnosis
+      });
+      if (diagnosis !== "ok") {
+        issues.push(`${terminalId}: ${diagnosis}`);
+      }
+    }
+    if (!publisherWired) {
+      issues.unshift("publisher_not_wired \u2014 createObservability may not have been called");
+    }
+    if (entries.length === 0) {
+      issues.push("no_terminals \u2014 no terminals connected");
+    }
+    return {
+      publisherWired,
+      terminalCount: entries.length,
+      entries,
+      issues
+    };
+  }
+  /** Build a compact summary string for the agent. */
+  summary() {
+    const r = this.report();
+    const parts = [];
+    parts.push(`publisher=${r.publisherWired ? "wired" : "NOT WIRED"}`);
+    parts.push(`terminals=${r.terminalCount}`);
+    if (r.issues.length > 0) {
+      parts.push(`issues=${r.issues.length}:`);
+      for (const issue2 of r.issues) {
+        parts.push(`  - ${issue2}`);
+      }
+    } else {
+      parts.push("all terminals collecting normally");
+    }
+    return parts.join("\n");
+  }
+};
+
 // ../../packages/backend/src/services/observability.ts
 function createObservability(deps) {
   const log = deps.onLog ?? (() => {
@@ -382287,6 +382368,7 @@ function createObservability(deps) {
   });
   const auditLedger = new AuditLedger({});
   const evidenceSealer = new EvidenceSealer({});
+  const monitorStatus = new MonitorStatusService(deps.resourceMonitorService, deps.terminalService);
   const pluginScanRoot = (process.env.GYBACKEND_DATA_DIR ?? "./.gybackend-data") + "/plugins";
   const bundlePluginRoot = new URL("../../plugins/", import.meta.url).pathname;
   const scanRoots = [pluginScanRoot, "./plugins"];
@@ -382359,6 +382441,7 @@ function createObservability(deps) {
     notify: { slackChannel, teamsChannel, smtpChannel, telegramChannel },
     aperf: { service: aperfService, toMetricPoint: aperfSummaryToMetricPoint },
     audit: { ledger: auditLedger, sealer: evidenceSealer },
+    monitorStatus,
     pluginRegistry
   };
 }
@@ -384364,6 +384447,7 @@ async function startGyBackend() {
     automationManager,
     agentRunLedger,
     gatewayService,
+    resourceMonitorService,
     setMonitorPublisher: (pub) => resourceMonitorService.setPublisher((channel, data) => {
       pub(channel, data);
     }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rterm-backend",
-  "version": "2.7.5",
+  "version": "2.7.6",
   "description": "RTerm headless backend — run RTerm-as-a-service (AI agent, SSH/WinRM/Serial/local terminals, fleet orchestration, advanced automation with event-driven triggers + NATS event mesh, scheduled automation, SRE observability, Netdata integration, AWS APerf performance deep-dive, plugin system) and drive it over a WebSocket JSON-RPC gateway. No desktop UI required.",
   "license": "Apache-2.0",
   "type": "module",