agent-relay-server 0.61.0 → 0.61.1

package/docs/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Relay API",
-    "version": "0.61.0",
+    "version": "0.61.1",
     "description": "Real-time message bus for inter-agent communication. Agent-first: this spec is designed for machine consumption — agents can self-discover the full API surface via GET /api/spec.",
     "license": {
       "name": "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-server",
-  "version": "0.61.0",
+  "version": "0.61.1",
   "description": "Lightweight HTTP message relay for inter-agent communication across machines",
   "module": "src/index.ts",
   "type": "module",

package/src/routes/orchestrator.ts

@@ -1,6 +1,7 @@
 // Auto-split from routes.ts (#299). Domain: orchestrator.
 import { APPROVAL_MODES, SPAWN_PROVIDERS, VALID_WORKSPACE_MODES, isRecord } from "agent-relay-sdk";
 import { CONTRACT_VERSIONS, parseRuntimeCapabilities, parseRuntimeContracts, parseRuntimePackage, type RuntimeCapabilities, type RuntimeContracts, type RuntimePackageMetadata } from "../contracts";
+import { notifyAgentOffline } from "../agent-lifecycle-events";
 import { VERSION } from "../config";
 import { ValidationError, deleteOrchestrator, getOrchestrator, listOrchestrators, orchestratorHeartbeat, recordAgentExitDiagnostics, setOrchestratorUpgradeState, updateManagedAgents, upsertOrchestrator } from "../db";
 import { auditEvent, authAuditMetadata, authorizeRoute, cleanJsonArray, cleanSafeNumber, dashboardAttribution, emitCommand, error, isRootCredentialRequest, json, parseBody, spawnRequestId, type Handler } from "./_shared";
@@ -201,7 +202,15 @@ export const patchOrchestratorAgents: Handler = async (req, params) => {
     const updated = updateManagedAgents(params.id!, cleaned);
     for (const exited of exitedAgents) {
       const agent = recordAgentExitDiagnostics(exited.agentId, exited);
-      if (agent) emitAgentStatus(agent.id);
+      if (agent) {
+        emitAgentStatus(agent.id);
+        // #466 — fast exit path must wake the spawn-parent. recordAgentExitDiagnostics already
+        // flipped the agent offline (above), so the stale-agent-reaper will structurally skip it
+        // (its WHERE excludes status='offline'), guaranteeing a single notifyAgentOffline emission.
+        // notifyAgentOffline no-ops for non-spawned agents. Only fire when we actually recorded the
+        // exit (agent !== null) so an already-offline row can't double-notify.
+        notifyAgentOffline(exited.agentId, exitReason(exited));
+      }
       auditEvent({
         clientId: [
           "managed-session-exit",
@@ -248,6 +257,17 @@ export const patchOrchestratorAgents: Handler = async (req, params) => {
   }
 };
 
+// #466 — derive a human-meaningful offline cause for the spawn-parent notification from the exit
+// diagnostics, in preference to the reaper's generic "heartbeat lost". Prefer the captured
+// lastError, then the systemd result (e.g. "success", "signal"), else a plain fallback.
+function exitReason(exited: ManagedSessionExitDiagnostics): string {
+  const lastError = exited.lastError?.trim();
+  if (lastError) return lastError;
+  const result = exited.systemd?.result?.trim();
+  if (result) return `exited (${result})`;
+  return "exited";
+}
+
 function cleanManagedSessionExitDiagnostics(value: unknown, index: number): ManagedSessionExitDiagnostics {
   if (!isRecord(value)) throw new ValidationError(`exitedAgents[${index}] must be an object`);
   const provider = optionalEnum(value.provider, `exitedAgents[${index}].provider`, SPAWN_PROVIDERS);