@sleep2agi/agent-network-dashboard 0.4.6-preview.2 → 0.4.6-preview.21

package/app/components/types.ts

@@ -12,6 +12,13 @@ export interface Session {
   last_seen_at?: string;
   config_path?: string;
   network_id?: string;
+  // #111: working directory — nodes sharing a project_dir are one group
+  // (a more precise "same project" signal than the alias prefix).
+  project_dir?: string | null;
+  // #96: model vendor + execution runtime. Added to /api/status sessions in
+  // commhub-server 0.8.1-preview.0; null on older nodes / older hubs.
+  model?: string | null;
+  runtime?: string | null;
 }
 
 export interface Health {

package/app/lib/vendorIdentity.ts

@@ -0,0 +1,145 @@
+/** Issue #96: node visual identity — model vendor + runtime.
+ *
+ * Single source for two orthogonal node dimensions:
+ *   - vendor : which model house powers the node (avatar body)
+ *   - runtime: which execution shell it runs in (corner badge)
+ *
+ * Both are driven by the server `model` / `runtime` fields added in
+ * commhub-server 0.8.1-preview.0 (#96 Phase 1, commit 08482ef). Old nodes
+ * report `model: null` / `runtime: null` and fall back gracefully — never a
+ * broken image or blank avatar.
+ *
+ * Adding a vendor = one entry in VENDOR_RULES. Dropping a real logo file into
+ * public/vendors/ + setting `logo` lights it up with zero render-code change;
+ * until then a vendor-tinted monogram stands in (not a fake official logo).
+ */
+
+export interface VendorIdentity {
+  id: string;
+  label: string;
+  /** Monogram fallback colours, used when `logo` is null. */
+  mono: { bg: string; ring: string; text: string };
+  /** 1-char monogram shown when there's no logo asset. */
+  initial: string;
+  /** Packaged logo asset path, or null → render the monogram instead. */
+  logo: string | null;
+}
+
+const UNKNOWN_VENDOR: VendorIdentity = {
+  id: 'unknown',
+  label: 'Unknown vendor',
+  mono: { bg: 'hsl(220 10% 26%)', ring: 'hsl(220 10% 46%)', text: 'hsl(220 14% 82%)' },
+  initial: '?',
+  logo: null,
+};
+
+// Ordered prefix rules — first match wins. `test` runs against a lowercased
+// model id. Keep the most specific prefixes first.
+const VENDOR_RULES: Array<{ test: (m: string) => boolean; vendor: VendorIdentity }> = [
+  {
+    test: (m) => m.startsWith('intern'),
+    vendor: {
+      id: 'intern',
+      label: '书生 · 上海 AI 实验室',
+      mono: { bg: 'hsl(28 38% 24%)', ring: 'hsl(32 45% 52%)', text: 'hsl(34 60% 82%)' },
+      initial: '书',
+      // #79 shipped this asset — reuse it as the 书生 vendor logo.
+      logo: '/intern_avatar.png',
+    },
+  },
+  {
+    test: (m) => m.startsWith('minimax'),
+    vendor: {
+      id: 'minimax',
+      label: 'MiniMax',
+      mono: { bg: 'hsl(18 50% 26%)', ring: 'hsl(18 65% 52%)', text: 'hsl(20 80% 82%)' },
+      initial: 'M',
+      logo: null, // → public/vendors/minimax.* when assets land
+    },
+  },
+  {
+    test: (m) => m.startsWith('claude'),
+    vendor: {
+      id: 'anthropic',
+      label: 'Anthropic',
+      mono: { bg: 'hsl(16 32% 26%)', ring: 'hsl(16 48% 54%)', text: 'hsl(18 60% 84%)' },
+      initial: 'A',
+      logo: null,
+    },
+  },
+  {
+    test: (m) => m.startsWith('gpt') || m.startsWith('codex') || m.startsWith('o1') || m.startsWith('o3') || m.startsWith('o4'),
+    vendor: {
+      id: 'openai',
+      label: 'OpenAI',
+      mono: { bg: 'hsl(165 26% 22%)', ring: 'hsl(165 40% 44%)', text: 'hsl(165 45% 80%)' },
+      initial: 'O',
+      logo: null,
+    },
+  },
+];
+
+/** Resolve a model id to its vendor identity. `null` / unmatched → UNKNOWN. */
+export function vendorForModel(model: string | null | undefined): VendorIdentity {
+  if (!model) return UNKNOWN_VENDOR;
+  const m = model.toLowerCase();
+  for (const rule of VENDOR_RULES) {
+    if (rule.test(m)) return rule.vendor;
+  }
+  return UNKNOWN_VENDOR;
+}
+
+export type Runtime = 'claude-code-cli' | 'codex-sdk' | 'claude-agent-sdk' | 'http-api';
+
+export interface RuntimeIdentity {
+  label: string;
+  /** SVG path(s) drawn inside a 0..24 viewBox for the corner badge. */
+  iconPath: string;
+  /** Badge accent colour — kept clear of working/idle/offline status hues. */
+  color: string;
+}
+
+const RUNTIME_MAP: Record<Runtime, RuntimeIdentity> = {
+  // terminal / CLI
+  'claude-code-cli': {
+    label: 'Claude Code CLI',
+    iconPath: 'M4 5h16v14H4z M7 9l3 3-3 3 M13 15h4',
+    color: '#a78bfa',
+  },
+  // code-block / SDK
+  'codex-sdk': {
+    label: 'Codex SDK',
+    iconPath: 'M9 7l-5 5 5 5 M15 7l5 5-5 5',
+    color: '#38bdf8',
+  },
+  // SDK, distinct hue from codex
+  'claude-agent-sdk': {
+    label: 'Claude Agent SDK',
+    iconPath: 'M4 7h16v10H4z M8 11h8 M8 14h5',
+    color: '#34d399',
+  },
+  // cloud / API — non-resident process
+  'http-api': {
+    label: 'HTTP API',
+    iconPath: 'M7 18a4 4 0 010-8 5 5 0 019.6-1.3A3.5 3.5 0 0118 18z',
+    color: '#fbbf24',
+  },
+};
+
+/** Resolve a server runtime string to badge identity. Unknown → null. */
+export function runtimeIdentity(runtime: string | null | undefined): RuntimeIdentity | null {
+  if (!runtime) return null;
+  return RUNTIME_MAP[runtime as Runtime] ?? null;
+}
+
+/** Compact one-line identity for hover / detail surfaces:
+ *  "Anthropic · claude-opus-4 · Claude Code CLI". Pieces with no data drop. */
+export function identityLine(model: string | null | undefined, runtime: string | null | undefined): string {
+  const v = vendorForModel(model);
+  const r = runtimeIdentity(runtime);
+  const parts: string[] = [];
+  if (v.id !== 'unknown') parts.push(v.label);
+  if (model) parts.push(model);
+  if (r) parts.push(r.label);
+  return parts.join(' · ');
+}

package/app/page.tsx

@@ -42,6 +42,10 @@ export default function Dashboard() {
   const [showDispatch, setShowDispatch] = useState(false);
   const [inbox, setInbox] = useState<InboxMessage[]>([]);
   const [agentFilter, setAgentFilter] = useState<'all' | 'working' | 'idle' | 'offline'>('all');
+  // #84: last node.renamed event — passed to TopoGraph so an open chat
+  // popover follows the rename instead of pointing at a dead alias. `ts`
+  // makes the effect re-fire even when the same from/to repeats.
+  const [renameSignal, setRenameSignal] = useState<{ from: string; to: string; ts: number } | null>(null);
   const { mutate } = useSWRConfig();
 
   // SSE: instant revalidation on CommHub events
@@ -51,6 +55,19 @@ export default function Dashboard() {
     url: '/api/hub/events',
     enabled: sseEnabled,
     onEvent: (event) => {
+      // #84 (RFC-010 §3.4): node.renamed — revalidate the session list so the
+      // new alias propagates instantly (TopoGraph + node grid re-render, the
+      // avatar hue recomputes as a pure fn of alias) instead of waiting for
+      // the next 5s poll. The renamed node's history keeps the old alias
+      // server-side, so the task list needs no revalidation here.
+      if (event.type === 'node.renamed') {
+        mutate('/api/hub/status');
+        const d = event.data as { old_alias?: string; new_alias?: string } | undefined;
+        if (d?.old_alias && d?.new_alias) {
+          setRenameSignal({ from: d.old_alias, to: d.new_alias, ts: Date.now() });
+        }
+        return;
+      }
       if (['new_task', 'new_message', 'new_reply', 'node_status_changed', 'broadcast'].includes(event.type)) {
         mutate('/api/hub/status');
         mutate((key: string) => typeof key === 'string' && key.startsWith('/api/hub/tasks'), undefined, { revalidate: true });
@@ -368,7 +385,7 @@ export default function Dashboard() {
         </div>
       )}
 
-      {showTopo && sessions.length > 0 && <TopoGraph sessions={sessions} sseSessions={sseSessions} />}
+      {showTopo && sessions.length > 0 && <TopoGraph sessions={sessions} sseSessions={sseSessions} renameSignal={renameSignal} />}
 
       {sessions.length === 0 && !sessError ? (
         <EmptyState

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sleep2agi/agent-network-dashboard",
-  "version": "0.4.6-preview.2",
+  "version": "0.4.6-preview.21",
   "description": "Agent Network Dashboard — Web UI for managing AI Agent networks",
   "scripts": {
     "dev": "next dev",

package/scripts/chat-popover-test.mjs

@@ -17,6 +17,7 @@ async function run(nodeCount, viewport, label) {
   await ctx.addInitScript(() => {
     try {
       localStorage.setItem('anet-theme', 'cyber');
+localStorage.setItem('anet-topo-nodescale', '1');
       localStorage.removeItem('anet-brand');
       localStorage.removeItem('anet-topo-view');
       sessionStorage.setItem('anet_v3_auth', '1');
@@ -140,6 +141,7 @@ async function runFullscreen() {
   await ctx.addInitScript(() => {
     try {
       localStorage.setItem('anet-theme', 'cyber');
+      localStorage.setItem('anet-topo-nodescale', '1');
       localStorage.removeItem('anet-brand');
       localStorage.removeItem('anet-topo-view');
       sessionStorage.setItem('anet_v3_auth', '1');

package/scripts/chat-theme-test.mjs

@@ -0,0 +1,98 @@
+/* Issue #105 verification: TaskChatPanel + ChatPopover follow the dashboard
+ * light / dark theme (CSS design tokens, no hardcoded darks). Checks the
+ * popover panel + header + input resolve to a light surface under
+ * data-theme="light" and a dark one under "cyber", and captures both. */
+import { chromium } from 'playwright';
+import { readFileSync, mkdirSync } from 'node:fs';
+
+const TOKEN = JSON.parse(readFileSync('/home/vansin/.anet/config.json', 'utf8')).token;
+mkdirSync('/tmp/anet-issue-105', { recursive: true });
+const browser = await chromium.launch({ headless: true });
+
+// crude luminance from "rgb(r, g, b)" — >128 = light surface
+const isLight = (rgb) => {
+  const m = rgb.match(/\d+/g);
+  if (!m) return null;
+  const [r, g, b] = m.map(Number);
+  return (0.299 * r + 0.587 * g + 0.114 * b) > 128;
+};
+
+async function run(theme, expectLight) {
+  const ctx = await browser.newContext({ viewport: { width: 1280, height: 860 } });
+  await ctx.addCookies([{ name: 'anet_dashboard_session', value: `v3:${TOKEN}`, domain: '127.0.0.1', path: '/' }]);
+  await ctx.addInitScript((th) => {
+    try {
+      localStorage.setItem('anet-theme', th);
+localStorage.setItem('anet-topo-nodescale', '1');
+      localStorage.removeItem('anet-brand');
+      localStorage.removeItem('anet-topo-view');
+      localStorage.setItem('anet-topo-layout', 'grid');
+      sessionStorage.setItem('anet_v3_auth', '1');
+    } catch {}
+  }, theme);
+  await ctx.route('**/api/hub/status*', async (route) => {
+    const r = await route.fetch();
+    const b = await r.json();
+    const nid = (b.sessions || [])[0]?.network_id || 'default';
+    const fleet = Array.from({ length: 4 }, (_, i) => ({
+      alias: `节点${i + 1}号`, status: 'idle', network_id: nid,
+      created_at: '2026-05-15T00:00:00Z', updated_at: '2026-05-15T00:00:00Z', last_seen_at: '2026-05-15T00:00:00Z',
+    }));
+    await route.fulfill({ response: r, json: { ...b, sessions: fleet } });
+  });
+  await ctx.route('**/api/hub/tasks*', (route) => route.fulfill({ json: { tasks: [
+    { task_id: 't1', from_name: 'Dashboard', to_name: '节点1号', status: 'replied', priority: 'normal',
+      content: 'ping', result: 'pong — **ready**', created_at: '2026-05-15T00:00:00Z' },
+  ] } }));
+
+  const page = await ctx.newPage();
+  await page.goto('http://127.0.0.1:3000/', { waitUntil: 'domcontentloaded' });
+  await page.waitForFunction(() => {
+    const svg = document.querySelector('svg[viewBox="0 0 1000 680"]');
+    return !!svg && svg.querySelectorAll('circle[r="26"]').length > 0;
+  }, { timeout: 30000 }).catch(() => {});
+  await page.waitForTimeout(700);
+
+  // open the chat popover
+  const ring = page.locator('svg[viewBox="0 0 1000 680"] circle[r="26"]').first();
+  const bb = await ring.boundingBox();
+  if (bb) await page.mouse.wheel(0, bb.y - 160);
+  await page.waitForTimeout(150);
+  await ring.click({ force: true });
+  await page.waitForTimeout(500);
+
+  const popover = page.locator('[role="dialog"][aria-label^="Chat with"]');
+  const results = {};
+
+  const panelBg = await popover.evaluate(el => getComputedStyle(el).backgroundColor);
+  results.panelMatchesTheme = isLight(panelBg) === expectLight;
+
+  // header (first child div) + its title text colour
+  const header = popover.locator('div').first();
+  const headerBg = await header.evaluate(el => getComputedStyle(el).backgroundColor);
+  results.headerMatchesTheme = isLight(headerBg) === expectLight;
+  const titleColor = await header.locator('div.text-sm').first().evaluate(el => getComputedStyle(el).color);
+  // title text must contrast the panel: dark text on light theme, light on dark
+  results.titleContrasts = isLight(titleColor) === !expectLight;
+
+  // input textarea surface
+  const ta = popover.locator('textarea');
+  const taBg = await ta.evaluate(el => getComputedStyle(el).backgroundColor);
+  results.inputMatchesTheme = isLight(taBg) === expectLight;
+
+  await page.screenshot({ path: `/tmp/anet-issue-105/chat-${theme}.png` });
+  await ctx.close();
+
+  const ok = results.panelMatchesTheme && results.headerMatchesTheme &&
+    results.titleContrasts && results.inputMatchesTheme;
+  console.log(`${ok ? '✅' : '❌'} [${theme}] expectLight=${expectLight}:`, JSON.stringify(results), `panelBg=${panelBg}`);
+  return ok;
+}
+
+const all = [];
+all.push(await run('cyber', false));
+all.push(await run('light', true));
+await browser.close();
+const pass = all.every(Boolean);
+console.log(pass ? '\n✅ ALL PASS' : '\n❌ FAIL');
+process.exit(pass ? 0 : 1);

package/scripts/topo-chat-focus-ring-test.mjs

@@ -0,0 +1,77 @@
+/* Round 11 verification: clicking a node opens the ChatPopover AND draws a
+ * persistent chat-focus ring on that node (strokeWidth=2.5, status colour).
+ * Closing the popover removes the ring. The ring's strokeWidth stays clear
+ * of the overlap-test selectors (1.5 / 3). */
+import { chromium } from 'playwright';
+import { readFileSync } from 'node:fs';
+
+const TOKEN = JSON.parse(readFileSync('/home/vansin/.anet/config.json', 'utf8')).token;
+const browser = await chromium.launch({ headless: true });
+
+const ctx = await browser.newContext({ viewport: { width: 1280, height: 900 } });
+await ctx.addCookies([{ name: 'anet_dashboard_session', value: `v3:${TOKEN}`, domain: '127.0.0.1', path: '/' }]);
+await ctx.addInitScript(() => {
+  try {
+    localStorage.setItem('anet-theme', 'cyber');
+    localStorage.removeItem('anet-brand');
+    localStorage.removeItem('anet-topo-view');
+    localStorage.setItem('anet-topo-layout', 'grid');
+    localStorage.setItem('anet-topo-nodescale', '1'); // L so radius=26
+    sessionStorage.setItem('anet_v3_auth', '1');
+  } catch {}
+});
+await ctx.route('**/api/hub/status*', async (route) => {
+  const r = await route.fetch();
+  const b = await r.json();
+  const nid = (b.sessions || [])[0]?.network_id || 'default';
+  const sessions = ['A站马', 'B站马', 'C站马'].map(a => ({
+    alias: a, status: 'idle', network_id: nid,
+    project_dir: null,
+    created_at: '2026-05-15T00:00:00Z', updated_at: '2026-05-15T00:00:00Z',
+    last_seen_at: new Date().toISOString(),
+  }));
+  await route.fulfill({ response: r, json: { ...b, sessions } });
+});
+await ctx.route('**/api/hub/tasks*', (route) => route.fulfill({ json: { tasks: [] } }));
+const page = await ctx.newPage();
+await page.goto('http://127.0.0.1:3000/', { waitUntil: 'domcontentloaded' });
+await page.waitForFunction(() => {
+  const svg = document.querySelector('svg[viewBox="0 0 1000 680"]');
+  return !!svg && svg.querySelectorAll('g[data-node]').length >= 3;
+}, { timeout: 30000 }).catch(() => {});
+await page.waitForTimeout(400);
+
+// Pre-click: NO chat-focus ring on any node (strokeWidth=2.5, no group-hover class)
+const ringsBefore = await page.$$eval('svg[viewBox="0 0 1000 680"] g[data-node] circle[stroke-width="2.5"]', els => els.length);
+
+// Click A站马 → opens chat popover
+await page.locator('g[data-node="A站马"]').click();
+await page.waitForTimeout(300);
+
+const ringsAfter = await page.$$eval('svg[viewBox="0 0 1000 680"] g[data-node] circle[stroke-width="2.5"]', els => els.length);
+const ringOnTarget = await page.$eval(
+  'g[data-node="A站马"] circle[stroke-width="2.5"]',
+  el => ({ r: +el.getAttribute('r'), opacity: +el.getAttribute('opacity') })
+).catch(() => null);
+
+// Confirm popover is open
+const popover = await page.locator('[role="dialog"], [data-chat-popover]').count();
+
+// Ring should be ONLY on the clicked node, not on the others
+const ringOnOther = await page.$$eval('g[data-node="B站马"] circle[stroke-width="2.5"], g[data-node="C站马"] circle[stroke-width="2.5"]', els => els.length);
+
+const results = {
+  noRingBefore: ringsBefore === 0,
+  oneRingAfter: ringsAfter === 1,
+  ringOnTargetNode: !!ringOnTarget && ringOnTarget.r === 40, // radius=26 + 14
+  ringNotOnOthers: ringOnOther === 0,
+};
+
+// Re-run the overlap selector to confirm the chat-focus ring isn't mis-counted as a status ring
+const statusRings = await page.$$eval('svg[viewBox="0 0 1000 680"] g[data-node] circle[stroke-width="3"], svg[viewBox="0 0 1000 680"] g[data-node] circle[stroke-width="1.5"]', els => els.length);
+results.statusRingCountUnchanged = statusRings === 3; // exactly one per online node
+
+await browser.close();
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} chat-focus ring:`, JSON.stringify(results));
+process.exit(ok ? 0 : 1);

package/scripts/topo-groupbox-test.mjs

@@ -0,0 +1,118 @@
+/* Issue #111 verification: prefix-group boundary boxes in grid layout.
+ * Mixed-prefix fleet → each multi-member group gets a box that encloses
+ * exactly its nodes; singletons get no box; ring layout has no boxes. */
+import { chromium } from 'playwright';
+import { readFileSync, mkdirSync } from 'node:fs';
+
+const TOKEN = JSON.parse(readFileSync('/home/vansin/.anet/config.json', 'utf8')).token;
+mkdirSync('/tmp/anet-issue-111', { recursive: true });
+const browser = await chromium.launch({ headless: true });
+
+// 3 multi-member prefix groups + 1 singleton
+const FLEET = [
+  'A站1号', 'A站2号', 'A站3号',
+  '书生1号', '书生2号',
+  '通信龙', '通信牛', '通信马',
+  '独立号',
+];
+
+async function load(theme, layout) {
+  const ctx = await browser.newContext({ viewport: { width: 1280, height: 860 } });
+  await ctx.addCookies([{ name: 'anet_dashboard_session', value: `v3:${TOKEN}`, domain: '127.0.0.1', path: '/' }]);
+  await ctx.addInitScript(({ th, lay }) => {
+    try {
+      localStorage.setItem('anet-theme', th);
+localStorage.setItem('anet-topo-nodescale', '1');
+      localStorage.removeItem('anet-brand');
+      localStorage.removeItem('anet-topo-view');
+      localStorage.setItem('anet-topo-layout', lay);
+      sessionStorage.setItem('anet_v3_auth', '1');
+    } catch {}
+  }, { th: theme, lay: layout });
+  await ctx.route('**/api/hub/status*', async (route) => {
+    const r = await route.fetch();
+    const b = await r.json();
+    const nid = (b.sessions || [])[0]?.network_id || 'default';
+    const sessions = FLEET.map(alias => ({
+      alias, status: 'idle', network_id: nid,
+      created_at: '2026-05-15T00:00:00Z', updated_at: '2026-05-15T00:00:00Z', last_seen_at: '2026-05-15T00:00:00Z',
+    }));
+    await route.fulfill({ response: r, json: { ...b, sessions } });
+  });
+  await ctx.route('**/api/hub/tasks*', (route) => route.fulfill({ json: { tasks: [] } }));
+  const page = await ctx.newPage();
+  await page.goto('http://127.0.0.1:3000/', { waitUntil: 'domcontentloaded' });
+  await page.waitForFunction(() => {
+    const svg = document.querySelector('svg[viewBox="0 0 1000 680"]');
+    return !!svg && svg.querySelectorAll('circle[r="26"]').length > 0;
+  }, { timeout: 30000 }).catch(() => {});
+  await page.waitForTimeout(700);
+  return { ctx, page };
+}
+
+const results = {};
+
+// --- grid layout: boxes exist + enclose their groups ---
+{
+  const { ctx, page } = await load('cyber', 'grid');
+  const svg = 'svg[viewBox="0 0 1000 680"]';
+  const groups = await page.$$eval(`${svg} g[data-group]`, els => els.map(e => e.getAttribute('data-group')));
+  results.gridBoxCount = groups.length;
+  results.gridGroupsCorrect = ['A站', '书生', '通信'].every(g => groups.includes(g));
+  results.gridNoSingletonBox = !groups.includes('独立号');
+
+  // each box rect must enclose exactly its group's node centres
+  results.gridBoxesEnclose = await page.evaluate(() => {
+    const svg = document.querySelector('svg[viewBox="0 0 1000 680"]');
+    const nodeCenter = {};
+    svg.querySelectorAll('g[style] circle[r="26"]').forEach(c => {
+      // nearest ancestor <g> with the node's <title> tells us the alias
+      const g = c.closest('g');
+      const t = g?.querySelector('title')?.textContent || '';
+      if (t) nodeCenter[t] = { x: +c.getAttribute('cx'), y: +c.getAttribute('cy') };
+    });
+    const expect = { 'A站': ['A站1号', 'A站2号', 'A站3号'], '书生': ['书生1号', '书生2号'], '通信': ['通信龙', '通信牛', '通信马'] };
+    let allGood = true;
+    for (const g of svg.querySelectorAll('g[data-group]')) {
+      const key = g.getAttribute('data-group');
+      const rect = g.querySelector('rect');
+      const bx = +rect.getAttribute('x'), by = +rect.getAttribute('y');
+      const bw = +rect.getAttribute('width'), bh = +rect.getAttribute('height');
+      for (const alias of (expect[key] || [])) {
+        const c = nodeCenter[alias];
+        if (!c || c.x < bx || c.x > bx + bw || c.y < by || c.y > by + bh) allGood = false;
+      }
+    }
+    return allGood;
+  });
+
+  // label text present for each group
+  const labels = await page.$$eval(`${svg} g[data-group] text`, els => els.map(e => (e.textContent || '').trim()));
+  results.gridLabels = ['A站', '书生', '通信'].every(g => labels.includes(g));
+
+  await page.screenshot({ path: '/tmp/anet-issue-111/groupbox-grid-cyber.png' });
+  await ctx.close();
+}
+
+// --- light theme grid: boxes still render ---
+{
+  const { ctx, page } = await load('light', 'grid');
+  const n = await page.$$eval('svg[viewBox="0 0 1000 680"] g[data-group]', els => els.length);
+  results.lightGridBoxes = n === 3;
+  await page.screenshot({ path: '/tmp/anet-issue-111/groupbox-grid-light.png' });
+  await ctx.close();
+}
+
+// --- ring layout: no boxes ---
+{
+  const { ctx, page } = await load('cyber', 'ring');
+  const n = await page.$$eval('svg[viewBox="0 0 1000 680"] g[data-group]', els => els.length);
+  results.ringNoBoxes = n === 0;
+  await ctx.close();
+}
+
+await browser.close();
+const ok = results.gridBoxCount === 3 && results.gridGroupsCorrect && results.gridNoSingletonBox &&
+  results.gridBoxesEnclose && results.gridLabels && results.lightGridBoxes && results.ringNoBoxes;
+console.log(`${ok ? '✅' : '❌'} #111 group boxes:`, JSON.stringify(results));
+process.exit(ok ? 0 : 1);

package/scripts/topo-layout-test.mjs

@@ -0,0 +1,113 @@
+/* Issue #87 verification: ring | grid layout toggle on TopoGraph.
+ * Checks: toggle switches positions, ring ambiance hides in grid, layout
+ * persists to localStorage, node click still opens chat in grid mode. */
+import { chromium } from 'playwright';
+import { readFileSync, mkdirSync } from 'node:fs';
+
+const TOKEN = JSON.parse(readFileSync('/home/vansin/.anet/config.json', 'utf8')).token;
+mkdirSync('/tmp/anet-issue-87', { recursive: true });
+const browser = await chromium.launch({ headless: true });
+
+async function run(nodeCount, label) {
+  const ctx = await browser.newContext({ viewport: { width: 1440, height: 900 } });
+  await ctx.addCookies([{ name: 'anet_dashboard_session', value: `v3:${TOKEN}`, domain: '127.0.0.1', path: '/' }]);
+  // NB: addInitScript runs on every load incl. reloads — must NOT touch
+  // anet-topo-layout here or it'd wipe the persisted value the reload test
+  // checks. A fresh context already starts with empty localStorage.
+  await ctx.addInitScript(() => {
+    try {
+      localStorage.setItem('anet-theme', 'cyber');
+localStorage.setItem('anet-topo-nodescale', '1');
+      localStorage.removeItem('anet-brand');
+      sessionStorage.setItem('anet_v3_auth', '1');
+    } catch {}
+  });
+  await ctx.route('**/api/hub/status*', async (route) => {
+    const r = await route.fetch();
+    const b = await r.json();
+    const nid = (b.sessions || [])[0]?.network_id || 'default';
+    const fleet = Array.from({ length: nodeCount }, (_, i) => ({
+      alias: `节点${i + 1}号`, status: i % 4 === 0 ? 'working' : 'idle', network_id: nid,
+      created_at: '2026-05-14T00:00:00Z', updated_at: '2026-05-14T00:00:00Z', last_seen_at: '2026-05-14T00:00:00Z',
+    }));
+    await route.fulfill({ response: r, json: { ...b, sessions: fleet } });
+  });
+  await ctx.route('**/api/hub/tasks*', (route) => route.fulfill({ json: { tasks: [] } }));
+
+  const page = await ctx.newPage();
+  await page.goto('http://127.0.0.1:3000/', { waitUntil: 'domcontentloaded' });
+  await page.waitForFunction(() => {
+    const svg = document.querySelector('svg[viewBox="0 0 1000 680"]');
+    return !!svg && svg.querySelectorAll('circle[r="26"]').length > 0;
+  }, { timeout: 30000 }).catch(() => {});
+  await page.waitForTimeout(700);
+
+  const results = {};
+  const svgSel = 'svg[viewBox="0 0 1000 680"]';
+  // node center positions (status rings cx/cy)
+  const positions = () => page.$$eval(`${svgSel} circle[r="26"], ${svgSel} circle[r="18"]`,
+    els => els.map(e => `${e.getAttribute('cx')},${e.getAttribute('cy')}`).join('|'));
+  // ring ambiance marker: the radar backdrop circle r=330
+  const ringAmbiance = () => page.locator(`${svgSel} circle[r="330"]`).count();
+
+  // --- ring mode (default) ---
+  results.ringHasAmbiance = (await ringAmbiance()) > 0;
+  const ringPos = await positions();
+
+  // --- toggle to grid ---
+  await page.locator('button', { hasText: 'Grid' }).click();
+  await page.waitForTimeout(400);
+  const gridPos = await positions();
+  results.toggledPositions = ringPos !== gridPos && gridPos.length > 0;
+  results.gridHidesAmbiance = (await ringAmbiance()) === 0;
+  results.persistedGrid = (await page.evaluate(() => localStorage.getItem('anet-topo-layout'))) === 'grid';
+
+  // grid nodes should sit on a small set of distinct rows (grid = aligned y's)
+  results.gridRowsAligned = await page.$$eval(`${svgSel} circle[r="26"], ${svgSel} circle[r="18"]`, els => {
+    const ys = els.map(e => Math.round(parseFloat(e.getAttribute('cy'))));
+    const distinct = new Set(ys);
+    // a grid of N nodes has ⌈√N⌉ rows → far fewer distinct y's than a ring
+    return distinct.size <= Math.ceil(Math.sqrt(els.length)) + 1;
+  });
+
+  // --- node click still opens chat in grid mode ---
+  const ring = page.locator(`${svgSel} circle[r="26"]`).first();
+  const bb = await ring.boundingBox();
+  if (bb) await page.mouse.wheel(0, bb.y - 160);
+  await page.waitForTimeout(150);
+  await ring.click({ force: true });
+  await page.waitForTimeout(400);
+  results.chatWorksInGrid = (await page.locator('[role="dialog"][aria-label^="Chat with"]').count()) === 1;
+  await page.screenshot({ path: `/tmp/anet-issue-87/grid-${label}.png` });
+
+  // --- reload: layout persists ---
+  await page.reload({ waitUntil: 'domcontentloaded' });
+  await page.waitForFunction(() => {
+    const svg = document.querySelector('svg[viewBox="0 0 1000 680"]');
+    return !!svg && svg.querySelectorAll('circle[r="26"]').length > 0;
+  }, { timeout: 30000 }).catch(() => {});
+  await page.waitForTimeout(500);
+  results.persistsAcrossReload = (await ringAmbiance()) === 0 &&
+    (await page.evaluate(() => localStorage.getItem('anet-topo-layout'))) === 'grid';
+
+  // --- toggle back to ring ---
+  await page.locator('button', { hasText: 'Ring' }).click();
+  await page.waitForTimeout(400);
+  results.ringRestores = (await ringAmbiance()) > 0;
+
+  await ctx.close();
+  const ok = results.ringHasAmbiance && results.toggledPositions && results.gridHidesAmbiance &&
+    results.persistedGrid && results.gridRowsAligned && results.chatWorksInGrid &&
+    results.persistsAcrossReload && results.ringRestores;
+  console.log(`${ok ? '✅' : '❌'} [${label}] ${nodeCount} nodes:`, JSON.stringify(results));
+  return ok;
+}
+
+const all = [];
+all.push(await run(6, 'small'));
+all.push(await run(22, 'medium'));
+all.push(await run(50, 'large'));
+await browser.close();
+const pass = all.every(Boolean);
+console.log(pass ? '\n✅ ALL PASS' : '\n❌ FAIL');
+process.exit(pass ? 0 : 1);