agent-relay-server 0.4.38 → 0.5.0

package/package.json

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

package/public/dashboard.js

@@ -6,6 +6,7 @@
   const DEFAULT_INBOX_COMPOSE = { toMode: "agent", to: "", body: "", channel: "", subject: "", claimable: false };
   const DEFAULT_PAIR_MESSAGE = { pairId: "", from: "", body: "", subject: "" };
   const DEFAULT_PAIR_INVITE = { requesterId: "", targetId: "", objective: "" };
+  const DEFAULT_AGENT_SPAWN = { provider: "codex", approvalMode: "guarded", cwd: "", label: "" };
   const CLOSED_TASK_STATUSES = new Set(["done", "failed", "canceled"]);
   const WAITING_TASK_STATUSES = new Set(["open", "blocked"]);
   const STATUS_SORT_ORDER = { online: 0, idle: 1, busy: 2, offline: 3 };
@@ -15,6 +16,7 @@
     claude: "claude-sol",
     user: "ti-user",
     system: "ti-server",
+    channel: "ti-messages",
     agent: "ti-robot",
   };
   const AGENT_TYPE_TITLES = {
@@ -22,6 +24,7 @@
     claude: "Claude agent",
     user: "Human operator",
     system: "System",
+    channel: "Channel",
     agent: "Agent",
   };
 
@@ -51,6 +54,7 @@
 
       agents: [],
       agentsById: {},
+      orchestrators: [],
       pairs: [],
       messages: [],
       tasks: [],
@@ -76,9 +80,21 @@
       selectedAgent: "",
       agentDetailOpen: false,
       agentDetailId: "",
+      channelDetailOpen: false,
+      channelDetailId: "",
       selectedInboxThread: "",
       replyTo: null,
       composeOpen: false,
+      agentSpawnOpen: false,
+      orchestratorSpawnOpen: false,
+      spawnOrchId: "",
+      spawnProvider: "claude",
+      spawnCwd: "",
+      spawnLabel: "",
+      spawnApproval: "guarded",
+      spawnPrompt: "",
+      spawnDirListing: null,
+      agentDirectoryBrowser: { open: false, loading: false, path: "", parent: "", home: "", cwd: "", entries: [], error: "" },
       pairInviteOpen: false,
       pairMessageOpen: false,
       threadOpen: false,
@@ -90,6 +106,7 @@
       authNeeded: false,
 
       compose: { ...DEFAULT_COMPOSE },
+      agentSpawn: { ...DEFAULT_AGENT_SPAWN },
       pairInvite: { ...DEFAULT_PAIR_INVITE },
       pairMessage: { ...DEFAULT_PAIR_MESSAGE },
       inboxCompose: { ...DEFAULT_INBOX_COMPOSE },
@@ -273,6 +290,8 @@
     es.addEventListener("message.claimed", (event) => handleMessageClaimed(this, parseEventData(event)));
     es.addEventListener("message.claim_released", (event) => handleMessageClaimReleased(this, parseEventData(event)));
     es.addEventListener("message.deleted", (event) => handleMessageDeleted(this, parseEventData(event)));
+    es.addEventListener("orchestrator.status", (event) => handleOrchestratorStatus(this, parseEventData(event)));
+    es.addEventListener("orchestrator.removed", (event) => handleOrchestratorRemoved(this, parseEventData(event)));
     registerTaskEvents(this, es);
   }
 
@@ -312,6 +331,14 @@
     refreshChartsIfVisible(vm);
   }
 
+  function handleOrchestratorStatus(vm, orch) {
+    upsertById(vm.orchestrators, orch);
+  }
+
+  function handleOrchestratorRemoved(vm, data) {
+    vm.orchestrators = vm.orchestrators.filter((o) => o.id !== data.id);
+  }
+
   function handleMessageClaimed(vm, data) {
     const msg = vm.messages.find((item) => item.id === data.messageId);
     if (!msg) return;
@@ -366,7 +393,7 @@
       },
 
       async refresh() {
-        await Promise.all([this.fetchStats(), this.fetchHealth(), this.fetchAgents(), this.fetchPairs(), this.fetchMessages(), this.fetchTasks(), this.fetchChannels(), this.fetchIntegrations(), this.fetchInboxState(), this.fetchActivityEvents()]);
+        await Promise.all([this.fetchStats(), this.fetchHealth(), this.fetchAgents(), this.fetchOrchestrators(), this.fetchPairs(), this.fetchMessages(), this.fetchTasks(), this.fetchChannels(), this.fetchIntegrations(), this.fetchInboxState(), this.fetchActivityEvents()]);
       },
 
       async refreshLiveData() {
@@ -399,6 +426,12 @@
         } catch {}
       },
 
+      async fetchOrchestrators() {
+        try {
+          this.orchestrators = await this.api("GET", "/orchestrators");
+        } catch {}
+      },
+
       async fetchPairs() {
         try {
           let pairs;
@@ -496,11 +529,14 @@
   function createComputedDescriptors() {
     return {
       onlineCount: { get: getOnlineCount },
+      busyAgentCount: { get: getBusyAgentCount },
       hiddenBuiltInAgentCount: { get: getHiddenBuiltInAgentCount },
       sortedAgents: { get: getSortedAgents },
       pairsByAgentId: { get: getPairsByAgentId },
       selectedAgentDetail: { get: getSelectedAgentDetail },
       agentDetailMessages: { get: getAgentDetailMessages },
+      selectedChannelDetail: { get: getSelectedChannelDetail },
+      channelDetailMessages: { get: getChannelDetailMessages },
       pairMessagePair: { get: getPairMessagePair },
       allInboxThreads: { get: getAllInboxThreads },
       inboxThreads: { get: getInboxThreads },
@@ -513,6 +549,7 @@
       workQueueItems: { get: getWorkQueueItems },
       channelCards: { get: getChannelCards },
       integrationCards: { get: getIntegrationCards },
+      openPairCount: { get: getOpenPairCount },
       filteredMessages: { get: getFilteredMessages },
       groupedMessages: { get: getGroupedMessages },
       filteredTasks: { get: getFilteredTasks },
@@ -523,13 +560,23 @@
       healthIssues: { get: getHealthIssues },
       healthDiagnostics: { get: getHealthDiagnostics },
       commandPaletteItems: { get: getCommandPaletteItems },
+      spawnAvailableProviders: { get: getSpawnAvailableProviders },
     };
   }
 
+  function getSpawnAvailableProviders() {
+    const orch = this.orchestrators.find((o) => o.id === this.spawnOrchId);
+    return orch ? orch.providers : ["claude", "codex"];
+  }
+
   function getOnlineCount() {
     return visibleAgents(this).filter((agent) => agent.status !== "offline").length;
   }
 
+  function getBusyAgentCount() {
+    return this.agents.filter((agent) => agent.status === "busy").length;
+  }
+
   function getHiddenBuiltInAgentCount() {
     return this.showBuiltIns ? 0 : this.agents.filter(isBuiltInAgent).length;
   }
@@ -578,6 +625,29 @@
       .slice(0, 8);
   }
 
+  function getSelectedChannelDetail() {
+    if (!this.channelDetailId) return null;
+    return (this.channels || []).find((channel) => channel.id === this.channelDetailId) || null;
+  }
+
+  function getChannelDetailMessages() {
+    const channel = this.selectedChannelDetail;
+    if (!channel) return [];
+    return this.messages
+      .filter((msg) => messageMatchesChannel(msg, channel))
+      .slice()
+      .sort((a, b) => b.id - a.id)
+      .slice(0, 8);
+  }
+
+  function messageMatchesChannel(message, channel) {
+    if (!message || !channel) return false;
+    const channelKeys = [channel.id, channel.type, ...(channel.topicChannels || [])].filter(Boolean);
+    if (message.channel && channelKeys.includes(message.channel)) return true;
+    if (channel.agentId && (message.from === channel.agentId || message.to === channel.agentId)) return true;
+    return false;
+  }
+
   function getPairMessagePair() {
     return this.pairs.find((pair) => pair.id === this.pairMessage.pairId) || null;
   }
@@ -1071,11 +1141,47 @@
     });
   }
 
+  function getOpenPairCount() {
+    return (this.pairs || []).filter(isOpenPair).length;
+  }
+
+  function isOpenPair(pair) {
+    return pair?.status === "active" || pair?.status === "pending";
+  }
+
   function getComposeAgents() {
     const list = visibleAgents(this);
     return this.showOffline ? list : list.filter((agent) => agent.status !== "offline");
   }
 
+  function composeTargetAllowsClaimable() {
+    return matchingComposeRecipientCount(this, this.compose.to) > 1;
+  }
+
+  function inboxComposeTargetAllowsClaimable() {
+    return matchingComposeRecipientCount(this, inboxComposeTarget(this)) > 1;
+  }
+
+  function matchingComposeRecipientCount(vm, target) {
+    if (!target) return 0;
+    const candidates = vm.composeAgents.filter((agent) => !isBuiltInAgent(agent) && !isChannelAgent(agent));
+    if (target === "broadcast") return candidates.length;
+    if (vm.agentsById[target]) return 1;
+    if (target.startsWith("tag:")) {
+      const tag = target.slice(4);
+      return candidates.filter((agent) => (agent.tags || []).includes(tag)).length;
+    }
+    if (target.startsWith("cap:")) {
+      const cap = target.slice(4);
+      return candidates.filter((agent) => (agent.capabilities || []).includes(cap)).length;
+    }
+    if (target.startsWith("label:")) {
+      const label = target.slice(6);
+      return candidates.filter((agent) => agent.label === label).length;
+    }
+    return 1;
+  }
+
   function getUniqueLabels() {
     return [...new Set(visibleAgents(this).filter((agent) => agent.label).map((agent) => agent.label))];
   }
@@ -1089,13 +1195,22 @@
   }
 
   function visibleAgents(vm) {
-    return vm.showBuiltIns ? [...vm.agents] : vm.agents.filter((agent) => !isBuiltInAgent(agent));
+    const nonChannelAgents = vm.agents.filter((agent) => !isChannelAgent(agent));
+    return vm.showBuiltIns ? nonChannelAgents : nonChannelAgents.filter((agent) => !isBuiltInAgent(agent));
   }
 
   function isBuiltInAgent(agent) {
     return agent?.meta?.builtin === true || agent?.id === HUMAN_AGENT_ID || agent?.id === "system";
   }
 
+  function isChannelAgent(agent) {
+    return agent?.meta?.kind === "channel" || agent?.tags?.includes("channel");
+  }
+
+  function agentSupportsControlActions(agent) {
+    return Boolean(agent && !isBuiltInAgent(agent) && !isChannelAgent(agent));
+  }
+
   function applyAgentPreset(vm, list) {
     switch (vm.agentPresetFilter) {
       case "active":
@@ -1249,6 +1364,9 @@
       agentChannels,
       channelPresence,
       integrationPresence,
+      composeTargetAllowsClaimable,
+      inboxComposeTargetAllowsClaimable,
+      agentSupportsControlActions,
       timeAgo,
       fmtTime,
       healthAlertClass,
@@ -1368,6 +1486,7 @@
   function agentType(agent) {
     if (agent?.id === HUMAN_AGENT_ID) return "user";
     if (agent?.id === "system") return "system";
+    if (isChannelAgent(agent)) return "channel";
 
     const values = [
       ...(agent?.tags || []),
@@ -1573,6 +1692,18 @@
       openPairInvite,
       closePairInvite,
       doCreatePair,
+      openAgentSpawn,
+      closeAgentSpawn,
+      doSpawnAgent,
+      openAgentDirectoryBrowser,
+      browseAgentDirectory,
+      selectAgentDirectory,
+      openOrchestratorSpawn,
+      openOrchestratorSpawnFor,
+      browseOrchestratorDirs,
+      submitOrchestratorSpawn,
+      orchestratorAction,
+      deleteOrchestrator,
       doSendPairMessage,
       doAcceptPair,
       doRejectPair,
@@ -1783,7 +1914,7 @@
   }
 
   function resetInboxComposeTarget() {
-    this.inboxCompose = { ...this.inboxCompose, to: "" };
+    this.inboxCompose = { ...this.inboxCompose, to: "", claimable: false };
   }
 
   function inboxComposeTarget(vm) {
@@ -1809,14 +1940,14 @@
       };
       if (this.inboxCompose.channel) payload.channel = this.inboxCompose.channel;
       if (this.inboxCompose.subject) payload.subject = this.inboxCompose.subject;
-      if (this.inboxCompose.claimable) payload.claimable = true;
+      if (this.inboxCompose.claimable && inboxComposeTargetAllowsClaimable.call(this)) payload.claimable = true;
       await this.api("POST", "/messages", payload);
       this.recordOperatorActivity({
-        title: this.inboxCompose.claimable ? "Claimable task sent" : "Message sent",
+        title: payload.claimable ? "Claimable task sent" : "Message sent",
         body: this.inboxCompose.subject || this.inboxCompose.body,
         meta: "to " + this.displayTarget(target),
-        icon: this.inboxCompose.claimable ? "ti-hand-grab" : "ti-send",
-        kind: this.inboxCompose.claimable ? "task" : "operator",
+        icon: payload.claimable ? "ti-hand-grab" : "ti-send",
+        kind: payload.claimable ? "task" : "operator",
         view: inboxPeer(payload) ? "inbox" : "messages",
         peer: inboxPeer(payload),
       });
@@ -1832,7 +1963,7 @@
     this.replyTo = { id: msg.id, from: msg.from };
     this.compose = {
       ...DEFAULT_COMPOSE,
-      from: this.view === "inbox" ? HUMAN_AGENT_ID : "",
+      from: HUMAN_AGENT_ID,
       to: replyTarget,
       channel: msg.channel || "",
     };
@@ -1852,7 +1983,7 @@
     if (vm.compose.channel) payload.channel = vm.compose.channel;
     if (vm.compose.subject) payload.subject = vm.compose.subject;
     if (vm.replyTo) payload.replyTo = vm.replyTo.id;
-    if (vm.compose.claimable) payload.claimable = true;
+    if (vm.compose.claimable && composeTargetAllowsClaimable.call(vm)) payload.claimable = true;
     return payload;
   }
 
@@ -1876,7 +2007,7 @@
       });
       this.composeOpen = false;
       this.replyTo = null;
-      this.compose = { ...DEFAULT_COMPOSE };
+      this.compose = { ...DEFAULT_COMPOSE, from: HUMAN_AGENT_ID };
       await this.fetchMessages();
     } catch (e) {
       alert("Send failed: " + e.message);
@@ -2313,6 +2444,167 @@
     }
   }
 
+  function openAgentSpawn() {
+    this.agentSpawn = { ...DEFAULT_AGENT_SPAWN };
+    this.agentDirectoryBrowser = { open: false, loading: false, path: "", parent: "", home: "", cwd: "", entries: [], error: "" };
+    this.agentSpawnOpen = true;
+    this.$nextTick(() => this.$refs?.agentSpawnCwd?.focus());
+  }
+
+  function closeAgentSpawn() {
+    this.agentSpawnOpen = false;
+    this.agentSpawn = { ...DEFAULT_AGENT_SPAWN };
+  }
+
+  async function openAgentDirectoryBrowser() {
+    this.agentDirectoryBrowser = { ...this.agentDirectoryBrowser, open: true };
+    await this.browseAgentDirectory(this.agentSpawn.cwd || "");
+  }
+
+  async function browseAgentDirectory(path) {
+    this.agentDirectoryBrowser = { ...this.agentDirectoryBrowser, loading: true, error: "" };
+    try {
+      const query = path ? "?path=" + encodeURIComponent(path) : "";
+      const listing = await this.api("GET", "/agents/spawn/directories" + query);
+      this.agentDirectoryBrowser = {
+        open: true,
+        loading: false,
+        path: listing.path || "",
+        parent: listing.parent || "",
+        home: listing.home || "",
+        cwd: listing.cwd || "",
+        entries: listing.entries || [],
+        error: "",
+      };
+      this.agentSpawn = { ...this.agentSpawn, cwd: listing.path || this.agentSpawn.cwd };
+    } catch (e) {
+      this.agentDirectoryBrowser = { ...this.agentDirectoryBrowser, loading: false, error: e.message };
+    }
+  }
+
+  function selectAgentDirectory(path) {
+    this.agentSpawn = { ...this.agentSpawn, cwd: path || this.agentDirectoryBrowser.path };
+    this.agentDirectoryBrowser = { ...this.agentDirectoryBrowser, open: false };
+  }
+
+  async function doSpawnAgent() {
+    if (this.agentSpawn.provider !== "codex") {
+      alert("Only Codex live sessions can be spawned from the dashboard right now.");
+      return;
+    }
+    try {
+      const payload = {
+        provider: "codex",
+        approvalMode: this.agentSpawn.approvalMode || "guarded",
+      };
+      if (this.agentSpawn.cwd) payload.cwd = this.agentSpawn.cwd;
+      if (this.agentSpawn.label) payload.label = this.agentSpawn.label;
+      const result = await this.api("POST", "/agents/spawn", payload);
+      this.recordOperatorActivity({
+        title: "Codex agent spawn requested",
+        body: result?.cwd || payload.cwd || "",
+        meta: result?.pid ? "pid " + result.pid : "starting",
+        icon: "ti-plus",
+        kind: "state",
+        view: "agents",
+      });
+      this.closeAgentSpawn();
+      await Promise.all([this.fetchAgents(), this.fetchActivityEvents()]);
+    } catch (e) {
+      alert("Spawn failed: " + e.message);
+    }
+  }
+
+  // --- Orchestrator methods ---
+
+  function openOrchestratorSpawn() {
+    const online = this.orchestrators.filter((o) => o.status === "online");
+    if (online.length === 0) return alert("No orchestrators online");
+    this.spawnOrchId = online[0].id;
+    this.spawnProvider = "claude";
+    this.spawnCwd = "";
+    this.spawnLabel = "";
+    this.spawnApproval = "guarded";
+    this.spawnPrompt = "";
+    this.spawnDirListing = null;
+    this.orchestratorSpawnOpen = true;
+  }
+
+  function openOrchestratorSpawnFor(orchId) {
+    this.spawnOrchId = orchId;
+    this.spawnProvider = "claude";
+    this.spawnCwd = "";
+    this.spawnLabel = "";
+    this.spawnApproval = "guarded";
+    this.spawnPrompt = "";
+    this.spawnDirListing = null;
+    this.orchestratorSpawnOpen = true;
+  }
+
+  async function browseOrchestratorDirs() {
+    try {
+      const query = this.spawnCwd ? "?path=" + encodeURIComponent(this.spawnCwd) : "";
+      this.spawnDirListing = await this.api("GET", "/agents/spawn/directories" + query);
+    } catch (e) {
+      alert("Directory browse failed: " + e.message);
+    }
+  }
+
+  async function submitOrchestratorSpawn() {
+    if (!this.spawnOrchId) return alert("Select an orchestrator");
+    try {
+      const payload = {
+        provider: this.spawnProvider,
+        approvalMode: this.spawnApproval,
+      };
+      if (this.spawnCwd) payload.cwd = this.spawnCwd;
+      if (this.spawnLabel) payload.label = this.spawnLabel;
+      if (this.spawnPrompt) payload.prompt = this.spawnPrompt;
+      await this.api("POST", "/orchestrators/" + encodeURIComponent(this.spawnOrchId) + "/spawn", payload);
+      this.orchestratorSpawnOpen = false;
+      this.recordOperatorActivity({
+        title: `${this.spawnProvider} agent spawn requested`,
+        body: this.spawnCwd || "",
+        meta: this.spawnOrchId,
+        icon: "ti-plus",
+        kind: "state",
+        view: "orchestrators",
+      });
+      await Promise.all([this.fetchOrchestrators(), this.fetchActivityEvents()]);
+    } catch (e) {
+      alert("Spawn failed: " + e.message);
+    }
+  }
+
+  async function orchestratorAction(orchId, action, agentId) {
+    const label = action === "restart" ? "Restart" : "Shutdown";
+    if (!confirm(`${label} agent "${agentId || "all"}" on orchestrator "${orchId}"?`)) return;
+    try {
+      await this.api("POST", "/orchestrators/" + encodeURIComponent(orchId) + "/actions", { action, agentId });
+      this.recordOperatorActivity({
+        title: `Agent ${action} requested`,
+        body: agentId || "all agents",
+        meta: orchId,
+        icon: action === "restart" ? "ti-refresh" : "ti-power",
+        kind: "state",
+        view: "orchestrators",
+      });
+      await Promise.all([this.fetchOrchestrators(), this.fetchActivityEvents()]);
+    } catch (e) {
+      alert(`${label} failed: ` + e.message);
+    }
+  }
+
+  async function deleteOrchestrator(orchId) {
+    if (!confirm(`Remove orchestrator "${orchId}"? This will NOT stop its managed agents.`)) return;
+    try {
+      await this.api("DELETE", "/orchestrators/" + encodeURIComponent(orchId));
+      await this.fetchOrchestrators();
+    } catch (e) {
+      alert("Delete failed: " + e.message);
+    }
+  }
+
   function closePairMessage() {
     this.pairMessageOpen = false;
     this.pairMessage = { ...DEFAULT_PAIR_MESSAGE };
@@ -2409,6 +2701,16 @@
         this.agentDetailOpen = false;
       },
 
+      openChannelDetail(channel) {
+        if (!channel) return;
+        this.channelDetailId = channel.id;
+        this.channelDetailOpen = true;
+      },
+
+      closeChannelDetail() {
+        this.channelDetailOpen = false;
+      },
+
       openRename(agent) {
         this.renameModal = { show: true, agentId: agent.id, label: agent.label || "" };
         this.$nextTick(() => this.$refs.renameInput?.focus());
@@ -2438,6 +2740,26 @@
           alert("Delete failed: " + e.message);
         }
       },
+
+      async doAgentAction(agent, action) {
+        if (!agent || !action) return;
+        try {
+          const result = await this.api("POST", "/agents/" + encodeURIComponent(agent.id) + "/actions", { action });
+          this.recordOperatorActivity({
+            title: action === "restart" ? "Agent restart requested" : "Agent shutdown requested",
+            body: this.displayName(agent),
+            meta: agent.id,
+            icon: action === "restart" ? "ti-refresh" : "ti-power",
+            kind: "state",
+            view: "agents",
+            agentId: agent.id,
+            messageId: result?.message?.id,
+          });
+          await Promise.all([this.fetchMessages(), this.fetchActivityEvents()]);
+        } catch (e) {
+          alert("Agent action failed: " + e.message);
+        }
+      },
     };
   }
 
@@ -2495,7 +2817,7 @@
 
   function renderStatusChart() {
     const { labels, series } = countAgentStatuses(this.agents);
-    const colorMap = { online: "#48bb78", idle: "#48bb78", busy: "#ecc94b", offline: "#718096" };
+    const colorMap = { idle: "#4299e1", busy: "#ecc94b" };
 
     if (this.chartInstances.status) {
       this.chartInstances.status.updateOptions({
@@ -2522,10 +2844,12 @@
   }
 
   function countAgentStatuses(agents) {
-    const counts = { online: 0, idle: 0, busy: 0, offline: 0 };
-    for (const agent of agents) counts[agent.status] = (counts[agent.status] || 0) + 1;
+    const counts = { idle: 0, busy: 0 };
+    for (const agent of agents) {
+      if (agent.status in counts) counts[agent.status] += 1;
+    }
 
-    const labels = Object.keys(counts).filter((key) => counts[key] > 0);
+    const labels = Object.keys(counts);
     return { labels, series: labels.map((key) => counts[key]) };
   }