@copilotz/admin 0.9.39 → 0.9.41

package/dist/index.js

@@ -234,6 +234,14 @@ function createAdminClient(options = {}) {
       kind: filters.kind === "all" ? void 0 : filters.kind,
       status: filters.status === "all" ? void 0 : filters.status,
       search: filters.search,
+      searchMode: filters.searchMode,
+      focusNodeId: filters.focusNodeId,
+      includeRelated: filters.includeRelated ? "true" : void 0,
+      includeSimilar: filters.includeSimilar ? "true" : void 0,
+      similarLimit: filters.similarLimit ? String(filters.similarLimit) : void 0,
+      minSimilarity: typeof filters.minSimilarity === "number" ? String(filters.minSimilarity) : void 0,
+      relationDepth: filters.relationDepth ? String(filters.relationDepth) : void 0,
+      relationTypes: filters.relationTypes?.join(","),
       limit: String(filters.limit ?? 160),
       offset: filters.offset ? String(filters.offset) : void 0
     }),
@@ -1948,18 +1956,165 @@ function AgentDetailPage({ context }) {
 // src/modules/brain/index.tsx
 import React7 from "react";
 import {
+  BookOpen,
   Brain as Brain2,
-  CircleDot,
-  Network,
+  GitBranch,
   RefreshCw,
   Search as Search2,
-  Sparkles
+  Sparkles,
+  UsersRound
 } from "lucide-react";
+
+// src/modules/brain/view-model.ts
+var ENTITY_FOCUS_RELATION_TYPES = [
+  "mentions",
+  "related_to",
+  "supports",
+  "depends_on",
+  "contradicts",
+  "supersedes"
+];
+var BRAIN_VIEW_LABELS = {
+  entities: "Entities",
+  knowledge: "Knowledge",
+  work: "Work",
+  map: "Map",
+  all: "All nodes"
+};
+var BRAIN_RELATION_GROUP_DEFINITIONS = [
+  {
+    id: "decisions",
+    label: "Decisions",
+    description: "Durable choices connected to this entity.",
+    kinds: ["decision"]
+  },
+  {
+    id: "facts",
+    label: "Facts",
+    description: "Known statements and observations.",
+    kinds: ["fact"]
+  },
+  {
+    id: "tasks",
+    label: "Tasks",
+    description: "Actions, next steps, and execution work.",
+    kinds: ["task", "next_action"]
+  },
+  {
+    id: "preferences",
+    label: "Preferences",
+    description: "Remembered user, org, or agent preferences.",
+    kinds: ["preference"]
+  },
+  {
+    id: "constraints",
+    label: "Constraints",
+    description: "Limits, rules, and requirements.",
+    kinds: ["constraint"]
+  },
+  {
+    id: "risks",
+    label: "Risks",
+    description: "Known risks or possible failures.",
+    kinds: ["risk"]
+  },
+  {
+    id: "openQuestions",
+    label: "Open questions",
+    description: "Questions that still need resolution.",
+    kinds: ["open_question"]
+  },
+  {
+    id: "currentState",
+    label: "Current state",
+    description: "Shorter-term context, challenges, and active state.",
+    kinds: ["current_state", "challenge"]
+  },
+  {
+    id: "entities",
+    label: "Other entities",
+    description: "Neighboring people, systems, projects, or concepts.",
+    kinds: ["entity"]
+  },
+  {
+    id: "other",
+    label: "Other",
+    description: "Related nodes that do not fit a standard Brain kind yet.",
+    kinds: []
+  }
+];
+var GROUP_BY_KIND = new Map(
+  BRAIN_RELATION_GROUP_DEFINITIONS.flatMap(
+    (group) => group.kinds.map((kind) => [kind, group.id])
+  )
+);
+function getBrainViewBaseFilters(view) {
+  if (view === "entities") {
+    return { kind: "entity", layer: "knowledge" };
+  }
+  if (view === "knowledge") {
+    return { kind: "all", layer: "knowledge" };
+  }
+  if (view === "work") {
+    return { kind: "all", layer: "working" };
+  }
+  return { kind: "all", layer: "all" };
+}
+function isEntityBrainView(view) {
+  return view === "entities";
+}
+function groupBrainRelationsByKind(related) {
+  const groups = BRAIN_RELATION_GROUP_DEFINITIONS.map((definition) => ({
+    id: definition.id,
+    label: definition.label,
+    description: definition.description,
+    items: []
+  }));
+  const byId = new Map(groups.map((group) => [group.id, group]));
+  for (const item of related) {
+    const groupId = GROUP_BY_KIND.get(item.node.kind) ?? "other";
+    byId.get(groupId)?.items.push(item);
+  }
+  return groups.filter((group) => group.items.length > 0);
+}
+function getKnowledgeRelationGroups(related) {
+  const knowledgeGroupIds = [
+    "decisions",
+    "facts",
+    "preferences",
+    "constraints"
+  ];
+  return groupBrainRelationsByKind(related).filter(
+    (group) => knowledgeGroupIds.includes(group.id)
+  );
+}
+function getWorkRelationGroups(related) {
+  const workGroupIds = [
+    "tasks",
+    "risks",
+    "openQuestions",
+    "currentState"
+  ];
+  return groupBrainRelationsByKind(related).filter(
+    (group) => workGroupIds.includes(group.id)
+  );
+}
+
+// src/modules/brain/index.tsx
 import { jsx as jsx21, jsxs as jsxs13 } from "react/jsx-runtime";
 var BRAIN_LAYERS = ["all", "knowledge", "working"];
+var BRAIN_SEARCH_MODES = ["hybrid", "semantic", "keyword"];
 var BRAIN_STATUSES = ["active", "all", "superseded", "archived"];
+var BRAIN_VIEWS = [
+  "entities",
+  "knowledge",
+  "work",
+  "map",
+  "all"
+];
 var BRAIN_KINDS = [
   "all",
+  "entity",
   "decision",
   "fact",
   "preference",
@@ -1993,7 +2148,11 @@ function brainModule() {
   };
 }
 function BrainPage({ context }) {
+  const [view, setView] = React7.useState("entities");
   const [search, setSearch] = React7.useState("");
+  const [searchMode, setSearchMode] = React7.useState(
+    "hybrid"
+  );
   const [layer, setLayer] = React7.useState("all");
   const [status, setStatus] = React7.useState(
     "active"
@@ -2006,25 +2165,44 @@ function BrainPage({ context }) {
   const [selectedNode, setSelectedNode] = React7.useState(
     null
   );
+  const [focusNodeId, setFocusNodeId] = React7.useState(null);
   const [loading, setLoading] = React7.useState(false);
   const [error, setError] = React7.useState(null);
-  const loadBrain = React7.useCallback(async () => {
+  const loadBrain = React7.useCallback(async (focusOverride) => {
     setLoading(true);
     setError(null);
+    const effectiveFocusNodeId = focusOverride === void 0 ? focusNodeId : focusOverride;
+    const viewFilters = getBrainViewBaseFilters(view);
+    const effectiveLayer = view === "map" || view === "all" ? layer : viewFilters.layer;
+    const effectiveKind = view === "entities" ? "entity" : kind;
     try {
       const next = await context.client.getBrain({
         namespace: context.scope.namespace || void 0,
         search: search.trim() || void 0,
-        layer,
+        searchMode,
+        layer: effectiveLayer,
         status,
-        kind,
+        kind: effectiveKind,
         agentId: agentId.trim() || void 0,
+        focusNodeId: effectiveFocusNodeId || void 0,
+        includeRelated: Boolean(effectiveFocusNodeId),
+        includeSimilar: Boolean(effectiveFocusNodeId),
+        similarLimit: 24,
+        minSimilarity: 0.2,
+        relationTypes: effectiveFocusNodeId ? [...ENTITY_FOCUS_RELATION_TYPES] : void 0,
         limit: 180
       });
       setResponse(next);
-      setSelectedNode(
-        (current) => current && next.nodes.some((node) => node.id === current.id) ? current : next.nodes[0] ?? null
-      );
+      setSelectedNode((current) => {
+        const currentInResults = current ? next.nodes.find((node) => node.id === current.id) ?? current : null;
+        if (effectiveFocusNodeId) {
+          return next.nodes.find((node) => node.id === effectiveFocusNodeId) ?? currentInResults;
+        }
+        if (view === "entities") {
+          return current && next.nodes.some((node) => node.id === current.id) ? currentInResults : null;
+        }
+        return current && next.nodes.some((node) => node.id === current.id) ? currentInResults : next.nodes[0] ?? null;
+      });
     } catch (cause) {
       setError(cause instanceof Error ? cause.message : "Failed to load brain");
       setResponse(null);
@@ -2036,17 +2214,38 @@ function BrainPage({ context }) {
     agentId,
     context.client,
     context.scope.namespace,
+    focusNodeId,
     kind,
     layer,
     search,
-    status
+    searchMode,
+    status,
+    view
   ]);
   React7.useEffect(() => {
     void loadBrain();
-  }, [context.refreshKey, context.scope.namespace, loadBrain]);
+  }, [context.refreshKey, context.scope.namespace, focusNodeId, loadBrain]);
   const data = response ?? emptyBrainResponse();
+  const matches = data.matches ?? {};
+  const related = data.related ?? [];
+  const similar = data.similar ?? [];
+  const entityCount = data.stats.byKind.entity ?? data.nodes.filter((node) => node.kind === "entity").length;
   const knowledgeCount = data.stats.byLayer.knowledge ?? 0;
   const workingCount = data.stats.byLayer.working ?? 0;
+  const selectNode = React7.useCallback((node) => {
+    setSelectedNode(node);
+    setFocusNodeId(node.id);
+  }, []);
+  const selectView = React7.useCallback((nextView) => {
+    setView(nextView);
+    setFocusNodeId(null);
+    setSelectedNode(null);
+  }, []);
+  const runSearch = React7.useCallback(() => {
+    setFocusNodeId(null);
+    setSelectedNode(null);
+    void loadBrain(null);
+  }, [loadBrain]);
   return /* @__PURE__ */ jsxs13("div", { className: "space-y-4", children: [
     /* @__PURE__ */ jsx21(
       PageHeader,
@@ -2080,16 +2279,16 @@ function BrainPage({ context }) {
       {
         items: [
           {
-            label: "Brain nodes",
-            value: data.stats.total,
-            detail: `${data.pageInfo.returned} shown`,
-            icon: Brain2
+            label: "Entities",
+            value: entityCount,
+            detail: view === "entities" ? `${data.pageInfo.returned} shown` : "Stable anchors",
+            icon: UsersRound
           },
           {
             label: "Knowledge",
             value: knowledgeCount,
             detail: "Durable nodes",
-            icon: CircleDot
+            icon: BookOpen
           },
           {
             label: "Working",
@@ -2098,14 +2297,27 @@ function BrainPage({ context }) {
             icon: Sparkles
           },
           {
-            label: "Clusters",
-            value: data.clusters.length,
-            detail: "Layer and kind",
-            icon: Network
+            label: selectedNode ? "Focus links" : "Brain nodes",
+            value: selectedNode ? related.length + similar.length : data.stats.total,
+            detail: selectedNode ? "Related and similar" : `${data.pageInfo.returned} shown`,
+            icon: selectedNode ? GitBranch : Brain2
           }
         ]
       }
     ),
+    /* @__PURE__ */ jsx21("div", { className: "inline-flex max-w-full overflow-hidden rounded-md border bg-background", children: BRAIN_VIEWS.map((item) => /* @__PURE__ */ jsx21(
+      "button",
+      {
+        className: cn(
+          "min-w-0 px-3 py-2 text-xs transition-colors sm:px-4",
+          view === item ? "bg-primary text-primary-foreground" : "text-muted-foreground hover:bg-muted"
+        ),
+        onClick: () => selectView(item),
+        type: "button",
+        children: BRAIN_VIEW_LABELS[item]
+      },
+      item
+    )) }),
     /* @__PURE__ */ jsxs13(
       FilterBar,
       {
@@ -2113,7 +2325,7 @@ function BrainPage({ context }) {
           Button,
           {
             disabled: loading,
-            onClick: () => void loadBrain(),
+            onClick: runSearch,
             size: "sm",
             type: "button",
             children: [
@@ -2123,20 +2335,40 @@ function BrainPage({ context }) {
           }
         ),
         onSearchChange: setSearch,
-        searchPlaceholder: "Search brain",
+        searchPlaceholder: view === "entities" ? "Search entities" : "Search brain",
         searchValue: search,
         children: [
-          /* @__PURE__ */ jsxs13(
+          /* @__PURE__ */ jsx21("div", { className: "inline-flex h-8 overflow-hidden rounded-md border bg-background", children: BRAIN_SEARCH_MODES.map((mode) => /* @__PURE__ */ jsx21(
+            "button",
+            {
+              className: cn(
+                "px-3 text-xs transition-colors",
+                searchMode === mode ? "bg-primary text-primary-foreground" : "text-muted-foreground hover:bg-muted"
+              ),
+              onClick: () => setSearchMode(mode),
+              type: "button",
+              children: formatLabel(mode)
+            },
+            mode
+          )) }),
+          view === "map" || view === "all" ? /* @__PURE__ */ jsxs13(
             Select,
             {
               value: layer,
               onValueChange: (value) => setLayer(value),
               children: [
-                /* @__PURE__ */ jsx21(SelectTrigger, { className: "h-8 w-[140px] text-xs", "aria-label": "Layer", children: /* @__PURE__ */ jsx21(SelectValue, {}) }),
+                /* @__PURE__ */ jsx21(
+                  SelectTrigger,
+                  {
+                    className: "h-8 w-[140px] text-xs",
+                    "aria-label": "Layer",
+                    children: /* @__PURE__ */ jsx21(SelectValue, {})
+                  }
+                ),
                 /* @__PURE__ */ jsx21(SelectContent, { children: BRAIN_LAYERS.map((option) => /* @__PURE__ */ jsx21(SelectItem, { value: option, children: option === "all" ? "All layers" : formatLabel(option) }, option)) })
               ]
             }
-          ),
+          ) : null,
           /* @__PURE__ */ jsxs13(
             Select,
             {
@@ -2148,24 +2380,31 @@ function BrainPage({ context }) {
               ]
             }
           ),
-          /* @__PURE__ */ jsxs13(
+          view !== "entities" ? /* @__PURE__ */ jsxs13(
             Select,
             {
               value: kind,
               onValueChange: (value) => setKind(value),
               children: [
-                /* @__PURE__ */ jsx21(SelectTrigger, { className: "h-8 w-[170px] text-xs", "aria-label": "Kind", children: /* @__PURE__ */ jsx21(SelectValue, {}) }),
+                /* @__PURE__ */ jsx21(
+                  SelectTrigger,
+                  {
+                    className: "h-8 w-[170px] text-xs",
+                    "aria-label": "Kind",
+                    children: /* @__PURE__ */ jsx21(SelectValue, {})
+                  }
+                ),
                 /* @__PURE__ */ jsx21(SelectContent, { children: BRAIN_KINDS.map((option) => /* @__PURE__ */ jsx21(SelectItem, { value: option, children: option === "all" ? "All kinds" : formatLabel(option) }, option)) })
               ]
             }
-          ),
+          ) : /* @__PURE__ */ jsx21(Badge, { className: "h-8 px-3", variant: "secondary", children: "Entity index" }),
           /* @__PURE__ */ jsx21(
             Input,
             {
               className: "h-8 w-[190px]",
               onChange: (event) => setAgentId(event.target.value),
               onKeyDown: (event) => {
-                if (event.key === "Enter") void loadBrain();
+                if (event.key === "Enter") runSearch();
               },
               placeholder: "Agent ID",
               value: agentId
@@ -2174,10 +2413,23 @@ function BrainPage({ context }) {
         ]
       }
     ),
+    data.semantic?.requested && data.semantic.error ? /* @__PURE__ */ jsxs13("div", { className: "rounded-md border border-destructive/30 bg-destructive/5 px-3 py-2 text-xs text-destructive", children: [
+      "Semantic search unavailable: ",
+      data.semantic.error
+    ] }) : null,
     error ? /* @__PURE__ */ jsx21(EmptyState, { title: "Unable to load brain", description: error }) : /* @__PURE__ */ jsx21(
       InspectorPanel,
       {
-        side: selectedNode ? /* @__PURE__ */ jsx21(BrainNodeInspector, { node: selectedNode }) : /* @__PURE__ */ jsx21(
+        side: selectedNode ? /* @__PURE__ */ jsx21(
+          BrainNodeInspector,
+          {
+            match: matches[selectedNode.id],
+            node: selectedNode,
+            onSelectNode: selectNode,
+            related,
+            similar
+          }
+        ) : /* @__PURE__ */ jsx21(
           EmptyState,
           {
             icon: Brain2,
@@ -2185,70 +2437,299 @@ function BrainPage({ context }) {
             description: "Select a node from the map or table."
           }
         ),
-        children: /* @__PURE__ */ jsxs13("div", { className: "space-y-4", children: [
+        children: /* @__PURE__ */ jsx21("div", { className: "space-y-4", children: /* @__PURE__ */ jsx21(
+          BrainPrimaryContent,
+          {
+            data,
+            loading,
+            matches,
+            onSelectNode: selectNode,
+            related,
+            selectedNode,
+            similar,
+            view
+          }
+        ) })
+      }
+    )
+  ] });
+}
+function BrainPrimaryContent({
+  data,
+  loading,
+  matches,
+  onSelectNode,
+  related,
+  selectedNode,
+  similar,
+  view
+}) {
+  if (view === "entities") {
+    return /* @__PURE__ */ jsxs13("div", { className: "space-y-4", children: [
+      /* @__PURE__ */ jsx21(
+        EntityEgoGraph,
+        {
+          entity: selectedNode?.kind === "entity" ? selectedNode : null,
+          loading,
+          onSelectNode,
+          related,
+          similar
+        }
+      ),
+      /* @__PURE__ */ jsx21(
+        BrainNodeTable,
+        {
+          emptyDescription: "Entity nodes will appear here once the Brain has named people, tenants, projects, products, tools, policies, or concepts.",
+          emptyTitle: loading ? "Loading entities" : "No entities yet",
+          loading,
+          matches,
+          nodes: data.nodes,
+          onSelectNode,
+          variant: "entities"
+        }
+      )
+    ] });
+  }
+  if (view === "map") {
+    return /* @__PURE__ */ jsxs13("div", { className: "space-y-4", children: [
+      /* @__PURE__ */ jsx21(
+        BrainMap,
+        {
+          clusters: data.clusters,
+          edges: data.edges,
+          loading,
+          nodes: data.nodes,
+          onSelectNode,
+          similar,
+          selectedNodeId: selectedNode?.id ?? null
+        }
+      ),
+      /* @__PURE__ */ jsx21(
+        BrainNodeTable,
+        {
+          emptyDescription: "Knowledge and working-state nodes will appear here.",
+          emptyTitle: loading ? "Loading brain" : "No brain nodes",
+          loading,
+          matches,
+          nodes: data.nodes,
+          onSelectNode
+        }
+      )
+    ] });
+  }
+  return /* @__PURE__ */ jsx21(
+    BrainNodeTable,
+    {
+      emptyDescription: view === "work" ? "Working-state nodes will appear here when the Brain captures current challenges, tasks, risks, and open questions." : view === "knowledge" ? "Durable facts, decisions, preferences, constraints, and entities will appear here." : "Knowledge and working-state nodes will appear here.",
+      emptyTitle: loading ? `Loading ${BRAIN_VIEW_LABELS[view].toLowerCase()}` : `No ${BRAIN_VIEW_LABELS[view].toLowerCase()}`,
+      loading,
+      matches,
+      nodes: data.nodes,
+      onSelectNode
+    }
+  );
+}
+function BrainNodeTable({
+  emptyDescription,
+  emptyTitle,
+  loading,
+  matches,
+  nodes,
+  onSelectNode,
+  variant = "default"
+}) {
+  return /* @__PURE__ */ jsx21(
+    ResourceTable,
+    {
+      rows: nodes,
+      getRowKey: (row) => row.id,
+      onRowClick: onSelectNode,
+      empty: /* @__PURE__ */ jsx21(
+        EmptyState,
+        {
+          icon: variant === "entities" ? UsersRound : Brain2,
+          title: emptyTitle,
+          description: loading ? "Fetching Brain nodes for the active namespace." : emptyDescription
+        }
+      ),
+      columns: [
+        {
+          id: "node",
+          header: variant === "entities" ? "Entity" : "Node",
+          className: "max-w-[420px]",
+          render: (row) => /* @__PURE__ */ jsxs13("div", { className: "min-w-0", children: [
+            /* @__PURE__ */ jsx21("div", { className: "truncate font-medium", children: row.name }),
+            /* @__PURE__ */ jsx21("div", { className: "truncate text-xs text-muted-foreground", children: row.content || "-" }),
+            /* @__PURE__ */ jsx21(MatchBadges, { match: matches[row.id] })
+          ] })
+        },
+        ...variant === "entities" ? [{
+          id: "updated",
+          header: "Updated",
+          className: "whitespace-nowrap text-xs",
+          render: (row) => formatDateTime(row.updatedAt)
+        }] : [{
+          id: "layer",
+          header: "Layer",
+          render: (row) => /* @__PURE__ */ jsx21(LayerBadge, { layer: row.layer })
+        }, {
+          id: "kind",
+          header: "Kind",
+          render: (row) => formatLabel(row.kind)
+        }],
+        {
+          id: "status",
+          header: "Status",
+          render: (row) => /* @__PURE__ */ jsx21(StatusBadge, { status: row.status })
+        },
+        {
+          id: "agent",
+          header: "Agent",
+          className: "max-w-[160px] truncate font-mono text-xs",
+          render: (row) => row.agentId ?? "-"
+        }
+      ]
+    }
+  );
+}
+function EntityEgoGraph({
+  entity,
+  loading,
+  onSelectNode,
+  related,
+  similar
+}) {
+  if (!entity) {
+    return /* @__PURE__ */ jsx21("div", { className: "flex min-h-[300px] items-center justify-center rounded-lg border bg-background", children: /* @__PURE__ */ jsx21(
+      EmptyState,
+      {
+        icon: UsersRound,
+        title: loading ? "Loading entity workspace" : "Select an entity",
+        description: loading ? "Fetching entity nodes for the active namespace." : "Choose an entity to see its explicit relations and semantic neighbors."
+      }
+    ) });
+  }
+  const relatedItems = related.slice(0, 18);
+  const similarItems = similar.slice(0, 10);
+  const orbitCount = relatedItems.length + similarItems.length;
+  const center = { x: 500, y: 260 };
+  const radius = orbitCount > 12 ? 190 : 165;
+  const orbitNodes = [
+    ...relatedItems.map((item, index) => ({
+      id: item.edge.id,
+      index,
+      node: item.node,
+      tone: "relation",
+      label: formatLabel(item.edge.type)
+    })),
+    ...similarItems.map((item, index) => ({
+      id: `similar-${item.node.id}`,
+      index: index + relatedItems.length,
+      node: item.node,
+      tone: "similar",
+      label: formatSimilarityScore(item.similarity)
+    }))
+  ].map((item) => {
+    const angle = orbitCount > 0 ? Math.PI * 2 * item.index / orbitCount - Math.PI / 2 : 0;
+    return {
+      ...item,
+      x: center.x + Math.cos(angle) * radius,
+      y: center.y + Math.sin(angle) * radius
+    };
+  });
+  return /* @__PURE__ */ jsx21("div", { className: "overflow-hidden rounded-lg border bg-background", children: /* @__PURE__ */ jsxs13("div", { className: "grid gap-0 lg:grid-cols-[minmax(0,1.5fr)_320px]", children: [
+    /* @__PURE__ */ jsxs13(
+      "svg",
+      {
+        className: "block h-[380px] w-full bg-muted/20",
+        role: "img",
+        viewBox: "0 0 1000 520",
+        children: [
+          /* @__PURE__ */ jsx21("rect", { fill: "transparent", height: "520", width: "1000" }),
+          orbitNodes.map((item) => /* @__PURE__ */ jsx21(
+            "line",
+            {
+              stroke: item.tone === "similar" ? "#0ea5e9" : "#64748b",
+              strokeDasharray: item.tone === "similar" ? "6 7" : void 0,
+              strokeOpacity: item.tone === "similar" ? "0.48" : "0.38",
+              strokeWidth: item.tone === "similar" ? "1.8" : "2.2",
+              x1: center.x,
+              x2: item.x,
+              y1: center.y,
+              y2: item.y
+            },
+            `line-${item.id}`
+          )),
           /* @__PURE__ */ jsx21(
-            BrainMap,
+            "circle",
             {
-              clusters: data.clusters,
-              edges: data.edges,
-              loading,
-              nodes: data.nodes,
-              onSelectNode: setSelectedNode,
-              selectedNodeId: selectedNode?.id ?? null
+              cx: center.x,
+              cy: center.y,
+              fill: nodeColor(entity),
+              r: "22",
+              stroke: "#0f172a",
+              strokeWidth: "3",
+              children: /* @__PURE__ */ jsx21("title", { children: entity.name })
             }
           ),
-          /* @__PURE__ */ jsx21(
-            ResourceTable,
+          orbitNodes.map((item) => /* @__PURE__ */ jsx21(
+            "g",
             {
-              rows: data.nodes,
-              getRowKey: (row) => row.id,
-              onRowClick: setSelectedNode,
-              empty: /* @__PURE__ */ jsx21(
-                EmptyState,
-                {
-                  icon: Brain2,
-                  title: loading ? "Loading brain" : "No brain nodes",
-                  description: loading ? "Fetching brain nodes for the active namespace." : "Knowledge and working-state nodes will appear here."
-                }
-              ),
-              columns: [
-                {
-                  id: "node",
-                  header: "Node",
-                  className: "max-w-[360px]",
-                  render: (row) => /* @__PURE__ */ jsxs13("div", { className: "min-w-0", children: [
-                    /* @__PURE__ */ jsx21("div", { className: "truncate font-medium", children: row.name }),
-                    /* @__PURE__ */ jsx21("div", { className: "truncate text-xs text-muted-foreground", children: row.content || "-" })
-                  ] })
-                },
-                {
-                  id: "layer",
-                  header: "Layer",
-                  render: (row) => /* @__PURE__ */ jsx21(LayerBadge, { layer: row.layer })
-                },
-                {
-                  id: "kind",
-                  header: "Kind",
-                  render: (row) => formatLabel(row.kind)
-                },
-                {
-                  id: "status",
-                  header: "Status",
-                  render: (row) => /* @__PURE__ */ jsx21(StatusBadge, { status: row.status })
-                },
+              className: "cursor-pointer",
+              onClick: () => onSelectNode(item.node),
+              children: /* @__PURE__ */ jsx21(
+                "circle",
                 {
-                  id: "agent",
-                  header: "Agent",
-                  className: "max-w-[160px] truncate font-mono text-xs",
-                  render: (row) => row.agentId ?? "-"
+                  cx: item.x,
+                  cy: item.y,
+                  fill: nodeColor(item.node),
+                  r: item.tone === "similar" ? 9 : 11,
+                  stroke: item.tone === "similar" ? "#0ea5e9" : "#ffffff",
+                  strokeWidth: "2",
+                  children: /* @__PURE__ */ jsx21("title", { children: `${item.node.name} \xB7 ${formatLabel(item.node.kind)} \xB7 ${item.label}` })
                 }
-              ]
-            }
-          )
-        ] })
+              )
+            },
+            item.id
+          ))
+        ]
       }
-    )
-  ] });
+    ),
+    /* @__PURE__ */ jsxs13("div", { className: "border-t p-4 lg:border-l lg:border-t-0", children: [
+      /* @__PURE__ */ jsxs13("div", { className: "flex flex-wrap items-center gap-2", children: [
+        /* @__PURE__ */ jsx21(LayerBadge, { layer: entity.layer }),
+        /* @__PURE__ */ jsx21(StatusBadge, { status: entity.status }),
+        /* @__PURE__ */ jsx21(Badge, { variant: "outline", children: "Entity" })
+      ] }),
+      /* @__PURE__ */ jsx21("h3", { className: "mt-3 truncate text-base font-semibold", children: entity.name }),
+      /* @__PURE__ */ jsx21("p", { className: "mt-2 line-clamp-4 text-sm leading-6 text-muted-foreground", children: entity.content || "-" }),
+      /* @__PURE__ */ jsxs13("div", { className: "mt-4 grid grid-cols-2 gap-2 text-xs", children: [
+        /* @__PURE__ */ jsxs13("div", { className: "rounded-md border bg-muted/20 p-3", children: [
+          /* @__PURE__ */ jsx21("div", { className: "text-muted-foreground", children: "Explicit" }),
+          /* @__PURE__ */ jsx21("div", { className: "mt-1 text-lg font-semibold", children: related.length })
+        ] }),
+        /* @__PURE__ */ jsxs13("div", { className: "rounded-md border bg-muted/20 p-3", children: [
+          /* @__PURE__ */ jsx21("div", { className: "text-muted-foreground", children: "Semantic" }),
+          /* @__PURE__ */ jsx21("div", { className: "mt-1 text-lg font-semibold", children: similar.length })
+        ] })
+      ] }),
+      /* @__PURE__ */ jsxs13("div", { className: "mt-4 space-y-2", children: [
+        /* @__PURE__ */ jsx21("div", { className: "text-xs font-medium text-muted-foreground", children: "Knowledge orbit" }),
+        groupBrainRelationsByKind(related).slice(0, 5).map((group) => /* @__PURE__ */ jsxs13(
+          "div",
+          {
+            className: "flex items-center justify-between gap-3 text-xs",
+            children: [
+              /* @__PURE__ */ jsx21("span", { className: "truncate", children: group.label }),
+              /* @__PURE__ */ jsx21(Badge, { variant: "secondary", children: group.items.length })
+            ]
+          },
+          group.id
+        )),
+        related.length === 0 && similar.length === 0 ? /* @__PURE__ */ jsx21("p", { className: "text-xs leading-5 text-muted-foreground", children: "Select an entity with relations or embeddings to see its neighborhood." }) : null
+      ] })
+    ] })
+  ] }) });
 }
 function BrainMap({
   clusters,
@@ -2256,6 +2737,7 @@ function BrainMap({
   loading,
   nodes,
   onSelectNode,
+  similar,
   selectedNodeId
 }) {
   const nodeById = React7.useMemo(
@@ -2308,12 +2790,15 @@ function BrainMap({
           const source = nodeById.get(edge.sourceNodeId);
           const target = nodeById.get(edge.targetNodeId);
           if (!source || !target) return null;
+          const isSelectedEdge = Boolean(
+            selectedNodeId && (edge.sourceNodeId === selectedNodeId || edge.targetNodeId === selectedNodeId)
+          );
           return /* @__PURE__ */ jsx21(
             "line",
             {
               stroke: edge.type === "contradicts" ? "#dc2626" : "#64748b",
-              strokeOpacity: "0.32",
-              strokeWidth: edge.type === "supports" ? 2 : 1.3,
+              strokeOpacity: isSelectedEdge ? "0.75" : "0.32",
+              strokeWidth: isSelectedEdge ? 2.6 : edge.type === "supports" ? 2 : 1.3,
               x1: source.x * 1e3,
               x2: target.x * 1e3,
               y1: source.y * 600,
@@ -2322,6 +2807,25 @@ function BrainMap({
             edge.id
           );
         }),
+        selectedNodeId ? similar.map((item) => {
+          const source = nodeById.get(selectedNodeId);
+          const target = nodeById.get(item.node.id);
+          if (!source || !target) return null;
+          return /* @__PURE__ */ jsx21(
+            "line",
+            {
+              stroke: "#0ea5e9",
+              strokeDasharray: "5 6",
+              strokeOpacity: "0.42",
+              strokeWidth: "1.8",
+              x1: source.x * 1e3,
+              x2: target.x * 1e3,
+              y1: source.y * 600,
+              y2: target.y * 600
+            },
+            `similar-${item.node.id}`
+          );
+        }) : null,
         nodes.map((node) => {
           const isSelected = node.id === selectedNodeId;
           return /* @__PURE__ */ jsx21(
@@ -2349,7 +2853,19 @@ function BrainMap({
     }
   ) });
 }
-function BrainNodeInspector({ node }) {
+function BrainNodeInspector({
+  match,
+  node,
+  onSelectNode,
+  related,
+  similar
+}) {
+  const [tab, setTab] = React7.useState("overview");
+  const isEntity = node.kind === "entity";
+  const tabs = isEntity ? ["overview", "knowledge", "work", "relations", "similar", "evidence", "json"] : ["overview", "relations", "similar", "evidence", "json"];
+  React7.useEffect(() => {
+    setTab("overview");
+  }, [node.id]);
   return /* @__PURE__ */ jsxs13("div", { className: "space-y-3", children: [
     /* @__PURE__ */ jsxs13("div", { className: "rounded-lg border bg-background p-4", children: [
       /* @__PURE__ */ jsxs13("div", { className: "flex flex-wrap items-center gap-2", children: [
@@ -2359,24 +2875,161 @@ function BrainNodeInspector({ node }) {
       ] }),
       /* @__PURE__ */ jsx21("h3", { className: "mt-3 text-base font-semibold", children: node.name }),
       /* @__PURE__ */ jsx21("p", { className: "mt-2 text-sm leading-6 text-muted-foreground", children: node.content || "-" }),
-      /* @__PURE__ */ jsxs13("dl", { className: "mt-4 grid gap-2 text-xs", children: [
-        /* @__PURE__ */ jsx21(InspectorRow, { label: "Agent", value: node.agentId }),
-        /* @__PURE__ */ jsx21(InspectorRow, { label: "Thread", value: node.threadId }),
-        /* @__PURE__ */ jsx21(InspectorRow, { label: "Memory space", value: node.memorySpaceId }),
-        /* @__PURE__ */ jsx21(InspectorRow, { label: "Checkpoint", value: node.checkpointId }),
-        /* @__PURE__ */ jsx21(InspectorRow, { label: "Source field", value: node.sourceField }),
-        /* @__PURE__ */ jsx21(
-          InspectorRow,
-          {
-            label: "Updated",
-            value: formatDateTime(node.updatedAt)
-          }
-        )
-      ] })
+      /* @__PURE__ */ jsx21(MatchBadges, { match })
     ] }),
-    /* @__PURE__ */ jsx21(JsonPanel, { title: "Node JSON", value: node, minHeight: 300 })
+    /* @__PURE__ */ jsx21("div", { className: "inline-flex w-full overflow-hidden rounded-md border bg-background", children: tabs.map((item) => /* @__PURE__ */ jsx21(
+      "button",
+      {
+        className: cn(
+          "min-w-0 flex-1 px-2 py-2 text-xs transition-colors",
+          tab === item ? "bg-muted font-medium text-foreground" : "text-muted-foreground hover:bg-muted/60"
+        ),
+        onClick: () => setTab(item),
+        type: "button",
+        children: formatLabel(item)
+      },
+      item
+    )) }),
+    tab === "overview" ? /* @__PURE__ */ jsx21(BrainOverview, { node }) : null,
+    tab === "knowledge" ? /* @__PURE__ */ jsx21(
+      RelationGroupsPanel,
+      {
+        emptyDescription: "Durable decisions, facts, preferences, and constraints related to this entity will appear here.",
+        emptyTitle: "No durable knowledge",
+        groups: getKnowledgeRelationGroups(related),
+        onSelectNode
+      }
+    ) : null,
+    tab === "work" ? /* @__PURE__ */ jsx21(
+      RelationGroupsPanel,
+      {
+        emptyDescription: "Tasks, risks, open questions, and current-state nodes related to this entity will appear here.",
+        emptyTitle: "No current work",
+        groups: getWorkRelationGroups(related),
+        onSelectNode
+      }
+    ) : null,
+    tab === "relations" ? /* @__PURE__ */ jsx21(
+      RelationGroupsPanel,
+      {
+        emptyDescription: "Explicit relation edges will appear here when this node is connected to other concepts.",
+        emptyTitle: "No explicit relations",
+        groups: groupBrainRelationsByKind(related),
+        onSelectNode
+      }
+    ) : null,
+    tab === "similar" ? /* @__PURE__ */ jsx21(SimilarPanel, { onSelectNode, similar }) : null,
+    tab === "evidence" ? /* @__PURE__ */ jsx21(EvidencePanel, { node }) : null,
+    tab === "json" ? /* @__PURE__ */ jsx21(JsonPanel, { title: "Node JSON", value: node, minHeight: 300 }) : null
   ] });
 }
+function BrainOverview({ node }) {
+  return /* @__PURE__ */ jsx21("div", { className: "rounded-lg border bg-background p-4", children: /* @__PURE__ */ jsxs13("dl", { className: "grid gap-2 text-xs", children: [
+    /* @__PURE__ */ jsx21(InspectorRow, { label: "Agent", value: node.agentId }),
+    /* @__PURE__ */ jsx21(InspectorRow, { label: "Thread", value: node.threadId }),
+    /* @__PURE__ */ jsx21(InspectorRow, { label: "Memory space", value: node.memorySpaceId }),
+    /* @__PURE__ */ jsx21(InspectorRow, { label: "Checkpoint", value: node.checkpointId }),
+    /* @__PURE__ */ jsx21(InspectorRow, { label: "Source field", value: node.sourceField }),
+    /* @__PURE__ */ jsx21(InspectorRow, { label: "Confidence", value: formatNullableNumber(node.confidence) }),
+    /* @__PURE__ */ jsx21(InspectorRow, { label: "Updated", value: formatDateTime(node.updatedAt) })
+  ] }) });
+}
+function RelationGroupsPanel({
+  emptyDescription,
+  emptyTitle,
+  groups,
+  onSelectNode
+}) {
+  if (groups.length === 0) {
+    return /* @__PURE__ */ jsx21(
+      EmptyState,
+      {
+        icon: GitBranch,
+        title: emptyTitle,
+        description: emptyDescription
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx21("div", { className: "space-y-3", children: groups.map((group) => /* @__PURE__ */ jsxs13("section", { className: "rounded-lg border bg-background", children: [
+    /* @__PURE__ */ jsx21("div", { className: "border-b px-3 py-2", children: /* @__PURE__ */ jsxs13("div", { className: "flex items-center justify-between gap-3", children: [
+      /* @__PURE__ */ jsxs13("div", { className: "min-w-0", children: [
+        /* @__PURE__ */ jsx21("h4", { className: "truncate text-sm font-medium", children: group.label }),
+        /* @__PURE__ */ jsx21("p", { className: "mt-0.5 line-clamp-2 text-xs text-muted-foreground", children: group.description })
+      ] }),
+      /* @__PURE__ */ jsx21(Badge, { variant: "secondary", children: group.items.length })
+    ] }) }),
+    /* @__PURE__ */ jsx21("div", { className: "divide-y", children: group.items.map((item) => /* @__PURE__ */ jsxs13(
+      "button",
+      {
+        className: "w-full p-3 text-left transition-colors hover:bg-muted/40",
+        onClick: () => onSelectNode(item.node),
+        type: "button",
+        children: [
+          /* @__PURE__ */ jsxs13("div", { className: "flex flex-wrap items-center gap-2", children: [
+            /* @__PURE__ */ jsx21(Badge, { variant: "outline", children: formatLabel(item.edge.type) }),
+            /* @__PURE__ */ jsx21(Badge, { variant: "secondary", children: item.direction === "out" ? "Outgoing" : "Incoming" }),
+            /* @__PURE__ */ jsx21(LayerBadge, { layer: item.node.layer })
+          ] }),
+          /* @__PURE__ */ jsx21("div", { className: "mt-2 text-sm font-medium", children: item.node.name }),
+          /* @__PURE__ */ jsx21("p", { className: "mt-1 line-clamp-3 text-xs leading-5 text-muted-foreground", children: item.node.content || "-" })
+        ]
+      },
+      item.edge.id
+    )) })
+  ] }, group.id)) });
+}
+function SimilarPanel({
+  onSelectNode,
+  similar
+}) {
+  if (similar.length === 0) {
+    return /* @__PURE__ */ jsx21(
+      EmptyState,
+      {
+        icon: Sparkles,
+        title: "No semantic neighbors",
+        description: "Similar nodes appear here when the selected node has an embedding."
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx21("div", { className: "space-y-2", children: similar.map((item) => /* @__PURE__ */ jsxs13(
+    "button",
+    {
+      className: "w-full rounded-lg border bg-background p-3 text-left transition-colors hover:bg-muted/40",
+      onClick: () => onSelectNode(item.node),
+      type: "button",
+      children: [
+        /* @__PURE__ */ jsxs13("div", { className: "flex flex-wrap items-center gap-2", children: [
+          /* @__PURE__ */ jsx21(Badge, { variant: "secondary", children: formatSimilarityScore(item.similarity) }),
+          /* @__PURE__ */ jsx21(LayerBadge, { layer: item.node.layer }),
+          /* @__PURE__ */ jsx21(Badge, { variant: "outline", children: formatLabel(item.node.kind) })
+        ] }),
+        /* @__PURE__ */ jsx21("div", { className: "mt-2 text-sm font-medium", children: item.node.name }),
+        /* @__PURE__ */ jsx21("p", { className: "mt-1 line-clamp-3 text-xs leading-5 text-muted-foreground", children: item.node.content || "-" })
+      ]
+    },
+    item.node.id
+  )) });
+}
+function EvidencePanel({ node }) {
+  const sourceMessageIds = Array.isArray(node.sourceMessageIds) ? node.sourceMessageIds : [];
+  return /* @__PURE__ */ jsxs13("div", { className: "rounded-lg border bg-background p-4", children: [
+    /* @__PURE__ */ jsxs13("dl", { className: "grid gap-2 text-xs", children: [
+      /* @__PURE__ */ jsx21(InspectorRow, { label: "Source", value: node.sourceType }),
+      /* @__PURE__ */ jsx21(InspectorRow, { label: "Source ID", value: node.sourceId }),
+      /* @__PURE__ */ jsx21(InspectorRow, { label: "Thread", value: node.threadId }),
+      /* @__PURE__ */ jsx21(InspectorRow, { label: "Checkpoint", value: node.checkpointId })
+    ] }),
+    /* @__PURE__ */ jsxs13("div", { className: "mt-4", children: [
+      /* @__PURE__ */ jsx21("div", { className: "text-xs font-medium text-muted-foreground", children: "Source messages" }),
+      /* @__PURE__ */ jsx21("div", { className: "mt-2 flex flex-wrap gap-1", children: sourceMessageIds.length ? sourceMessageIds.map((id) => /* @__PURE__ */ jsx21(Badge, { className: "max-w-full truncate", variant: "outline", children: id }, id)) : /* @__PURE__ */ jsx21("span", { className: "text-xs text-muted-foreground", children: "-" }) })
+    ] })
+  ] });
+}
+function MatchBadges({ match }) {
+  if (!match?.reasons.length) return null;
+  return /* @__PURE__ */ jsx21("div", { className: "mt-2 flex flex-wrap gap-1", children: match.reasons.slice(0, 4).map((reason) => /* @__PURE__ */ jsx21(Badge, { className: "text-[10px]", variant: "outline", children: reason }, reason)) });
+}
 function InspectorRow({
   label,
   value
@@ -2405,6 +3058,12 @@ function formatDateTime(value) {
   if (Number.isNaN(date.getTime())) return value;
   return date.toLocaleString();
 }
+function formatNullableNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value.toFixed(2) : "-";
+}
+function formatSimilarityScore(value) {
+  return Number.isFinite(value) ? `Similarity ${value.toFixed(2)}` : "-";
+}
 function emptyBrainResponse() {
   return {
     nodes: [],
@@ -2416,6 +3075,14 @@ function emptyBrainResponse() {
       byKind: {},
       byStatus: {}
     },
+    matches: {},
+    related: [],
+    similar: [],
+    semantic: {
+      requested: false,
+      available: false,
+      error: null
+    },
     pageInfo: {
       limit: 0,
       offset: 0,
@@ -4806,8 +5473,11 @@ function useCopilotzAdmin(options = {}) {
 export {
   ADMIN_GROUP_LABELS,
   ADMIN_GROUP_ORDER,
+  BRAIN_RELATION_GROUP_DEFINITIONS,
+  BRAIN_VIEW_LABELS,
   CopilotzAdmin,
   EMPTY_USAGE_TOTALS,
+  ENTITY_FOCUS_RELATION_TYPES,
   EmptyState,
   FilterBar,
   InspectorPanel,
@@ -4836,11 +5506,16 @@ export {
   formatNumber,
   formatPercent,
   formatUsageBucket,
+  getBrainViewBaseFilters,
+  getKnowledgeRelationGroups,
   getUsageDimensionLabel,
   getUsageGroupLabel,
   getUsageMetricLabel,
   getUsageRange,
   getUsageTotalValue,
+  getWorkRelationGroups,
+  groupBrainRelationsByKind,
+  isEntityBrainView,
   mergeAdminConfig,
   overviewModule,
   participantsModule,