@sleep2agi/agent-network-dashboard 0.6.3-preview.3 → 0.6.3-preview.4

package/app/components/NodeLifecycleMenu.tsx

@@ -0,0 +1,436 @@
+'use client';
+
+import { useCallback, useEffect, useRef, useState } from 'react';
+
+// RFC-027 PR2 — per-node ⋮ lifecycle menu + stop/delete modals.
+//
+// State-aware menu items (RFC-027 §3.1 table):
+//   active            → 重启 / 停止 / 删除
+//   stopping/deleting → loading (all disabled,菜单 surfaces "请稍候")
+//   stopped           → 启动 / 删除 (停止 灰掉 — already stopped)
+//   stop_failed       → 启动 / 删除 (warn — operator should investigate)
+//
+// Stop modal: low-friction confirm (RFC-027 §3.3)
+// Delete modal: alias-input confirm + force-on-in-flight checkbox
+//   (RFC-027 §3.2; mirrors hub's confirm_alias gate + force semantics).
+//
+// Error propagation per 通信龙 PR2 requirement: structured payloads
+// from hub (node_not_active / cannot_delete_daemon_via_delete_node /
+// node_busy_in_flight / confirm_alias_mismatch / forbidden_cross_tenant)
+// land in `lastError` with their real fields surfaced in the UI — no
+// generic "操作失败".
+//
+// React rules-of-hooks: all hooks declared BEFORE early returns.
+
+export type LifecycleState =
+  | 'active'
+  | 'stopping'
+  | 'stopped'
+  | 'stop_failed'
+  | 'deleting'
+  | string;   // forward-compat for unknown server values
+
+export interface NodeLifecycleMenuProps {
+  nodeId: string;
+  alias: string;
+  lifecycleState: LifecycleState | null | undefined;
+  networkId?: string | null;
+  /** Called when a lifecycle op completes successfully (caller refreshes nodes list). */
+  onCompleted?: () => void;
+}
+
+type LifecycleAction = 'restart' | 'stop' | 'delete';
+
+type ApiReply = {
+  ok?: boolean;
+  error?: string;
+  message?: string;
+  in_flight_count?: number;
+  hint?: string;
+  lifecycle_state?: string;
+  unconfirmed?: boolean;
+  [k: string]: unknown;
+};
+
+const normalizeState = (s: LifecycleState | null | undefined): LifecycleState =>
+  (typeof s === 'string' && s.length > 0 ? s : 'active');
+
+async function callLifecycle(
+  action: LifecycleAction,
+  body: Record<string, unknown>,
+): Promise<ApiReply & { httpStatus: number }> {
+  try {
+    const r = await fetch('/api/anet/node-lifecycle', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ action, ...body }),
+    });
+    const data = (await r.json().catch(() => ({}))) as ApiReply;
+    return { ...data, httpStatus: r.status };
+  } catch (e: unknown) {
+    return {
+      ok: false,
+      error: 'network_error',
+      message: e instanceof Error ? e.message : String(e),
+      httpStatus: 0,
+    };
+  }
+}
+
+export function NodeLifecycleMenu({
+  nodeId,
+  alias,
+  lifecycleState,
+  networkId,
+  onCompleted,
+}: NodeLifecycleMenuProps) {
+  // All hooks above any early return (avoid hooks-order regression that
+  // bit the mobile app at v0.1.29; 通信龙 explicit call-out for PR2).
+  const [menuOpen, setMenuOpen] = useState(false);
+  const [stopModal, setStopModal] = useState(false);
+  const [deleteModal, setDeleteModal] = useState(false);
+  const [restartBusy, setRestartBusy] = useState(false);
+  const [lastError, setLastError] = useState<ApiReply | null>(null);
+  const menuRef = useRef<HTMLDivElement | null>(null);
+
+  // Outside-click + Escape close the menu (focus management).
+  useEffect(() => {
+    if (!menuOpen) return;
+    const onDoc = (e: MouseEvent) => {
+      if (menuRef.current && !menuRef.current.contains(e.target as Node)) setMenuOpen(false);
+    };
+    const onKey = (e: KeyboardEvent) => { if (e.key === 'Escape') setMenuOpen(false); };
+    document.addEventListener('mousedown', onDoc);
+    document.addEventListener('keydown', onKey);
+    return () => {
+      document.removeEventListener('mousedown', onDoc);
+      document.removeEventListener('keydown', onKey);
+    };
+  }, [menuOpen]);
+
+  const onRestart = useCallback(async () => {
+    setMenuOpen(false);
+    setLastError(null);
+    setRestartBusy(true);
+    const r = await callLifecycle('restart', {
+      node_id: nodeId,
+      ...(networkId ? { network_id: networkId } : {}),
+    });
+    setRestartBusy(false);
+    if (r.ok) {
+      onCompleted?.();
+      return;
+    }
+    setLastError(r);
+  }, [nodeId, networkId, onCompleted]);
+
+  const state = normalizeState(lifecycleState);
+  const isLoading = state === 'stopping' || state === 'deleting';
+  const isActive = state === 'active';
+  const isStopped = state === 'stopped' || state === 'stop_failed';
+
+  // Menu items per RFC-027 §3.1 table.
+  const items: Array<{ label: string; key: string; danger?: boolean; onClick: () => void; disabled?: boolean }> = [];
+  if (isLoading) {
+    items.push({
+      label: state === 'stopping' ? '停止中…' : '删除中…',
+      key: 'loading', disabled: true, onClick: () => {},
+    });
+  } else if (isActive) {
+    items.push({ label: restartBusy ? '重启中…' : '重启节点', key: 'restart', disabled: restartBusy, onClick: onRestart });
+    items.push({ label: '停止节点', key: 'stop', onClick: () => { setMenuOpen(false); setStopModal(true); } });
+    items.push({ label: '删除节点', key: 'delete', danger: true, onClick: () => { setMenuOpen(false); setDeleteModal(true); } });
+  } else if (isStopped) {
+    // stopped + stop_failed: "启动" = restart_node (hub resets lifecycle_state→active on success per PR1.2a)
+    items.push({ label: restartBusy ? '启动中…' : '启动节点', key: 'restart', disabled: restartBusy, onClick: onRestart });
+    items.push({ label: '删除节点', key: 'delete', danger: true, onClick: () => { setMenuOpen(false); setDeleteModal(true); } });
+  } else {
+    // Unknown state — surface read-only badge, no destructive action.
+    items.push({
+      label: `状态 ${state} (不识别)`,
+      key: 'unknown', disabled: true, onClick: () => {},
+    });
+  }
+
+  return (
+    <div ref={menuRef} className="relative inline-block" onClick={e => e.stopPropagation()}>
+      <button
+        type="button"
+        aria-label={`节点 ${alias} 生命周期操作`}
+        aria-haspopup="menu"
+        aria-expanded={menuOpen}
+        onClick={() => setMenuOpen(v => !v)}
+        className="inline-flex h-8 w-8 items-center justify-center rounded-md text-gray-400 hover:bg-white/5 hover:text-white focus:outline-none focus:ring-1 focus:ring-cyan-500/50"
+      >
+        <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor" aria-hidden>
+          <circle cx="12" cy="5" r="1.6" />
+          <circle cx="12" cy="12" r="1.6" />
+          <circle cx="12" cy="19" r="1.6" />
+        </svg>
+      </button>
+      {menuOpen && (
+        <div role="menu" className="absolute right-0 z-40 mt-1 w-44 overflow-hidden rounded-md border border-[#26262b] bg-[#161618] shadow-xl">
+          {items.map(item => (
+            <button
+              key={item.key}
+              type="button"
+              role="menuitem"
+              disabled={item.disabled}
+              onClick={item.onClick}
+              className={`block w-full px-3 py-2 text-left text-sm transition-colors ${
+                item.disabled
+                  ? 'text-gray-600 cursor-not-allowed'
+                  : item.danger
+                    ? 'text-red-300 hover:bg-red-900/20'
+                    : 'text-gray-200 hover:bg-white/5'
+              }`}
+            >
+              {item.label}
+            </button>
+          ))}
+        </div>
+      )}
+
+      {/* Last error inline (under the button) — pass-through hub's structured fields */}
+      {lastError && lastError.ok === false && !stopModal && !deleteModal && (
+        <div className="absolute right-0 z-40 mt-1 w-72 rounded-md border border-red-700/40 bg-red-900/20 px-3 py-2 text-xs text-red-200">
+          <div className="flex items-start justify-between gap-2">
+            <div className="min-w-0 flex-1">
+              <div className="font-semibold">{lastError.error || 'error'}</div>
+              {lastError.message ? <div className="mt-0.5 text-red-300/80">{lastError.message}</div> : null}
+              {typeof lastError.in_flight_count === 'number' && (
+                <div className="mt-0.5 text-red-300/80">in-flight: {lastError.in_flight_count}</div>
+              )}
+              {lastError.hint ? <div className="mt-1 text-red-300/60">{lastError.hint}</div> : null}
+            </div>
+            <button type="button" onClick={() => setLastError(null)} className="shrink-0 text-red-400 hover:text-red-200" aria-label="关闭">×</button>
+          </div>
+        </div>
+      )}
+
+      {stopModal && (
+        <StopNodeModal
+          alias={alias}
+          nodeId={nodeId}
+          networkId={networkId}
+          onClose={() => setStopModal(false)}
+          onCompleted={() => { setStopModal(false); onCompleted?.(); }}
+        />
+      )}
+      {deleteModal && (
+        <DeleteNodeModal
+          alias={alias}
+          nodeId={nodeId}
+          networkId={networkId}
+          onClose={() => setDeleteModal(false)}
+          onCompleted={() => { setDeleteModal(false); onCompleted?.(); }}
+        />
+      )}
+    </div>
+  );
+}
+
+// ──────────────────────────────────────────────────────────────────────
+
+interface ModalProps {
+  alias: string;
+  nodeId: string;
+  networkId?: string | null;
+  onClose: () => void;
+  onCompleted: () => void;
+}
+
+function StopNodeModal({ alias, nodeId, networkId, onClose, onCompleted }: ModalProps) {
+  const [busy, setBusy] = useState(false);
+  const [force, setForce] = useState(false);
+  const [reply, setReply] = useState<ApiReply | null>(null);
+
+  useEffect(() => {
+    const onKey = (e: KeyboardEvent) => { if (e.key === 'Escape' && !busy) onClose(); };
+    window.addEventListener('keydown', onKey);
+    return () => window.removeEventListener('keydown', onKey);
+  }, [onClose, busy]);
+
+  const inFlight = reply && typeof reply.in_flight_count === 'number' ? reply.in_flight_count : 0;
+
+  const onConfirm = async () => {
+    setBusy(true);
+    setReply(null);
+    const r = await callLifecycle('stop', {
+      node_id: nodeId,
+      ...(networkId ? { network_id: networkId } : {}),
+      ...(force ? { force: true } : {}),
+    });
+    setBusy(false);
+    if (r.ok) { onCompleted(); return; }
+    setReply(r);
+  };
+
+  return (
+    <>
+      <div className="fixed inset-0 z-40 bg-black/50" onClick={busy ? undefined : onClose} aria-hidden />
+      <div role="dialog" aria-label={`停止节点 ${alias}`} className="fixed left-1/2 top-1/2 z-50 w-[min(92vw,420px)] -translate-x-1/2 -translate-y-1/2 rounded-xl border border-[#26262b] bg-[#161618] shadow-2xl">
+        <div className="flex items-center justify-between border-b border-[#26262b] px-4 py-3">
+          <div className="text-sm font-semibold text-white">停止节点</div>
+          <button onClick={busy ? undefined : onClose} aria-label="关闭" className="text-gray-500 hover:text-white">×</button>
+        </div>
+        <div className="space-y-3 px-4 py-4">
+          <div className="text-sm text-gray-300">
+            将停止 <span className="font-mono text-cyan-300">{alias}</span> 子进程（SIGTERM，~10s 内）。配置目录保留，可通过「启动」恢复。
+          </div>
+          {/* Surface hub's structured payload field-by-field; never collapse to generic */}
+          {reply && reply.ok === false && (
+            <div className="rounded-md border border-red-700/40 bg-red-900/20 px-3 py-2 text-xs text-red-200">
+              <div className="font-semibold">{reply.error}</div>
+              {reply.message ? <div className="mt-0.5 text-red-300/80">{reply.message}</div> : null}
+              {typeof reply.in_flight_count === 'number' && (
+                <div className="mt-0.5 text-red-300/80">
+                  当前 in-flight 任务: {reply.in_flight_count}
+                </div>
+              )}
+              {reply.hint ? <div className="mt-1 text-red-300/60">{reply.hint}</div> : null}
+            </div>
+          )}
+          {(inFlight > 0 || force) && (
+            <label className="flex items-start gap-2 rounded-md border border-amber-700/40 bg-amber-900/10 px-3 py-2 text-xs text-amber-200">
+              <input
+                type="checkbox"
+                checked={force}
+                onChange={e => setForce(e.target.checked)}
+                className="mt-0.5"
+              />
+              <span>
+                <span className="font-semibold text-amber-300">强制停止</span>{inFlight > 0 ? `（会丢弃 ${inFlight} 条待处理任务）` : '（覆盖 in-flight 拒绝；hub 会写 audit 行）'}
+              </span>
+            </label>
+          )}
+        </div>
+        <div className="flex items-center justify-end gap-2 border-t border-[#26262b] px-4 py-3">
+          <button type="button" disabled={busy} onClick={onClose} className="rounded-md px-3 py-1.5 text-sm text-gray-400 hover:text-gray-200 disabled:opacity-50">取消</button>
+          <button
+            type="button"
+            disabled={busy || (inFlight > 0 && !force)}
+            onClick={onConfirm}
+            className="rounded-md bg-cyan-600 px-4 py-1.5 text-sm font-medium text-white hover:bg-cyan-500 disabled:cursor-not-allowed disabled:opacity-50"
+          >
+            {busy ? '停止中…' : '确认停止'}
+          </button>
+        </div>
+      </div>
+    </>
+  );
+}
+
+function DeleteNodeModal({ alias, nodeId, networkId, onClose, onCompleted }: ModalProps) {
+  const [busy, setBusy] = useState(false);
+  const [confirmInput, setConfirmInput] = useState('');
+  const [force, setForce] = useState(false);
+  const [keepConfig, setKeepConfig] = useState(false);
+  const [reply, setReply] = useState<ApiReply | null>(null);
+
+  useEffect(() => {
+    const onKey = (e: KeyboardEvent) => { if (e.key === 'Escape' && !busy) onClose(); };
+    window.addEventListener('keydown', onKey);
+    return () => window.removeEventListener('keydown', onKey);
+  }, [onClose, busy]);
+
+  const inFlight = reply && typeof reply.in_flight_count === 'number' ? reply.in_flight_count : 0;
+  const confirmValid = confirmInput === alias;
+
+  const onConfirm = async () => {
+    if (!confirmValid) return;
+    setBusy(true);
+    setReply(null);
+    const r = await callLifecycle('delete', {
+      node_id: nodeId,
+      confirm_alias: confirmInput,
+      ...(networkId ? { network_id: networkId } : {}),
+      ...(force ? { force: true } : {}),
+      ...(keepConfig ? { delete_config: false } : {}),
+    });
+    setBusy(false);
+    if (r.ok) { onCompleted(); return; }
+    setReply(r);
+  };
+
+  return (
+    <>
+      <div className="fixed inset-0 z-40 bg-black/50" onClick={busy ? undefined : onClose} aria-hidden />
+      <div role="dialog" aria-label={`删除节点 ${alias}`} className="fixed left-1/2 top-1/2 z-50 w-[min(94vw,480px)] -translate-x-1/2 -translate-y-1/2 rounded-xl border border-red-700/40 bg-[#161618] shadow-2xl">
+        <div className="flex items-center justify-between border-b border-[#26262b] px-4 py-3">
+          <div className="text-sm font-semibold text-red-300">删除节点</div>
+          <button onClick={busy ? undefined : onClose} aria-label="关闭" className="text-gray-500 hover:text-white">×</button>
+        </div>
+        <div className="space-y-3 px-4 py-4 text-sm text-gray-300">
+          <div>这将：</div>
+          <ul className="list-inside list-disc space-y-1 pl-2 text-xs text-gray-400">
+            <li>停止 <span className="font-mono text-cyan-300">{alias}</span> 子进程（SIGTERM ~10s）</li>
+            <li>从 hub 注销该节点</li>
+            <li>撤销该节点的 ntok</li>
+            {!keepConfig && <li>配置文件备份到 <code className="text-amber-300">~/.anet/deleted/&lt;ts&gt;-{alias}/</code>（30 天后自动清除）</li>}
+            {keepConfig && <li className="text-amber-300">配置文件保留原地（不备份不清理 — 你勾选了「保留配置」）</li>}
+          </ul>
+
+          {/* Surface hub's structured payload field-by-field */}
+          {reply && reply.ok === false && (
+            <div className="rounded-md border border-red-700/40 bg-red-900/20 px-3 py-2 text-xs text-red-200">
+              <div className="font-semibold">{reply.error}</div>
+              {reply.message ? <div className="mt-0.5 text-red-300/80">{reply.message}</div> : null}
+              {typeof reply.in_flight_count === 'number' && (
+                <div className="mt-0.5 text-red-300/80">当前 in-flight 任务: {reply.in_flight_count}</div>
+              )}
+              {reply.hint ? <div className="mt-1 text-red-300/60">{reply.hint}</div> : null}
+            </div>
+          )}
+
+          {(inFlight > 0 || force) && (
+            <label className="flex items-start gap-2 rounded-md border border-amber-700/40 bg-amber-900/10 px-3 py-2 text-xs text-amber-200">
+              <input
+                type="checkbox"
+                checked={force}
+                onChange={e => setForce(e.target.checked)}
+                className="mt-0.5"
+              />
+              <span>
+                <span className="font-semibold text-amber-300">强制删除</span>{inFlight > 0 ? `（会丢弃 ${inFlight} 条待处理任务）` : '（覆盖 in-flight 拒绝）'}
+              </span>
+            </label>
+          )}
+
+          <label className="flex items-center gap-2 text-xs text-gray-400">
+            <input type="checkbox" checked={keepConfig} onChange={e => setKeepConfig(e.target.checked)} />
+            保留配置目录（不备份；高级用法）
+          </label>
+
+          <label className="block space-y-1">
+            <span className="text-xs text-gray-400">输入节点名字 <span className="font-mono text-cyan-300">{alias}</span> 确认</span>
+            <input
+              autoFocus
+              value={confirmInput}
+              onChange={e => setConfirmInput(e.target.value)}
+              placeholder={alias}
+              className="w-full rounded-md border border-[#26262b] bg-[#0e0e10] px-3 py-2 text-sm text-gray-200 focus:border-red-500 focus:outline-none"
+              autoCapitalize="none"
+              autoCorrect="off"
+              spellCheck={false}
+            />
+            {confirmInput && !confirmValid && (
+              <span className="text-[11px] text-red-400">名字不匹配（区分大小写）</span>
+            )}
+          </label>
+        </div>
+        <div className="flex items-center justify-end gap-2 border-t border-[#26262b] px-4 py-3">
+          <button type="button" disabled={busy} onClick={onClose} className="rounded-md px-3 py-1.5 text-sm text-gray-400 hover:text-gray-200 disabled:opacity-50">取消</button>
+          <button
+            type="button"
+            disabled={busy || !confirmValid || (inFlight > 0 && !force)}
+            onClick={onConfirm}
+            className="rounded-md bg-red-600 px-4 py-1.5 text-sm font-medium text-white hover:bg-red-500 disabled:cursor-not-allowed disabled:opacity-50"
+          >
+            {busy ? '删除中…' : `删除 ${alias}`}
+          </button>
+        </div>
+      </div>
+    </>
+  );
+}

package/app/components/types.ts

@@ -19,6 +19,10 @@ export interface Session {
   // commhub-server 0.8.1-preview.0; null on older nodes / older hubs.
   model?: string | null;
   runtime?: string | null;
+  // RFC-027 PR2 — lifecycle_state. Sourced from /api/nodes (preview.12+);
+  // merged into Session client-side via useNodeLifecycle hook. Absent →
+  // treated as 'active' so older sessions/hubs don't break the menu.
+  lifecycle_state?: string | null;
 }
 
 export interface Health {

package/app/lib/hooks.ts

@@ -30,6 +30,28 @@ export function useSessions() {
   return { sessions: data?.sessions || [], hint: data?._hint, error, isLoading };
 }
 
+// RFC-027 PR2 — alias → lifecycle_state map sourced from /api/nodes
+// (commhub-server preview.12+). /api/status reads from `sessions` which
+// doesn't carry lifecycle_state; /api/nodes does. Cheap secondary
+// fetch, same SWR cadence as useSessions; merged client-side by alias.
+// Absent alias → caller defaults to 'active'.
+interface NodesResp { nodes?: Array<{ alias?: string; node_id?: string; lifecycle_state?: string | null }>; }
+export function useNodeLifecycle() {
+  const { networkId } = useNetworkId();
+  const { data, error } = useSWR<NodesResp>(
+    withNetwork('/api/hub/nodes', networkId),
+    fetcher,
+    SWR_OPTIONS,
+  );
+  const lifecycleByAlias: Record<string, string> = {};
+  const nodeIdByAlias: Record<string, string> = {};
+  for (const n of data?.nodes ?? []) {
+    if (n.alias && typeof n.lifecycle_state === 'string') lifecycleByAlias[n.alias] = n.lifecycle_state;
+    if (n.alias && typeof n.node_id === 'string') nodeIdByAlias[n.alias] = n.node_id;
+  }
+  return { lifecycleByAlias, nodeIdByAlias, error };
+}
+
 export function useHealth() {
   const { data, error } = useSWR<Health>('/api/hub/health', fetcher, SWR_OPTIONS);
   return { health: data || null, error };

package/app/nodes/page.tsx

@@ -2,9 +2,11 @@
 
 import { useState } from 'react';
 import { timeAgo } from '../components/utils';
-import { useSessions, useHealth } from '../lib/hooks';
+import { useSessions, useHealth, useNodeLifecycle } from '../lib/hooks';
+import { useSWRConfig } from 'swr';
 import { TaskChatPanel } from '../components/TaskChatPanel';
 import { CreateNodeWizard } from '../components/CreateNodeWizard';
+import { NodeLifecycleMenu } from '../components/NodeLifecycleMenu';
 import { EmptyState, NodesEmptyState } from '../components/EmptyState';
 import { AliasAvatar } from '../components/AliasAvatar';
 import { useCollapsibleSearch } from '../components/CollapsibleSearch';
@@ -26,7 +28,16 @@ type SessionRow = Session & { online: boolean };
 export default function NodesPage() {
   const { sessions, isLoading: loading } = useSessions();
   const { health } = useHealth();
+  const { lifecycleByAlias, nodeIdByAlias } = useNodeLifecycle();
   const { hasUnread } = useChatUnread();
+  const { mutate } = useSWRConfig();
+  // RFC-027 PR2 — after a stop/delete/restart dispatch lands, refresh
+  // /api/hub/nodes (lifecycle_state) AND /api/hub/status (sessions).
+  // Both feed the menu's state-aware items; otherwise menu stays
+  // stale until next 5s SWR poll.
+  const refreshNodes = () => {
+    mutate((k: unknown) => typeof k === 'string' && (k.startsWith('/api/hub/nodes') || k.startsWith('/api/hub/status')));
+  };
   const sseMap = health?.sse_sessions || {};
   // SSE keys are `network_id:alias` since server v0.7+. Look up with the
   // composite key first, fall back to alias-only for legacy hubs.
@@ -215,6 +226,16 @@ export default function NodesPage() {
                     </div>
                   </div>
                   <span className="hidden shrink-0 rounded-lg border border-cyan-500/15 bg-cyan-500/5 px-2 py-1 text-[10px] text-cyan-300/70 sm:inline">Tap to chat</span>
+                  {/* RFC-027 PR2 — per-node ⋮ lifecycle menu. The button stopsPropagation
+                      internally so it doesn't open chat. lifecycleByAlias absent → 'active'
+                      default, menu renders normal stop/delete options. */}
+                  <NodeLifecycleMenu
+                    nodeId={nodeIdByAlias[s.alias] || s.node_id || s.alias}
+                    alias={s.alias}
+                    lifecycleState={lifecycleByAlias[s.alias]}
+                    networkId={s.network_id || null}
+                    onCompleted={refreshNodes}
+                  />
                 </div>
 
                 <div className="mt-3 rounded-lg border border-[#1c1c1f] bg-[#0e0e10] px-3 py-2 text-xs">
@@ -282,7 +303,18 @@ export default function NodesPage() {
                     <span className="truncate">{s.agent || '--'}<span className="text-gray-700 mx-1.5">·</span>{shortServer(s.server)}</span>
                   </div>
                   <div className="col-span-4 truncate text-xs text-gray-500" title={s.task || ''}>{s.task || '--'}</div>
-                  <div className="col-span-1 text-xs text-gray-500">{timeAgo(s.last_seen_at || s.updated_at)}</div>
+                  <div className="col-span-1 flex items-center justify-between gap-2 text-xs text-gray-500">
+                    <span className="truncate">{timeAgo(s.last_seen_at || s.updated_at)}</span>
+                    {/* RFC-027 PR2 ⋮ lifecycle menu — desktop list. Defaults
+                        to 'active' when lifecycleByAlias absent. */}
+                    <NodeLifecycleMenu
+                      nodeId={nodeIdByAlias[s.alias] || s.node_id || s.alias}
+                      alias={s.alias}
+                      lifecycleState={lifecycleByAlias[s.alias]}
+                      networkId={s.network_id || null}
+                      onCompleted={refreshNodes}
+                    />
+                  </div>
                 </div>
                 {/* R7 of #190: mobile node row was ~340px tall × ~150
                     rows = the 51k page. Wins this round, in priority
@@ -307,6 +339,14 @@ export default function NodesPage() {
                     <span className={`shrink-0 text-xs px-2 py-0.5 rounded-md border ${STATUS_COLORS[statusKey] || STATUS_COLORS.offline}`}>
                       {statusKey}
                     </span>
+                    {/* RFC-027 PR2 ⋮ lifecycle menu — mobile list. */}
+                    <NodeLifecycleMenu
+                      nodeId={nodeIdByAlias[s.alias] || s.node_id || s.alias}
+                      alias={s.alias}
+                      lifecycleState={lifecycleByAlias[s.alias]}
+                      networkId={s.network_id || null}
+                      onCompleted={refreshNodes}
+                    />
                   </div>
                   {s.task && <div className="truncate text-xs text-gray-500">{s.task}</div>}
                 </div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sleep2agi/agent-network-dashboard",
-  "version": "0.6.3-preview.3",
+  "version": "0.6.3-preview.4",
   "description": "Agent Network Dashboard — Web UI for managing AI Agent networks",
   "main": "apps/desktop/electron/main.cjs",
   "scripts": {

package/.next/server/chunks/ssr/dashboard-pr4-338_app_0l07md.._.js

@@ -1,3 +0,0 @@
-module.exports=[42221,a=>{"use strict";var b=a.i(12453);a.s(["previewContent",0,function(a){return a&&a.replace(/!\[([^\]]*)\]\([^)]*\)/g,"$1").replace(/\[([^\]]+)\]\([^)]*\)/g,"$1").replace(/`([^`]+)`/g,"$1").replace(/\s+/g," ").trim()||"--"},"timeAgo",0,function(a){return(0,b.relativeAgo)(a)??"--"}])},70049,a=>{"use strict";var b=a.i(51653);let c=[180,200,220,270,300,330,30,90];function d(a){let b=0;for(let c=0;c<a.length;c++)b=31*b+a.charCodeAt(c)>>>0;let d=c[b%c.length];return{bg:`hsl(${d} 55% 22%)`,ring:`hsl(${d} 60% 45%)`,text:`hsl(${d} 80% 78%)`}}function e(a){return a?(a.trim().match(/[\p{L}\p{N}]/u)?.[0]||a.trim()[0]||"·").toUpperCase():"·"}a.s(["AliasAvatar",0,function({alias:a,size:c=28,className:f=""}){if(/\bgrok\b|grok-build|grok测试员|grok-demo/i.test(a))return(0,b.jsx)("span",{className:`anet-alias-avatar inline-flex items-center justify-center rounded-full border border-emerald-500/45 bg-emerald-950/70 shrink-0 ${f}`,style:{width:c,height:c,backgroundImage:"url(/vendors/grok.svg)",backgroundPosition:"center",backgroundRepeat:"no-repeat",backgroundSize:"68% 68%"},title:a,"aria-hidden":!0});let g=d(a),h=Math.max(9,Math.round(.42*c));return(0,b.jsx)("span",{className:`anet-alias-avatar inline-flex items-center justify-center rounded-full border shrink-0 font-semibold ${f}`,style:{width:c,height:c,fontSize:h,backgroundColor:g.bg,borderColor:g.ring,color:g.text},title:a,"aria-hidden":!0,children:e(a)})},"aliasAvatarColors",0,d,"aliasInitial",0,e])},28644,a=>{"use strict";var b=a.i(67784),c=a.i(436);let d=async a=>{let b=await fetch(a);if(401===b.status)throw window.location.assign("/login"),Error("unauthorized");return b.json()},e={refreshInterval:5e3,dedupingInterval:3e3};function f(a,b){if(!b)return a;let c=a.includes("?")?"&":"?";return`${a}${c}network_id=${encodeURIComponent(b)}`}a.s(["useAnetConfig",0,function(){let{data:a}=(0,b.default)("/api/anet/config",d,{refreshInterval:3e4});return{config:a||null}},"useHealth",0,function(){let{data:a,error:c}=(0,b.default)("/api/hub/health",d,e);return{health:a||null,error:c}},"useMessages",0,function(a=100){let{networkId:g}=(0,c.useNetworkId)(),{data:h,error:i,isLoading:j}=(0,b.default)(f(`/api/hub/messages?limit=${a}`,g),d,{...e,keepPreviousData:!0});return{messages:h?.messages||[],error:i,isLoading:j}},"useSessions",0,function(){let{networkId:a}=(0,c.useNetworkId)(),{data:g,error:h,isLoading:i}=(0,b.default)(f("/api/hub/status",a),d,e);return{sessions:g?.sessions||[],hint:g?._hint,error:h,isLoading:i}},"useStats",0,function(){let{networkId:a}=(0,c.useNetworkId)(),{data:g,error:h}=(0,b.default)(f("/api/hub/stats",a),d,e);return{stats:g?.ok?g:null,error:h}},"useTasks",0,function(a){let{networkId:g}=(0,c.useNetworkId)(),h=new URLSearchParams({limit:"100",...a}).toString(),{data:i,error:j,isLoading:k}=(0,b.default)(f(`/api/hub/tasks?${h}`,g),d,e);return{tasks:i?.tasks||[],count:i?.count??0,source:i?.source,error:j,isLoading:k}}])},30396,a=>{"use strict";a.s(["SESSION_STATUS_CHIP_CLASS",0,{working:"bg-green-500/10 text-green-300 border-green-500/20",idle:"bg-gray-500/10 text-gray-300 border-gray-500/20",blocked:"bg-yellow-500/10 text-yellow-300 border-yellow-500/20",error:"bg-red-500/10 text-red-300 border-red-500/20",offline:"bg-gray-500/10 text-gray-500 border-gray-500/20"},"SESSION_STATUS_TEXT_CLASS",0,{working:"text-green-400",idle:"text-gray-400",blocked:"text-yellow-400",error:"text-red-400",offline:"text-gray-500"},"STATUS_BAR_CLASS",0,{created:"bg-gray-500",delivered:"bg-gray-400",acked:"bg-gray-300",running:"bg-green-500",replied:"bg-gray-400",closed:"bg-gray-600",failed:"bg-red-500",cancelled:"bg-gray-600",expired:"bg-gray-600"},"STATUS_CHIP_CLASS",0,{created:"bg-gray-500/10 text-gray-400 border-gray-500/20",delivered:"bg-gray-500/10 text-gray-300 border-gray-500/20",acked:"bg-gray-500/10 text-gray-300 border-gray-500/20",running:"bg-green-500/10 text-green-300 border-green-500/20",replied:"bg-gray-500/10 text-gray-300 border-gray-500/20",closed:"bg-gray-500/10 text-gray-500 border-gray-500/20",failed:"bg-red-500/10 text-red-300 border-red-500/20",cancelled:"bg-gray-500/10 text-gray-500 border-gray-500/20",expired:"bg-gray-500/10 text-gray-500 border-gray-500/20"},"STATUS_DOT_HEX",0,{created:"#9ca3af",delivered:"#9ca3af",acked:"#9ca3af",running:"#4ade80",replied:"#9ca3af",closed:"#6b7280",failed:"#f87171",cancelled:"#6b7280",expired:"#6b7280"},"TASK_STATUSES",0,["created","delivered","acked","running","replied","closed","failed","cancelled","expired"]])},16727,a=>{"use strict";var b=a.i(51653),c=a.i(85895),d=a.i(73391),e=a.i(28644),f=a.i(42221),g=a.i(70049),h=a.i(30396);a.s(["default",0,function(){let a,{sessions:i}=(0,e.useSessions)(),{health:j}=(0,e.useHealth)(),{stats:k}=(0,e.useStats)(),l=j?.sse_sessions||{},m=a=>(a.network_id?l[`${a.network_id}:${a.alias}`]:void 0)??l[a.alias],[n,o]=(0,c.useState)(""),[p,q]=(0,c.useState)(""),[r,s]=(0,c.useState)(""),[t,u]=(0,c.useState)(""),[v,w]=(0,c.useState)(""),[x,y]=(0,c.useState)(""),[z,A]=(0,c.useState)(""),[B,C]=(0,c.useState)(""),D=async()=>{if(n.trim()&&p.trim()){try{let a=await fetch("/api/hub/auth",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:"register",username:n,password:p})}),b=await a.json();s(b.ok?`Created: ${b.user.username} (${b.user.user_id})`:`Failed: ${b.error}`),b.ok&&(o(""),q(""))}catch{s("Failed")}setTimeout(()=>s(""),8e3)}},E=async()=>{if(t.trim()){try{let a=await fetch("/api/hub/broadcast",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({message:t})}),b=await a.json();w(b.ok?`Sent to ${b.recipients} nodes`:`Failed: ${b.error}`),b.ok&&u("")}catch{w("Failed")}setTimeout(()=>w(""),5e3)}},F=async()=>{if(x&&z.trim()){try{let a=await fetch("/api/hub/send",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({alias:x,task:z})}),b=await a.json();C(b.ok?"Task sent":`Failed: ${b.error}`),b.ok&&A("")}catch{C("Failed")}setTimeout(()=>C(""),5e3)}},G=i.filter(a=>m(a)),H=i.filter(a=>!m(a));return(0,b.jsxs)("div",{className:"min-h-screen bg-[#0b0b0d] text-gray-100 p-4 sm:p-6",children:[(0,b.jsx)("h1",{className:"text-2xl font-bold text-white mb-3 lg:ml-0 ml-10",children:"Admin"}),(0,b.jsx)("nav",{className:"mb-4 sm:mb-8 flex flex-wrap gap-2 text-xs",children:[{href:"#status",label:"Status"},{href:"#actions",label:"Actions"},{href:"#users",label:"Users"}].map(a=>(0,b.jsx)("a",{href:a.href,className:"inline-flex min-h-[44px] items-center rounded-md border border-[#26262b] bg-[#0e0e10]/60 px-3 py-2 text-gray-400 hover:border-cyan-500/50 hover:text-cyan-300 hover:bg-cyan-500/10 transition-colors",children:a.label},a.href))}),(0,b.jsxs)("div",{className:"max-w-6xl space-y-10",children:[(0,b.jsxs)("div",{id:"status",className:"space-y-4 scroll-mt-6",children:[(0,b.jsxs)("div",{className:"flex items-center gap-2 px-1",children:[(0,b.jsx)("div",{className:"text-[11px] uppercase tracking-[0.14em] text-gray-400 font-semibold",children:"Status"}),(0,b.jsx)("div",{className:"flex-1 h-px bg-[#26262b]"})]}),(0,b.jsxs)("div",{className:"grid grid-cols-1 lg:grid-cols-2 gap-4",children:[(0,b.jsxs)("section",{className:"bg-[#161618] border border-[#26262b] rounded-xl p-4 sm:p-5",children:[(0,b.jsx)("h2",{className:"text-sm font-semibold text-gray-300 mb-3 sm:mb-4",children:"Server Overview"}),(0,b.jsxs)("div",{className:"grid grid-cols-2 gap-4 text-sm",children:[(0,b.jsxs)("div",{children:[(0,b.jsx)("div",{className:"text-2xl sm:text-3xl font-bold text-green-400 tabular-nums",children:G.length}),(0,b.jsx)("div",{className:"text-xs text-gray-500",children:"Online"})]}),(0,b.jsxs)("div",{children:[(0,b.jsx)("div",{className:"text-2xl sm:text-3xl font-bold text-gray-500 tabular-nums",children:H.length}),(0,b.jsx)("div",{className:"text-xs text-gray-500",children:"Offline"})]}),(0,b.jsxs)("div",{children:[(0,b.jsx)("div",{className:"text-2xl sm:text-3xl font-bold text-cyan-400 tabular-nums",children:j?.sse_connections??"--"}),(0,b.jsxs)("div",{className:"text-xs text-gray-500",children:["SSE Streams ",(0,b.jsx)("span",{className:"text-gray-600",children:"· server"})]})]}),(0,b.jsxs)("div",{children:[(0,b.jsx)("div",{className:"text-2xl sm:text-3xl font-bold text-white tabular-nums",children:k?.tasks?.total??"--"}),(0,b.jsx)("div",{className:"text-xs text-gray-500",children:"Total Tasks"})]})]}),k?.tasks?.by_status&&k.tasks.by_status.length>0&&(a=Object.fromEntries(k.tasks.by_status.map(a=>[a.status,a.count])),(0,b.jsxs)("div",{className:"mt-4 flex items-center justify-between border-t border-[#26262b] pt-3 text-xs",children:[(0,b.jsxs)("div",{className:"text-gray-400 tabular-nums",children:[(0,b.jsxs)("span",{className:a.running?"text-green-400":"text-gray-500",children:[a.running||0," running"]}),(0,b.jsx)("span",{className:"text-gray-600",children:" · "}),(0,b.jsxs)("span",{className:a.failed?"text-red-400":"text-gray-500",children:[a.failed||0," failed"]})]}),(0,b.jsx)(d.default,{href:"/tasks",prefetch:!1,className:"text-cyan-400 hover:text-cyan-300",children:"View all →"})]}))]}),(0,b.jsxs)("section",{className:"bg-[#161618] border border-[#26262b] rounded-xl p-5",children:[(0,b.jsxs)("h2",{className:"text-sm font-semibold text-gray-300 mb-4",children:["Online Sessions ",(0,b.jsxs)("span",{className:"text-gray-600",children:["(",G.length,")"]})]}),(0,b.jsx)("div",{className:"space-y-2 max-h-80 overflow-y-auto",children:0===G.length?(0,b.jsx)("div",{className:"text-xs text-gray-600 text-center py-4",children:"No online sessions"}):G.map(a=>(0,b.jsxs)("div",{className:"flex items-center gap-3 bg-[#0e0e10] rounded-lg px-3 py-2 border border-[#1c1c1f]",children:[(0,b.jsx)(g.AliasAvatar,{alias:a.alias,size:20}),(0,b.jsxs)("div",{className:"min-w-0 flex-1",children:[(0,b.jsx)("div",{className:"text-sm text-white font-medium truncate",children:a.alias}),(0,b.jsxs)("div",{className:"text-xs text-gray-500 truncate",children:[a.agent||"--"," · ",a.task||"idle"]})]}),(0,b.jsxs)("div",{className:"flex items-center gap-2 shrink-0",children:[(0,b.jsx)("span",{className:`text-xs px-2 py-0.5 rounded border ${h.SESSION_STATUS_CHIP_CLASS[a.status]||h.SESSION_STATUS_CHIP_CLASS.idle}`,children:a.status}),(0,b.jsx)("span",{className:"text-[10px] text-gray-600",children:(0,f.timeAgo)(a.updated_at)})]})]},a.alias))})]})]})]}),(0,b.jsxs)("div",{id:"actions",className:"space-y-4 scroll-mt-6",children:[(0,b.jsxs)("div",{className:"flex items-center gap-2 px-1",children:[(0,b.jsx)("div",{className:"text-[11px] uppercase tracking-[0.14em] text-gray-400 font-semibold",children:"Actions"}),(0,b.jsx)("div",{className:"flex-1 h-px bg-[#26262b]"})]}),0===i.length?(0,b.jsx)("div",{className:"bg-[#161618] border border-[#26262b] rounded-xl px-5 py-4 text-sm text-gray-500",children:"Broadcast and Send Task become available after the first agent registers."}):(0,b.jsxs)("div",{className:"grid grid-cols-1 lg:grid-cols-2 gap-4",children:[(0,b.jsxs)("section",{className:"bg-[#161618] border border-[#26262b] rounded-xl p-5",children:[(0,b.jsx)("h2",{className:"text-sm font-semibold text-gray-300 mb-4",children:"Broadcast"}),(0,b.jsx)("textarea",{value:t,onChange:a=>u(a.target.value),placeholder:"Message to all online nodes...",rows:3,className:"w-full bg-[#0e0e10] border border-[#26262b] rounded-lg px-3 py-2 text-sm text-white placeholder-gray-600 focus:border-cyan-500/50 focus:outline-none resize-none"}),(0,b.jsxs)("div",{className:"flex justify-between items-center mt-3",children:[(0,b.jsxs)("span",{className:"text-xs text-gray-600",children:[t.length,"/500"]}),(0,b.jsx)("button",{onClick:E,disabled:!t.trim(),className:"px-4 py-2 bg-purple-600 hover:bg-purple-500 disabled:bg-gray-800 disabled:text-gray-600 text-white text-sm rounded-lg transition-colors",children:"Broadcast"})]}),v&&(0,b.jsx)("div",{className:`mt-2 text-xs ${v.startsWith("Failed")?"text-red-400":"text-green-400"}`,children:v})]}),(0,b.jsxs)("section",{className:"bg-[#161618] border border-[#26262b] rounded-xl p-5",children:[(0,b.jsx)("h2",{className:"text-sm font-semibold text-gray-300 mb-4",children:"Send Task"}),(0,b.jsxs)("select",{value:x,onChange:a=>y(a.target.value),className:"w-full bg-[#0e0e10] border border-[#26262b] rounded-lg px-3 py-2 text-base sm:text-sm text-white focus:border-cyan-500/50 focus:outline-none mb-3",children:[(0,b.jsx)("option",{value:"",children:"Select target node..."}),G.map(a=>(0,b.jsxs)("option",{value:a.alias,children:[a.alias," (",a.status,")"]},a.alias)),(0,b.jsx)("optgroup",{label:"Offline",children:H.map(a=>(0,b.jsxs)("option",{value:a.alias,children:[a.alias," (offline)"]},a.alias))})]}),(0,b.jsx)("textarea",{value:z,onChange:a=>A(a.target.value),placeholder:"Task content...",rows:3,className:"w-full bg-[#0e0e10] border border-[#26262b] rounded-lg px-3 py-2 text-sm text-white placeholder-gray-600 focus:border-cyan-500/50 focus:outline-none resize-none"}),(0,b.jsx)("div",{className:"flex justify-end mt-3",children:(0,b.jsx)("button",{onClick:F,disabled:!x||!z.trim(),className:"px-4 py-2 bg-cyan-600 hover:bg-cyan-500 disabled:bg-gray-800 disabled:text-gray-600 text-white text-sm rounded-lg transition-colors",children:"Send Task"})}),B&&(0,b.jsx)("div",{className:`mt-2 text-xs ${B.startsWith("Failed")?"text-red-400":"text-green-400"}`,children:B})]})]})]}),(0,b.jsxs)("div",{id:"users",className:"space-y-4 scroll-mt-6",children:[(0,b.jsxs)("div",{className:"flex items-center gap-2 px-1",children:[(0,b.jsx)("div",{className:"text-[11px] uppercase tracking-[0.14em] text-gray-400 font-semibold",children:"Users"}),(0,b.jsx)("div",{className:"flex-1 h-px bg-[#26262b]"})]}),(0,b.jsx)("div",{className:"grid grid-cols-1 lg:grid-cols-2 gap-4",children:(0,b.jsxs)("section",{className:"bg-[#161618] border border-[#26262b] rounded-xl p-5",children:[(0,b.jsx)("h2",{className:"text-sm font-semibold text-gray-300 mb-4",children:"Register User (V3)"}),(0,b.jsxs)("div",{className:"space-y-3",children:[(0,b.jsx)("input",{type:"text",value:n,onChange:a=>o(a.target.value),placeholder:"Username",className:"w-full bg-[#0e0e10] border border-[#26262b] rounded-lg px-3 py-2 text-sm text-white placeholder-gray-600 focus:border-cyan-500/50 focus:outline-none"}),(0,b.jsx)("input",{type:"password",value:p,onChange:a=>q(a.target.value),placeholder:"Password",className:"w-full bg-[#0e0e10] border border-[#26262b] rounded-lg px-3 py-2 text-sm text-white placeholder-gray-600 focus:border-cyan-500/50 focus:outline-none"}),(0,b.jsx)("button",{onClick:D,disabled:!n.trim()||!p.trim(),className:"w-full px-4 py-2 bg-green-600 hover:bg-green-500 disabled:bg-gray-800 disabled:text-gray-600 text-white text-sm rounded-lg transition-colors",children:"Register"})]}),r&&(0,b.jsx)("div",{className:`mt-2 text-xs ${r.startsWith("Failed")?"text-red-400":"text-green-400"}`,children:r})]})})]})]})]})}])}];
-
-//# sourceMappingURL=dashboard-pr4-338_app_0l07md.._.js.map