@copilotz/admin 0.9.39 → 0.9.40

package/dist/index.cjs

@@ -313,6 +313,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
     }),
@@ -2023,6 +2031,7 @@ var import_react3 = __toESM(require("react"), 1);
 var import_lucide_react7 = require("lucide-react");
 var import_jsx_runtime21 = require("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_KINDS = [
   "all",
@@ -2060,6 +2069,9 @@ function brainModule() {
 }
 function BrainPage({ context }) {
   const [search, setSearch] = import_react3.default.useState("");
+  const [searchMode, setSearchMode] = import_react3.default.useState(
+    "hybrid"
+  );
   const [layer, setLayer] = import_react3.default.useState("all");
   const [status, setStatus] = import_react3.default.useState(
     "active"
@@ -2072,24 +2084,32 @@ function BrainPage({ context }) {
   const [selectedNode, setSelectedNode] = import_react3.default.useState(
     null
   );
+  const [focusNodeId, setFocusNodeId] = import_react3.default.useState(null);
   const [loading, setLoading] = import_react3.default.useState(false);
   const [error, setError] = import_react3.default.useState(null);
-  const loadBrain = import_react3.default.useCallback(async () => {
+  const loadBrain = import_react3.default.useCallback(async (focusOverride) => {
     setLoading(true);
     setError(null);
+    const effectiveFocusNodeId = focusOverride === void 0 ? focusNodeId : focusOverride;
     try {
       const next = await context.client.getBrain({
         namespace: context.scope.namespace || void 0,
         search: search.trim() || void 0,
+        searchMode,
         layer,
         status,
         kind,
         agentId: agentId.trim() || void 0,
+        focusNodeId: effectiveFocusNodeId || void 0,
+        includeRelated: Boolean(effectiveFocusNodeId),
+        includeSimilar: Boolean(effectiveFocusNodeId),
+        similarLimit: 24,
+        minSimilarity: 0.2,
         limit: 180
       });
       setResponse(next);
       setSelectedNode(
-        (current) => current && next.nodes.some((node) => node.id === current.id) ? current : next.nodes[0] ?? null
+        (current) => effectiveFocusNodeId ? next.nodes.find((node) => node.id === effectiveFocusNodeId) ?? current : current && next.nodes.some((node) => node.id === current.id) ? next.nodes.find((node) => node.id === current.id) ?? current : next.nodes[0] ?? null
       );
     } catch (cause) {
       setError(cause instanceof Error ? cause.message : "Failed to load brain");
@@ -2102,17 +2122,30 @@ function BrainPage({ context }) {
     agentId,
     context.client,
     context.scope.namespace,
+    focusNodeId,
     kind,
     layer,
     search,
+    searchMode,
     status
   ]);
   import_react3.default.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 knowledgeCount = data.stats.byLayer.knowledge ?? 0;
   const workingCount = data.stats.byLayer.working ?? 0;
+  const selectNode = import_react3.default.useCallback((node) => {
+    setSelectedNode(node);
+    setFocusNodeId(node.id);
+  }, []);
+  const runSearch = import_react3.default.useCallback(() => {
+    setFocusNodeId(null);
+    void loadBrain(null);
+  }, [loadBrain]);
   return /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "space-y-4", children: [
     /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
       PageHeader,
@@ -2179,7 +2212,7 @@ function BrainPage({ context }) {
           Button,
           {
             disabled: loading,
-            onClick: () => void loadBrain(),
+            onClick: runSearch,
             size: "sm",
             type: "button",
             children: [
@@ -2192,6 +2225,19 @@ function BrainPage({ context }) {
         searchPlaceholder: "Search brain",
         searchValue: search,
         children: [
+          /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "inline-flex h-8 overflow-hidden rounded-md border bg-background", children: BRAIN_SEARCH_MODES.map((mode) => /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+            "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
+          )) }),
           /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)(
             Select,
             {
@@ -2231,7 +2277,7 @@ function BrainPage({ context }) {
               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
@@ -2240,10 +2286,23 @@ function BrainPage({ context }) {
         ]
       }
     ),
+    data.semantic?.requested && data.semantic.error ? /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("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__ */ (0, import_jsx_runtime21.jsx)(EmptyState, { title: "Unable to load brain", description: error }) : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
       InspectorPanel,
       {
-        side: selectedNode ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(BrainNodeInspector, { node: selectedNode }) : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+        side: selectedNode ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+          BrainNodeInspector,
+          {
+            match: matches[selectedNode.id],
+            node: selectedNode,
+            onSelectNode: selectNode,
+            related,
+            similar
+          }
+        ) : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
           EmptyState,
           {
             icon: import_lucide_react7.Brain,
@@ -2259,7 +2318,8 @@ function BrainPage({ context }) {
               edges: data.edges,
               loading,
               nodes: data.nodes,
-              onSelectNode: setSelectedNode,
+              onSelectNode: selectNode,
+              similar,
               selectedNodeId: selectedNode?.id ?? null
             }
           ),
@@ -2268,7 +2328,7 @@ function BrainPage({ context }) {
             {
               rows: data.nodes,
               getRowKey: (row) => row.id,
-              onRowClick: setSelectedNode,
+              onRowClick: selectNode,
               empty: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
                 EmptyState,
                 {
@@ -2284,7 +2344,8 @@ function BrainPage({ context }) {
                   className: "max-w-[360px]",
                   render: (row) => /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "min-w-0", children: [
                     /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "truncate font-medium", children: row.name }),
-                    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "truncate text-xs text-muted-foreground", children: row.content || "-" })
+                    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "truncate text-xs text-muted-foreground", children: row.content || "-" }),
+                    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(MatchBadges, { match: matches[row.id] })
                   ] })
                 },
                 {
@@ -2322,6 +2383,7 @@ function BrainMap({
   loading,
   nodes,
   onSelectNode,
+  similar,
   selectedNodeId
 }) {
   const nodeById = import_react3.default.useMemo(
@@ -2374,12 +2436,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__ */ (0, import_jsx_runtime21.jsx)(
             "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,
@@ -2388,6 +2453,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__ */ (0, import_jsx_runtime21.jsx)(
+            "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__ */ (0, import_jsx_runtime21.jsx)(
@@ -2415,7 +2499,14 @@ function BrainMap({
     }
   ) });
 }
-function BrainNodeInspector({ node }) {
+function BrainNodeInspector({
+  match,
+  node,
+  onSelectNode,
+  related,
+  similar
+}) {
+  const [tab, setTab] = import_react3.default.useState("overview");
   return /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "space-y-3", children: [
     /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "rounded-lg border bg-background p-4", children: [
       /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "flex flex-wrap items-center gap-2", children: [
@@ -2425,24 +2516,122 @@ function BrainNodeInspector({ node }) {
       ] }),
       /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("h3", { className: "mt-3 text-base font-semibold", children: node.name }),
       /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("p", { className: "mt-2 text-sm leading-6 text-muted-foreground", children: node.content || "-" }),
-      /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("dl", { className: "mt-4 grid gap-2 text-xs", children: [
-        /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Agent", value: node.agentId }),
-        /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Thread", value: node.threadId }),
-        /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Memory space", value: node.memorySpaceId }),
-        /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Checkpoint", value: node.checkpointId }),
-        /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Source field", value: node.sourceField }),
-        /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
-          InspectorRow,
-          {
-            label: "Updated",
-            value: formatDateTime(node.updatedAt)
-          }
-        )
-      ] })
+      /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(MatchBadges, { match })
     ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(JsonPanel, { title: "Node JSON", value: node, minHeight: 300 })
+    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "inline-flex w-full overflow-hidden rounded-md border bg-background", children: ["overview", "related", "similar", "evidence", "json"].map((item) => /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+      "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__ */ (0, import_jsx_runtime21.jsx)(BrainOverview, { node }) : null,
+    tab === "related" ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(RelatedPanel, { onSelectNode, related }) : null,
+    tab === "similar" ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(SimilarPanel, { onSelectNode, similar }) : null,
+    tab === "evidence" ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(EvidencePanel, { node }) : null,
+    tab === "json" ? /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(JsonPanel, { title: "Node JSON", value: node, minHeight: 300 }) : null
   ] });
 }
+function BrainOverview({ node }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "rounded-lg border bg-background p-4", children: /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("dl", { className: "grid gap-2 text-xs", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Agent", value: node.agentId }),
+    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Thread", value: node.threadId }),
+    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Memory space", value: node.memorySpaceId }),
+    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Checkpoint", value: node.checkpointId }),
+    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Source field", value: node.sourceField }),
+    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Confidence", value: formatNullableNumber(node.confidence) }),
+    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Updated", value: formatDateTime(node.updatedAt) })
+  ] }) });
+}
+function RelatedPanel({
+  onSelectNode,
+  related
+}) {
+  if (related.length === 0) {
+    return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+      EmptyState,
+      {
+        icon: import_lucide_react7.GitBranch,
+        title: "No explicit relations",
+        description: "Relation edges will appear here when this node is connected to other concepts."
+      }
+    );
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "space-y-2", children: related.map((item) => /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)(
+    "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__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "flex flex-wrap items-center gap-2", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Badge, { variant: "outline", children: formatLabel(item.edge.type) }),
+          /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Badge, { variant: "secondary", children: item.direction === "out" ? "Outgoing" : "Incoming" })
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "mt-2 text-sm font-medium", children: item.node.name }),
+        /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("p", { className: "mt-1 line-clamp-3 text-xs leading-5 text-muted-foreground", children: item.node.content || "-" })
+      ]
+    },
+    item.edge.id
+  )) });
+}
+function SimilarPanel({
+  onSelectNode,
+  similar
+}) {
+  if (similar.length === 0) {
+    return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+      EmptyState,
+      {
+        icon: import_lucide_react7.Sparkles,
+        title: "No semantic neighbors",
+        description: "Similar nodes appear here when the selected node has an embedding."
+      }
+    );
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "space-y-2", children: similar.map((item) => /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)(
+    "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__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "flex flex-wrap items-center gap-2", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Badge, { variant: "secondary", children: formatSimilarityScore(item.similarity) }),
+          /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(LayerBadge, { layer: item.node.layer }),
+          /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Badge, { variant: "outline", children: formatLabel(item.node.kind) })
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "mt-2 text-sm font-medium", children: item.node.name }),
+        /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("p", { className: "mt-1 line-clamp-3 text-xs leading-5 text-muted-foreground", children: item.node.content || "-" })
+      ]
+    },
+    item.node.id
+  )) });
+}
+function EvidencePanel({ node }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "rounded-lg border bg-background p-4", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("dl", { className: "grid gap-2 text-xs", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Source", value: node.sourceType }),
+      /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Source ID", value: node.sourceId }),
+      /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Thread", value: node.threadId }),
+      /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(InspectorRow, { label: "Checkpoint", value: node.checkpointId })
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "mt-4", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "text-xs font-medium text-muted-foreground", children: "Source messages" }),
+      /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "mt-2 flex flex-wrap gap-1", children: node.sourceMessageIds.length ? node.sourceMessageIds.map((id) => /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Badge, { className: "max-w-full truncate", variant: "outline", children: id }, id)) : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("span", { className: "text-xs text-muted-foreground", children: "-" }) })
+    ] })
+  ] });
+}
+function MatchBadges({ match }) {
+  if (!match?.reasons.length) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "mt-2 flex flex-wrap gap-1", children: match.reasons.slice(0, 4).map((reason) => /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Badge, { className: "text-[10px]", variant: "outline", children: reason }, reason)) });
+}
 function InspectorRow({
   label,
   value
@@ -2471,6 +2660,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: [],
@@ -2482,6 +2677,14 @@ function emptyBrainResponse() {
       byKind: {},
       byStatus: {}
     },
+    matches: {},
+    related: [],
+    similar: [],
+    semantic: {
+      requested: false,
+      available: false,
+      error: null
+    },
     pageInfo: {
       limit: 0,
       offset: 0,