agent-relay-server 0.4.34 → 0.4.36

package/package.json

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

package/public/dashboard.js

@@ -12,12 +12,16 @@
   const LIVE_REFRESH_MS = 5_000;
   const AGENT_TYPE_ICONS = {
     codex: "ti-terminal-2",
-    claude: "ti-sparkles",
+    claude: "claude-sol",
+    user: "ti-user",
+    system: "ti-server",
     agent: "ti-robot",
   };
   const AGENT_TYPE_TITLES = {
     codex: "Codex agent",
     claude: "Claude agent",
+    user: "Human operator",
+    system: "System",
     agent: "Agent",
   };
 
@@ -62,6 +66,8 @@
       inboxArchivedThreads: loadPref("inboxArchivedThreads", {}),
       inboxDrafts: loadPref("inboxDrafts", {}),
       inboxSearch: "",
+      inboxSort: loadPref("inboxSort", "attention"),
+      inboxSortDir: loadPref("inboxSortDir", "desc"),
       inboxShowArchived: loadPref("inboxShowArchived", false),
       operatorActivity: loadPref("operatorActivity", []),
       activityEvents: [],
@@ -121,6 +127,8 @@
     vm.$watch("agentStatusFilter", (value) => vm.save("agentStatusFilter", value));
     vm.$watch("agentTagFilter", (value) => vm.save("agentTagFilter", value));
     vm.$watch("pairStatusFilter", (value) => vm.save("pairStatusFilter", value));
+    vm.$watch("inboxSort", (value) => vm.save("inboxSort", value));
+    vm.$watch("inboxSortDir", (value) => vm.save("inboxSortDir", value));
     vm.$watch("inboxShowArchived", (value) => vm.save("inboxShowArchived", value));
     vm.$watch("activityFilter", (value) => vm.save("activityFilter", value));
     vm.$watch("view", (value, oldValue) => {
@@ -580,11 +588,32 @@
 
   function getInboxThreads() {
     const search = this.inboxSearch.trim().toLowerCase();
-    return this.allInboxThreads.filter((thread) => {
+    const filtered = this.allInboxThreads.filter((thread) => {
       if (!this.inboxShowArchived && thread.archived) return false;
       if (search && !threadMatchesSearch(this, thread, search)) return false;
       return true;
     });
+    return sortInboxThreads(filtered, this.inboxSort, this.inboxSortDir);
+  }
+
+  function sortInboxThreads(threads, sort, dir) {
+    const mul = dir === "asc" ? 1 : -1;
+    return [...threads].sort((a, b) => {
+      switch (sort) {
+        case "updated":
+          return mul * ((b.lastMessage?.id || 0) - (a.lastMessage?.id || 0));
+        case "created": {
+          const aFirst = a.messages[0]?.id || 0;
+          const bFirst = b.messages[0]?.id || 0;
+          return mul * (bFirst - aFirst);
+        }
+        case "name":
+          return mul * String(a.peer).localeCompare(String(b.peer));
+        case "attention":
+        default:
+          return compareInboxThreads(a, b) * mul;
+      }
+    });
   }
 
   function buildInboxThreads(vm) {
@@ -647,16 +676,15 @@
     const pendingPairInvites = this.pairs.filter((pair) => pair.status === "pending").length;
     const claimableTasks = countClaimableWaiting(this);
     const unreadInbox = threads.reduce((sum, thread) => sum + (thread.attention?.unread || 0), 0);
-    const needsHumanResponse = threads.filter((thread) => thread.attention?.needsHumanResponse).length;
     const agentQuestions = threads.filter((thread) => thread.attention?.agentQuestion).length;
 
     return {
       unreadInbox,
-      needsHumanResponse,
+      needsHumanResponse: 0,
       agentQuestions,
       pendingPairInvites,
       claimableTasks,
-      total: unreadInbox + needsHumanResponse + agentQuestions + pendingPairInvites + claimableTasks,
+      total: unreadInbox + agentQuestions + pendingPairInvites + claimableTasks,
     };
   }
 
@@ -910,18 +938,16 @@
 
   function getThreadAttention(vm, thread) {
     const lastHumanReplyId = maxMessageId(thread.messages, (msg) => msg.from === HUMAN_AGENT_ID);
-    const lastInboundId = maxMessageId(thread.messages, isHumanInboundMessage);
     const unread = thread.messages.filter((msg) => isUnreadHumanMessage(vm, thread.peer, msg)).length;
-    const needsHumanResponse = lastInboundId > lastHumanReplyId;
     const agentQuestion = thread.messages.some((msg) =>
       isHumanInboundMessage(msg) && msg.id > lastHumanReplyId && messageLooksLikeQuestion(msg)
     );
 
     return {
       unread,
-      needsHumanResponse,
+      needsHumanResponse: false,
       agentQuestion,
-      score: unread * 10 + (needsHumanResponse ? 5 : 0) + (agentQuestion ? 3 : 0),
+      score: unread * 10 + (agentQuestion ? 3 : 0),
     };
   }
 
@@ -1219,6 +1245,7 @@
       agentStatusClass,
       severityClass,
       agentStatusTitle,
+      isBuiltInAgent,
       agentChannels,
       channelPresence,
       integrationPresence,
@@ -1301,18 +1328,16 @@
     const claimableTasks = countAgentClaimableWaiting(this, agent);
     const attention = {
       unread: thread?.attention?.unread || 0,
-      needsHumanResponse: Boolean(thread?.attention?.needsHumanResponse),
+      needsHumanResponse: false,
       agentQuestion: Boolean(thread?.attention?.agentQuestion),
       pendingPairInvite,
       claimableTasks,
     };
     attention.total = attention.unread +
-      (attention.needsHumanResponse ? 1 : 0) +
       (attention.agentQuestion ? 1 : 0) +
       (attention.pendingPairInvite ? 1 : 0) +
       attention.claimableTasks;
     attention.score = attention.unread * 10 +
-      (attention.needsHumanResponse ? 5 : 0) +
       (attention.agentQuestion ? 3 : 0) +
       (attention.pendingPairInvite ? 4 : 0) +
       attention.claimableTasks * 2;
@@ -1322,7 +1347,6 @@
   function emptyAttention() {
     return {
       unread: 0,
-      needsHumanResponse: false,
       agentQuestion: false,
       pendingPairInvite: false,
       claimableTasks: 0,
@@ -1335,7 +1359,6 @@
     const attention = agentAttention.call(this, agent);
     const parts = [];
     if (attention.unread) parts.push(`${attention.unread} unread`);
-    if (attention.needsHumanResponse) parts.push("needs human response");
     if (attention.agentQuestion) parts.push("agent asked a question");
     if (attention.pendingPairInvite) parts.push("pair invite pending");
     if (attention.claimableTasks) parts.push(`${attention.claimableTasks} claimable waiting`);
@@ -1343,6 +1366,9 @@
   }
 
   function agentType(agent) {
+    if (agent?.id === HUMAN_AGENT_ID) return "user";
+    if (agent?.id === "system") return "system";
+
     const values = [
       ...(agent?.tags || []),
       agent?.meta?.provider,
@@ -1397,18 +1423,13 @@
     return { label: agent?.status === "idle" ? "idle" : "ready", tone: "success", icon: "ti-circle-check", stale, reconnecting, badges: presenceBadges(attention, pair, {}) };
   }
 
-  function presenceBadges(attention, pair, flags) {
+  function presenceBadges(attention, pair, _flags) {
     const badges = [];
-    if (flags.reconnecting) badges.push({ label: "reconnecting", className: "bg-danger-lt" });
-    if (flags.starting) badges.push({ label: "online, not ready", className: "bg-warning-lt" });
-    if (flags.busy) badges.push({ label: "busy in turn", className: "bg-warning-lt" });
     if (pair?.status === "active") badges.push({ label: "paired", className: "bg-success-lt" });
     if (pair?.status === "pending") badges.push({ label: "pair invite pending", className: "bg-warning-lt" });
     if (attention.unread) badges.push({ label: attention.unread + " unread", className: "bg-danger-lt" });
-    if (attention.needsHumanResponse) badges.push({ label: "needs response", className: "bg-warning-lt" });
     if (attention.agentQuestion) badges.push({ label: "question", className: "bg-info-lt" });
     if (attention.claimableTasks) badges.push({ label: attention.claimableTasks + " claimable", className: "bg-orange-lt" });
-    if (!badges.length && !flags.offline) badges.push({ label: "ready", className: "bg-success-lt" });
     return badges;
   }
 

package/public/index.html

@@ -74,6 +74,24 @@
     background: rgba(var(--tblr-warning-rgb), 0.12);
     border-color: rgba(var(--tblr-warning-rgb), 0.25);
   }
+  .agent-type-icon.claude .claude-sol {
+    display: inline-block;
+    width: 14px;
+    height: 14px;
+    background-color: currentColor;
+    -webkit-mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cg fill='black' transform='translate(12,12)'%3E%3Crect x='-1.8' y='-10' width='3.6' height='7' rx='1.8'/%3E%3Crect x='-1.8' y='-10' width='3.6' height='7' rx='1.8' transform='rotate(60)'/%3E%3Crect x='-1.8' y='-10' width='3.6' height='7' rx='1.8' transform='rotate(120)'/%3E%3Crect x='-1.8' y='-10' width='3.6' height='7' rx='1.8' transform='rotate(180)'/%3E%3Crect x='-1.8' y='-10' width='3.6' height='7' rx='1.8' transform='rotate(240)'/%3E%3Crect x='-1.8' y='-10' width='3.6' height='7' rx='1.8' transform='rotate(300)'/%3E%3C/g%3E%3C/svg%3E") center/contain no-repeat;
+    mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cg fill='black' transform='translate(12,12)'%3E%3Crect x='-1.8' y='-10' width='3.6' height='7' rx='1.8'/%3E%3Crect x='-1.8' y='-10' width='3.6' height='7' rx='1.8' transform='rotate(60)'/%3E%3Crect x='-1.8' y='-10' width='3.6' height='7' rx='1.8' transform='rotate(120)'/%3E%3Crect x='-1.8' y='-10' width='3.6' height='7' rx='1.8' transform='rotate(180)'/%3E%3Crect x='-1.8' y='-10' width='3.6' height='7' rx='1.8' transform='rotate(240)'/%3E%3Crect x='-1.8' y='-10' width='3.6' height='7' rx='1.8' transform='rotate(300)'/%3E%3C/g%3E%3C/svg%3E") center/contain no-repeat;
+  }
+  .agent-type-icon.user {
+    color: var(--tblr-green);
+    background: rgba(var(--tblr-green-rgb), 0.12);
+    border-color: rgba(var(--tblr-green-rgb), 0.25);
+  }
+  .agent-type-icon.system {
+    color: var(--tblr-purple);
+    background: rgba(var(--tblr-purple-rgb), 0.12);
+    border-color: rgba(var(--tblr-purple-rgb), 0.25);
+  }
   .agent-type-icon.agent {
     color: var(--tblr-secondary);
     background: var(--tblr-bg-surface-secondary);
@@ -389,14 +407,6 @@
               </div>
             </button>
           </div>
-          <div class="col-md-6 col-xl">
-            <button class="card attention-card w-100 text-start" :class="{ 'attention-empty': attentionSummary.needsHumanResponse === 0 }" @click="switchView('inbox')">
-              <div class="card-body py-3">
-                <div class="text-secondary small">Needs response</div>
-                <div class="h2 mb-0" :class="attentionSummary.needsHumanResponse ? 'text-warning' : ''" x-text="attentionSummary.needsHumanResponse"></div>
-              </div>
-            </button>
-          </div>
           <div class="col-md-6 col-xl">
             <button class="card attention-card w-100 text-start" :class="{ 'attention-empty': attentionSummary.agentQuestions === 0 }" @click="switchView('inbox')">
               <div class="card-body py-3">
@@ -597,7 +607,7 @@
                           </span>
                         </template>
                       </div>
-                      <div class="text-secondary small mt-1" x-text="'Last seen: ' + timeAgo(a.lastSeen)"></div>
+                      <div class="text-secondary small mt-1" x-show="!isBuiltInAgent(a)" x-text="'Last seen: ' + timeAgo(a.lastSeen)"></div>
                     </div>
                     <div class="agent-actions d-flex gap-1">
                       <button class="btn btn-sm btn-ghost-secondary p-1" title="Send message" @click.stop="openComposeToAgent(a)">
@@ -801,10 +811,18 @@
         <div class="d-flex align-items-center mb-3 gap-2 flex-wrap">
           <h2 class="page-title mb-0">Inbox</h2>
           <span class="badge bg-danger-lt" x-show="attentionSummary.unreadInbox > 0" x-text="attentionSummary.unreadInbox + ' unread'"></span>
-          <span class="badge bg-warning-lt" x-show="attentionSummary.needsHumanResponse > 0" x-text="attentionSummary.needsHumanResponse + ' need response'"></span>
           <span class="badge bg-info-lt" x-show="attentionSummary.agentQuestions > 0" x-text="attentionSummary.agentQuestions + ' questions'"></span>
           <div class="ms-auto d-flex gap-2 align-items-center flex-wrap">
-            <input type="search" class="form-control form-control-sm" style="width: 220px" placeholder="Search inbox" x-model.debounce.200ms="inboxSearch">
+            <input type="search" class="form-control form-control-sm" style="width: 180px" placeholder="Search inbox" x-model.debounce.200ms="inboxSearch">
+            <select class="form-select form-select-sm" style="width: 130px" x-model="inboxSort">
+              <option value="attention">Sort: Attention</option>
+              <option value="updated">Sort: Updated</option>
+              <option value="created">Sort: Created</option>
+              <option value="name">Sort: Name</option>
+            </select>
+            <button class="btn btn-sm btn-ghost-secondary" @click="inboxSortDir = inboxSortDir === 'asc' ? 'desc' : 'asc'">
+              <i class="ti" :class="inboxSortDir === 'asc' ? 'ti-sort-ascending' : 'ti-sort-descending'"></i>
+            </button>
             <label class="form-check form-switch mb-0">
               <input type="checkbox" class="form-check-input" x-model="inboxShowArchived">
               <span class="form-check-label small">Archived</span>
@@ -876,10 +894,11 @@
                       <span class="text-secondary small ms-auto" x-text="timeAgo(thread.lastMessage?.createdAt)"></span>
                     </div>
                     <div class="text-secondary small text-truncate mt-1 inbox-thread-snippet" x-text="messagePreview(thread.lastMessage)"></div>
-                    <div class="attention-badges d-flex gap-1 mt-1 flex-wrap" x-show="thread.attention?.score > 0">
-                      <span class="badge bg-warning-lt" x-show="thread.attention?.needsHumanResponse">needs response</span>
-                      <span class="badge bg-info-lt" x-show="thread.attention?.agentQuestion">agent asked a question</span>
-                    </div>
+                    <template x-if="thread.attention?.agentQuestion">
+                      <div class="d-flex gap-1 mt-1 flex-wrap">
+                        <span class="badge bg-info-lt">agent asked a question</span>
+                      </div>
+                    </template>
                     <div class="d-flex align-items-center gap-1 mt-2">
                       <span class="badge bg-secondary-lt" x-show="thread.archived">archived</span>
                       <span class="badge bg-primary-lt" x-show="thread.draft">draft</span>
@@ -912,7 +931,6 @@
                   <h3 class="card-title mb-0 text-truncate" x-text="conversationTitle(selectedInboxThreadData)"></h3>
                   <div class="attention-badges d-flex gap-1 flex-wrap">
                     <span class="badge bg-danger-lt" x-show="selectedInboxThreadData.attention?.unread" x-text="selectedInboxThreadData.attention.unread + ' unread'"></span>
-                    <span class="badge bg-warning-lt" x-show="selectedInboxThreadData.attention?.needsHumanResponse">needs response</span>
                     <span class="badge bg-info-lt" x-show="selectedInboxThreadData.attention?.agentQuestion">agent asked a question</span>
                     <span class="badge bg-secondary-lt" x-show="selectedInboxThreadData.archived">archived</span>
                   </div>
@@ -1603,7 +1621,6 @@
               <div class="fw-bold small mb-1">Needs attention</div>
               <div class="attention-badges d-flex gap-1 flex-wrap">
                 <span class="badge bg-danger-lt" x-show="agentAttention(selectedAgentDetail).unread" x-text="agentAttention(selectedAgentDetail).unread + ' unread'"></span>
-                <span class="badge bg-warning-lt" x-show="agentAttention(selectedAgentDetail).needsHumanResponse">needs human response</span>
                 <span class="badge bg-info-lt" x-show="agentAttention(selectedAgentDetail).agentQuestion">agent asked a question</span>
                 <span class="badge bg-warning-lt" x-show="agentAttention(selectedAgentDetail).pendingPairInvite">pair invite pending</span>
                 <span class="badge bg-orange-lt" x-show="agentAttention(selectedAgentDetail).claimableTasks" x-text="agentAttention(selectedAgentDetail).claimableTasks + ' claimable waiting'"></span>
@@ -1619,15 +1636,14 @@
               <template x-for="badge in agentPresenceBadges(selectedAgentDetail)" :key="badge.label">
                 <span class="badge ms-1" :class="badge.className" x-text="badge.label"></span>
               </template>
-              <template x-if="selectedAgentDetail.ready">
-                <span class="badge bg-success-lt ms-1">ready</span>
-              </template>
             </div>
           </div>
-          <div class="detail-row mb-2">
-            <div class="text-secondary small">Last seen</div>
-            <div class="small" x-text="timeAgo(selectedAgentDetail.lastSeen)"></div>
-          </div>
+          <template x-if="!isBuiltInAgent(selectedAgentDetail)">
+            <div class="detail-row mb-2">
+              <div class="text-secondary small">Last seen</div>
+              <div class="small" x-text="timeAgo(selectedAgentDetail.lastSeen)"></div>
+            </div>
+          </template>
           <div class="detail-row mb-2">
             <div class="text-secondary small">Created</div>
             <div class="small" x-text="fmtTime(selectedAgentDetail.createdAt)"></div>

package/src/config.ts

@@ -62,6 +62,3 @@ export function getIntegrationTokens(): IntegrationTokenConfig[] {
     return [];
   }
 }
-
-// Default capabilities for session-start hook when AGENT_RELAY_CAPS is unset.
-export const DEFAULT_CAPABILITIES = ["chat"];

package/src/daemon.ts

@@ -22,9 +22,9 @@ export type DaemonAction =
   | "logs";
 
 export type DaemonScope = "user" | "system";
-export type DaemonKind = "systemd" | "launchd" | "unsupported";
+type DaemonKind = "systemd" | "launchd" | "unsupported";
 
-export type DaemonOptions = {
+type DaemonOptions = {
   action: DaemonAction;
   name?: string;
   envFile?: string;
@@ -36,17 +36,17 @@ export type DaemonOptions = {
   enable?: boolean;
 };
 
-export type DaemonEnvironment = SetupEnvironment & {
+type DaemonEnvironment = SetupEnvironment & {
   uid?: number;
   hasSystemctl?: boolean;
 };
 
-export type DaemonFilePlan = {
+type DaemonFilePlan = {
   path: string;
   content: string;
 };
 
-export type DaemonPlan = {
+type DaemonPlan = {
   action: DaemonAction;
   kind: DaemonKind;
   scope: DaemonScope;
@@ -66,7 +66,7 @@ export type DaemonPlan = {
   manualCommand: string;
 };
 
-export type DaemonExecutionResult = {
+type DaemonExecutionResult = {
   plan: DaemonPlan;
   output: string;
 };

package/src/setup.ts

@@ -8,7 +8,7 @@ const SETUP_MARKER = "agent-relay-managed-env";
 export const DEFAULT_PORT = 4850;
 export const DEFAULT_HOST = "127.0.0.1";
 
-export type SetupOptions = {
+type SetupOptions = {
   envFile?: string;
   host?: string;
   port?: number;
@@ -25,7 +25,7 @@ export type SetupEnvironment = {
   xdgStateHome?: string;
 };
 
-export type SetupPlan = {
+type SetupPlan = {
   envFile: string;
   configDir: string;
   stateDir: string;
@@ -35,14 +35,14 @@ export type SetupPlan = {
   warnings: string[];
 };
 
-export function defaultConfigDir(env: SetupEnvironment = {}): string {
+function defaultConfigDir(env: SetupEnvironment = {}): string {
   const home = env.homeDir ?? homedir();
   const platform = env.platform ?? process.platform;
   if (platform === "darwin") return join(home, "Library", "Application Support", "agent-relay");
   return join(env.xdgConfigHome ?? join(home, ".config"), "agent-relay");
 }
 
-export function defaultStateDir(env: SetupEnvironment = {}): string {
+function defaultStateDir(env: SetupEnvironment = {}): string {
   const home = env.homeDir ?? homedir();
   const platform = env.platform ?? process.platform;
   if (platform === "darwin") return join(home, "Library", "Application Support", "agent-relay");

package/src/upgrade.ts

@@ -5,19 +5,19 @@ import { VERSION } from "./config";
 
 export type UpgradeProvider = "auto" | "all" | "codex" | "claude";
 
-export type UpgradeOptions = {
+type UpgradeOptions = {
   targetVersion?: string;
   providers?: UpgradeProvider[];
   noRestart?: boolean;
 };
 
-export type InstalledPackage = {
+type InstalledPackage = {
   version?: string;
   source: "bun" | "npm" | "copied" | "claude-plugin";
   path?: string;
 };
 
-export type ClaudePluginInstall = {
+type ClaudePluginInstall = {
   id: string;
   version?: string;
   scope?: string;
@@ -37,14 +37,14 @@ export type UpgradeSnapshot = {
   packageManager: "bun" | "npm" | "none";
 };
 
-export type UpgradeAction = {
+type UpgradeAction = {
   label: string;
   command: string[];
   reason: string;
   mutates: boolean;
 };
 
-export type UpgradePlan = {
+type UpgradePlan = {
   targetVersion: string;
   providers: { codex: boolean; claude: boolean };
   snapshot: UpgradeSnapshot;