@anchrd/intel-ui 0.18.0 → 0.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anchrd/intel-ui",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {
@@ -33,27 +33,20 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@anchrd/intel-contract": "^0.12.0",
-    "@assistant-ui/react": "^0.15.4",
-    "@assistant-ui/react-ai-sdk": "^1.4.4",
+    "@anchrd/intel-contract": "^0.14.0",
     "@blocknote/core": "^0.52.1",
     "@blocknote/react": "^0.52.1",
     "@blocknote/shadcn": "^0.52.1",
-    "@dnd-kit/core": "^6.3.1",
-    "@dnd-kit/sortable": "^10.0.0",
-    "@dnd-kit/utilities": "^3.2.2",
     "@react-sigma/core": "^5.0.6",
     "@tailwindcss/vite": "^4.3.3",
     "@tanstack/react-query": "^5.101.4",
     "@tanstack/react-router": "^1.170.18",
-    "@tanstack/react-table": "^9.1.0",
     "@vitejs/plugin-react": "^6.0.4",
     "@xyflow/react": "^12.11.2",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
     "colorjs.io": "^0.7.1",
-    "croner": "^10.0.1",
     "fflate": "^0.8.3",
     "graphology": "^0.26.0",
     "lucide-react": "^1.25.0",

package/src/app/app-tree/app-tree.tsx

@@ -1,21 +1,16 @@
+import type { NodeKind } from "@anchrd/intel-contract/node";
 import { useMutation, useQueries, useQueryClient } from "@tanstack/react-query";
 import { useNavigate, useRouterState } from "@tanstack/react-router";
-import { zipSync } from "fflate";
 import {
   ChevronRight,
   CornerLeftUp,
   FileArchive,
-  FileText,
-  Folder,
   FolderOpen,
   FolderUp,
   Plus,
-  Table,
   Upload,
-  Workflow,
 } from "lucide-react";
 import { useRef, useState } from "react";
-import { defaultModel } from "@/agent/agent-models/agent-models.ts";
 import {
   type MoveDestination,
   moveErrorKey,
@@ -28,6 +23,7 @@ import {
   DropdownMenu,
   DropdownMenuContent,
   DropdownMenuItem,
+  DropdownMenuSeparator,
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
 import {
@@ -39,40 +35,27 @@ import {
 } from "@/components/ui/sidebar";
 import { flowEntry } from "@/data/intel-data-provider/intel-data-provider.ts";
 import type { TreeEntry } from "@/data/intel-data-provider/intel-data-provider.types.ts";
-import { useCapabilities } from "@/hooks/use-capabilities.ts";
 import { useI18n } from "@/i18n/i18n-context.tsx";
+import { type ImportKind, useBundleImport } from "@/import-bundle/import-bundle.tsx";
 import { kindIcons } from "@/kind-icon.ts";
 import { Modal } from "@/modal/modal.tsx";
 import { useIntelRouterContext } from "@/router/router-context.ts";
 import { selectedFrom } from "@/router/selection-search.ts";
 
-type NewKind = "folder" | "document" | "table" | "flow" | "agent";
-// The two ways a bundle arrives (#137): an existing zip, or a picked folder the browser hands over
-// file by file and this component zips before it travels — one wire format, one server door.
-type ImportKind = "importZip" | "importFolder";
+/**
+ * What the plus can MAKE — derived from `NodeKind`, never written out again (#395).
+ *
+ * ⚠️ `attachment` is excluded because an attachment is uploaded rather than created, and `flow` is
+ * added because a flow shares the tree without being a node (ADR-0004 §1). Both are decisions about
+ * this menu; the LIST of node kinds is not, and a copy of it here goes stale in the direction that
+ * already bit us — the parked kinds stood in such a union long after nothing could make one.
+ */
+type NewKind = Exclude<NodeKind, "attachment"> | "flow";
 type Creating = { parentId: string | null; kind: NewKind };
 
 // Attachments are inlined as base64, so the browser holds the file twice while it uploads.
 const MaxUploadBytes = 15_000_000;
 
-// The server refuses anything larger anyway (#137); refusing here saves uploading it first.
-const MaxImportBytes = 64 * 1024 * 1024;
-
-// A picked directory as the zip the import endpoint reads. `webkitRelativePath` carries the folder
-// structure, with the picked folder itself as the first segment — kept, so the folder lands as a
-// folder rather than spilling its contents into the target.
-async function zipOfDirectory(files: readonly File[]): Promise<Blob> {
-  const entries: Record<string, Uint8Array> = {};
-  let total = 0;
-  for (const file of files) {
-    const path = file.webkitRelativePath || file.name;
-    total += file.size;
-    if (total > MaxImportBytes) throw new Error("Import exceeds the 64 MB limit");
-    entries[path] = new Uint8Array(await file.arrayBuffer());
-  }
-  return new Blob([zipSync(entries).slice().buffer], { type: "application/zip" });
-}
-
 async function fileBase64(file: File): Promise<string> {
   if (file.size > MaxUploadBytes) throw new Error("Attachment exceeds the 15 MB upload limit");
   return await new Promise((resolve, reject) => {
@@ -115,9 +98,6 @@ export function AppTree() {
   const [creating, setCreating] = useState<Creating | null>(null);
   const [uploadTo, setUploadTo] = useState<string | null>(null);
   const uploadInput = useRef<HTMLInputElement>(null);
-  const [importTo, setImportTo] = useState<string | null>(null);
-  const importZipInput = useRef<HTMLInputElement>(null);
-  const importFolderInput = useRef<HTMLInputElement>(null);
   const [dragged, setDragged] = useState<TreeEntry | null>(null);
   const draggedRef = useRef<TreeEntry | null>(null);
   // Which target the pointer is over: `undefined` for none, `null` for the root strip, an id for a
@@ -131,6 +111,14 @@ export function AppTree() {
       if (destination.id !== null) toggle({ id: destination.id, type: "folder" }, true);
     },
   });
+  // ⚠️ The root's import, and only the root's. A folder imports through its own three-dot menu
+  // (#346); the tree keeps this one because the top level has no resource whose menu could hold it.
+  const bundleImport = useBundleImport({
+    where: i18n.t("tree.move.root"),
+    onImported: (parentId) => {
+      if (parentId !== null) toggle({ id: parentId, type: "folder" }, true);
+    },
+  });
 
   const location = useRouterState({
     select: (state) => ({
@@ -207,26 +195,6 @@ export function AppTree() {
         });
         return { area: "/flows" as const, id: flow.id, parentId, collection: "flows" as const };
       }
-      // ⚠️ Its own endpoint, not `createNodes`: an agent is created WITH its first definition
-      // version, because a definition names the model and there is no agent without one. The
-      // create dialog does not ask for it — `defaultModel()` answers, and the profile changes it.
-      if (kind === "agent") {
-        const created = await data.createAgent({
-          parentId,
-          title,
-          description: null,
-          // A new agent has no tools: giving it any is a choice made in the profile, out of what
-          // this person reaches in the portal (D30).
-          definition: { references: [], schedules: [], model: defaultModel(), tools: null },
-          idempotencyKey: crypto.randomUUID(),
-        });
-        return {
-          area: "/nodes" as const,
-          id: created.node.id,
-          parentId,
-          collection: "node-graph" as const,
-        };
-      }
       const node = await data.createNodes({
         parentId,
         kind,
@@ -301,26 +269,6 @@ export function AppTree() {
     },
   });
 
-  // One import, one request, one answer (#137): the server creates the whole subtree or nothing,
-  // so this mutation never has a partial state to clean up after — unlike the attachment upload
-  // above, whose two steps can strand a node.
-  const importBundle = useMutation({
-    mutationFn: async ({ parentId, zip }: { parentId: string | null; zip: Blob }) => {
-      if (zip.size > MaxImportBytes) throw new Error("Import exceeds the 64 MB limit");
-      const result = await data.importNodeBundle({
-        nodeId: parentId,
-        zip,
-        idempotencyKey: crypto.randomUUID(),
-      });
-      return { parentId, result };
-    },
-    onSuccess: async (imported) => {
-      // A bundle can carry flows, so the flow collections go stale alongside the node ones.
-      await reveal(imported.parentId, "node-graph");
-      await queryClient.invalidateQueries({ queryKey: ["flows"] });
-    },
-  });
-
   // What a drop on this target would do. `undefined` means nothing is being dragged, so the target
   // is not a target at all.
   function verdictFor(
@@ -376,11 +324,6 @@ export function AppTree() {
     uploadInput.current?.click();
   }
 
-  function startImport(parentId: string | null, kind: ImportKind) {
-    setImportTo(parentId);
-    (kind === "importZip" ? importZipInput : importFolderInput).current?.click();
-  }
-
   function renderLevel(parent: Level, ancestors: ReadonlySet<string>, label?: string) {
     const level = levelFor(parent);
     if (!level || level.isPending) {
@@ -566,7 +509,6 @@ export function AppTree() {
             label={i18n.t("tree.add", { title: entry.title })}
             onSelect={(kind) => {
               if (kind === "upload") startUpload(target);
-              else if (kind === "importZip" || kind === "importFolder") startImport(target, kind);
               else setCreating({ parentId: target, kind });
             }}
           />
@@ -621,9 +563,9 @@ export function AppTree() {
       {/* The tree is the navigation and carries no heading of its own (ADR-0004); the list is
           named for assistive technology instead. */}
       {renderLevel({ id: null, type: "folder" }, new Set(), i18n.t("tree.label"))}
-      {create.isError || upload.isError || importBundle.isError ? (
+      {create.isError || upload.isError || bundleImport.isError ? (
         <p role="alert" className="px-2 py-1.5 text-sm text-destructive">
-          {importBundle.isError
+          {bundleImport.isError
             ? i18n.t("tree.importFailed")
             : upload.isError
               ? i18n.t("tree.uploadFailed")
@@ -651,7 +593,8 @@ export function AppTree() {
             variant="row"
             onSelect={(kind) => {
               if (kind === "upload") startUpload(null);
-              else if (kind === "importZip" || kind === "importFolder") startImport(null, kind);
+              else if (kind === "importZip" || kind === "importFolder")
+                bundleImport.start(null, kind);
               else setCreating({ parentId: null, kind });
             }}
           />
@@ -668,38 +611,7 @@ export function AppTree() {
           event.currentTarget.value = "";
         }}
       />
-      <input
-        ref={importZipInput}
-        type="file"
-        accept=".zip,application/zip"
-        className="sr-only"
-        aria-label={i18n.t("tree.new.importZip")}
-        onChange={(event) => {
-          const file = event.target.files?.[0];
-          if (file) importBundle.mutate({ parentId: importTo, zip: file });
-          event.currentTarget.value = "";
-        }}
-      />
-      {/* `webkitdirectory` is the one way a browser hands over a folder; React does not know the
-          attribute, so it is spread past the type checker rather than invented as a prop. */}
-      <input
-        ref={importFolderInput}
-        type="file"
-        multiple
-        {...({ webkitdirectory: "" } as object)}
-        className="sr-only"
-        aria-label={i18n.t("tree.new.importFolder")}
-        onChange={(event) => {
-          const files = Array.from(event.target.files ?? []);
-          const parentId = importTo;
-          if (files.length > 0) {
-            void zipOfDirectory(files)
-              .then((zip) => importBundle.mutate({ parentId, zip }))
-              .catch(() => importBundle.mutate({ parentId, zip: new Blob([]) }));
-          }
-          event.currentTarget.value = "";
-        }}
-      />
+      {bundleImport.inputs}
       {creating ? (
         <Modal title={i18n.t(`tree.new.${creating.kind}`)} close={() => setCreating(null)}>
           <CreateForm
@@ -719,40 +631,27 @@ export function AppTree() {
 //
 // `row` is the root's form: a full-width row that says what it does, because the root has no title
 // beside which a bare icon would mean anything.
-function AddMenu({
-  label,
-  variant = "icon",
-  onSelect,
-}: {
-  label: string;
-  variant?: "icon" | "row";
-  onSelect(kind: NewKind | "upload" | ImportKind): void;
-}) {
+//
+// ⚠️ The two variants do not offer the same things, and the type says so rather than a comment: only
+// the root can emit an import (#346), because only the root has no three-dot menu to hold one. A
+// single wide signature would leave the folder row with a branch nothing can reach.
+type AddMenuProps =
+  | { label: string; variant: "row"; onSelect(kind: NewKind | "upload" | ImportKind): void }
+  | { label: string; variant?: "icon"; onSelect(kind: NewKind | "upload"): void };
+
+function AddMenu(props: AddMenuProps) {
+  const { label, onSelect } = props;
+  const variant = props.variant ?? "icon";
   const i18n = useI18n();
-  // Whether this deployment runs an agent runtime (#190). Until the answer arrives the item is
-  // absent rather than provisional: a menu entry that vanished after being seen was a lie, one that
-  // appears a beat late was merely loading.
-  const agentRuntime = useCapabilities().data?.agentRuntime === true;
-  const items: Array<{
-    kind: NewKind | "upload" | ImportKind;
-    labelKey: string;
-    Icon: typeof Plus;
-  }> = [
-    { kind: "folder", labelKey: "tree.new.folder", Icon: Folder },
-    { kind: "document", labelKey: "tree.new.document", Icon: FileText },
-    { kind: "table", labelKey: "tree.new.table", Icon: Table },
-    { kind: "upload", labelKey: "tree.new.upload", Icon: Upload },
-    { kind: "flow", labelKey: "tree.new.flow", Icon: Workflow },
-    // ⚠️ The same icon the tree draws for an agent row, taken from the one kind-icon map rather
-    // than named again here — a second `Bot` beside it is how the two start disagreeing.
-    // Offered only where a runtime exists to run what would be created (#190).
-    ...(agentRuntime
-      ? [{ kind: "agent" as const, labelKey: "tree.new.agent", Icon: kindIcons.agent }]
-      : []),
-    // The bundle round trip's second half (#137): what the export produced, or a plain folder from
-    // the machine, lands here as a new subtree.
-    { kind: "importZip", labelKey: "tree.new.importZip", Icon: FileArchive },
-    { kind: "importFolder", labelKey: "tree.new.importFolder", Icon: FolderUp },
+  // ⚠️ Three groups, and the separators are the answer to what the plus promises: four kinds are
+  // made here, an upload brings one thing in from the machine, an import brings a whole subtree
+  // (#346). The icons come from the one kind-icon map rather than being named again — a second
+  // `Folder` beside it is how the tree row and this menu start disagreeing.
+  const kinds: Array<{ kind: NewKind; labelKey: string; Icon: typeof Plus }> = [
+    { kind: "folder", labelKey: "tree.new.folder", Icon: kindIcons.folder },
+    { kind: "document", labelKey: "tree.new.document", Icon: kindIcons.document },
+    { kind: "table", labelKey: "tree.new.table", Icon: kindIcons.table },
+    { kind: "flow", labelKey: "tree.new.flow", Icon: kindIcons.flow },
   ];
   return (
     <DropdownMenu>
@@ -768,12 +667,34 @@ function AddMenu({
         {variant === "row" ? <span className="truncate">{label}</span> : null}
       </DropdownMenuTrigger>
       <DropdownMenuContent align="start" className="w-44">
-        {items.map((item) => (
+        {kinds.map((item) => (
           <DropdownMenuItem key={item.kind} onSelect={() => onSelect(item.kind)}>
             <item.Icon aria-hidden="true" />
             {i18n.t(item.labelKey)}
           </DropdownMenuItem>
         ))}
+        <DropdownMenuSeparator />
+        <DropdownMenuItem onSelect={() => onSelect("upload")}>
+          <Upload aria-hidden="true" />
+          {i18n.t("tree.new.upload")}
+        </DropdownMenuItem>
+        {/* ⚠️ The root only, and that is not an omission at a folder row: a folder imports through
+            its own three-dot menu, beside the export it is the other half of (#136/#137). The root
+            has no resource and therefore no such menu, so dropping it here would put the top level
+            out of reach of an import altogether (#346). */}
+        {props.variant === "row" ? (
+          <>
+            <DropdownMenuSeparator />
+            <DropdownMenuItem onSelect={() => props.onSelect("importZip")}>
+              <FileArchive aria-hidden="true" />
+              {i18n.t("tree.new.importZip")}
+            </DropdownMenuItem>
+            <DropdownMenuItem onSelect={() => props.onSelect("importFolder")}>
+              <FolderUp aria-hidden="true" />
+              {i18n.t("tree.new.importFolder")}
+            </DropdownMenuItem>
+          </>
+        ) : null}
       </DropdownMenuContent>
     </DropdownMenu>
   );

package/src/app/header-search/header-search.tsx

@@ -1,4 +1,5 @@
-import type { Flow, ToolCapability } from "@anchrd/intel-contract";
+import type { Flow } from "@anchrd/intel-contract/flow";
+import type { ToolCapability } from "@anchrd/intel-contract/tool";
 import { useQuery } from "@tanstack/react-query";
 import { useNavigate } from "@tanstack/react-router";
 import { FileText, Search, Workflow, Wrench } from "lucide-react";

package/src/app/reindex-dialog/reindex-dialog.tsx

@@ -0,0 +1,79 @@
+import { useMutation } from "@tanstack/react-query";
+import { Button } from "@/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import { useI18n } from "@/i18n/i18n-context.tsx";
+import { useIntelRouterContext } from "@/router/router-context.ts";
+
+/**
+ * Rebuilding the search index, asked for before it happens (#416).
+ *
+ * ⚠️ Two clicks, not one, and the reason is not that it is dangerous — nothing is lost, the index is
+ * derived from D1 and R2 and can always be built again. It is that it is EXPENSIVE and invisible:
+ * every node is read and embedded again, which costs money and minutes, and the screen looks exactly
+ * the same afterwards. A one-click button next to "Preferences" invites a second press when the
+ * first one seems to have done nothing.
+ *
+ * ⚠️ It reports what was QUEUED, never "done". The answer comes back the moment the work is handed
+ * to the queue, and the index catches up behind it — writing "finished" here would be a sentence
+ * about something this screen cannot see. The number is the honest part: it says how much was
+ * accepted, so a repeat press can be compared against it.
+ *
+ * The dialog is opened from outside, like the settings one: its trigger is a `DropdownMenuItem`, and
+ * Radix unmounts the menu content in the same frame the item is chosen.
+ */
+interface ReindexDialogProps {
+  open: boolean;
+  onOpenChange(open: boolean): void;
+}
+
+export function ReindexDialog({ open, onOpenChange }: ReindexDialogProps) {
+  const i18n = useI18n();
+  const { data } = useIntelRouterContext();
+  const reindex = useMutation({ mutationFn: () => data.reindexNodes() });
+
+  return (
+    <Dialog
+      open={open}
+      onOpenChange={(next) => {
+        // Closing forgets the last answer, so re-opening never shows a count from an earlier run as
+        // if it were this one's.
+        if (!next) reindex.reset();
+        onOpenChange(next);
+      }}
+    >
+      <DialogContent className="sm:max-w-md">
+        <DialogHeader>
+          <DialogTitle>{i18n.t("reindex.title")}</DialogTitle>
+          <DialogDescription>{i18n.t("reindex.description")}</DialogDescription>
+        </DialogHeader>
+        {reindex.isSuccess ? (
+          <p role="status" className="text-sm">
+            {i18n.t("reindex.queued", { count: reindex.data.queued })}
+          </p>
+        ) : null}
+        {reindex.isError ? (
+          <p role="alert" className="text-sm text-destructive">
+            {i18n.t("reindex.failed")}
+          </p>
+        ) : null}
+        <DialogFooter>
+          <Button variant="outline" onClick={() => onOpenChange(false)}>
+            {i18n.t(reindex.isSuccess ? "reindex.close" : "reindex.cancel")}
+          </Button>
+          {reindex.isSuccess ? null : (
+            <Button disabled={reindex.isPending} onClick={() => reindex.mutate()}>
+              {i18n.t(reindex.isPending ? "reindex.running" : "reindex.confirm")}
+            </Button>
+          )}
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+}

package/src/app/settings-dialog/settings-dialog.tsx

@@ -14,16 +14,19 @@ import {
 } from "@/components/ui/select";
 import { useI18n, useLanguage } from "@/i18n/i18n-context.tsx";
 import { languageName } from "@/i18n/i18n-languages/i18n-languages.ts";
-import { SectionHint } from "@/section-hint/section-hint.tsx";
 import { type ThemeChoice, ThemeChoices } from "@/theme/theme.ts";
 import { useTheme } from "@/theme/theme-context.tsx";
-import { TimezoneCombobox } from "@/timezone/timezone-combobox/timezone-combobox.tsx";
-import { useTimezoneSelection } from "@/timezone/timezone-context.tsx";
 
-// The settings that belong to the person rather than to the installation: language, appearance and
-// timezone. All three are client state — they live in localStorage, not in the Intel HTTP surface —
-// so they do not belong on a screen with a save button. A choice applies at once; a dialog that
-// previews and only commits on "Save" would carry three states too many for three dropdowns.
+// The settings that belong to the person rather than to the installation: language and appearance.
+// Both are client state — they live in localStorage, not in the Intel HTTP surface — so they do not
+// belong on a screen with a save button. A choice applies at once; a dialog that previews and only
+// commits on "Save" would carry two states too many for two dropdowns.
+//
+// ⚠️ There was a third, the reader's timezone, and it left with the Agents (#388). It was a
+// suggestion for a schedule and the lens its calendar was read through (#228); with both gone
+// nothing read the value, and a preference that changes nothing on screen is worse than none —
+// it invites the reader to set it and then contradicts them. Reading times in a chosen zone is a
+// feature, and it would come back as one.
 //
 // The dialog is opened from outside (the user footer holds the state), because its trigger is a
 // DropdownMenuItem: Radix unmounts the menu content when an item is chosen and would take a dialog
@@ -37,7 +40,6 @@ export function SettingsDialog({ open, onOpenChange }: SettingsDialogProps) {
   const i18n = useI18n();
   const language = useLanguage();
   const theme = useTheme();
-  const timezone = useTimezoneSelection();
 
   return (
     <Dialog open={open} onOpenChange={onOpenChange}>
@@ -93,30 +95,6 @@ export function SettingsDialog({ open, onOpenChange }: SettingsDialogProps) {
               </Select>
             </div>
           ) : null}
-          {timezone ? (
-            <div className="grid gap-2">
-              {/* ⚠️ Behind the ⓘ (#249), and the SAME component the agent profile uses — three
-                  lines of prose under a dropdown explained something once and then pushed the
-                  dialog apart on every open. The `sr-only` copy below is not a duplicate: Radix
-                  puts a tooltip's content in the accessibility tree only while it is open, so the
-                  field would silently lose the description `aria-describedby` points at. */}
-              <div className="flex items-center gap-1.5">
-                <label className="text-sm font-medium" htmlFor="settings-timezone">
-                  {i18n.t("settings.timezone")}
-                </label>
-                <SectionHint hint={i18n.t("settings.timezoneHint")} />
-              </div>
-              <TimezoneCombobox
-                id="settings-timezone"
-                value={timezone.current}
-                onChange={timezone.select}
-                describedBy="settings-timezone-hint"
-              />
-              <p id="settings-timezone-hint" className="sr-only">
-                {i18n.t("settings.timezoneHint")}
-              </p>
-            </div>
-          ) : null}
         </div>
       </DialogContent>
     </Dialog>

package/src/app/user-footer/user-footer.tsx

@@ -4,6 +4,7 @@ import {
   Archive as ArchiveIcon,
   ChevronsUpDown,
   LogOut,
+  RefreshCw,
   Settings,
   User,
   Wrench,
@@ -20,6 +21,7 @@ import { SidebarMenu, SidebarMenuItem } from "@/components/ui/sidebar";
 import { loginPath } from "@/data/intel-data-provider/intel-data-provider.ts";
 import { useI18n } from "@/i18n/i18n-context.tsx";
 import { useIntelRouterContext } from "@/router/router-context.ts";
+import { ReindexDialog } from "../reindex-dialog/reindex-dialog.tsx";
 import { SettingsDialog } from "../settings-dialog/settings-dialog.tsx";
 
 /**
@@ -41,6 +43,7 @@ export function UserFooter() {
   // The state lives here, not in the dialog: its trigger is a DropdownMenuItem, and Radix unmounts
   // the menu content when an item is chosen — a dialog nested in there would go with it.
   const [settingsOpen, setSettingsOpen] = useState(false);
+  const [reindexOpen, setReindexOpen] = useState(false);
   const session = useQuery({ queryKey: ["session"], queryFn: () => data.getSession() });
   const logout = useMutation({
     mutationFn: () => data.logout(),
@@ -103,6 +106,20 @@ export function UserFooter() {
               <Settings aria-hidden="true" />
               {i18n.t("settings.title")}
             </DropdownMenuItem>
+            {/* ⚠️ Drawn only for an administrator, and that is a DRAWING decision — `POST
+                /nodes/reindex` asks Gate for `intel/admin` itself and would refuse this row's press
+                just the same (#416). Hiding it is not the check; it is not offering everybody a
+                door they cannot open. Its own separator, because the rows above belong to the
+                person and this one belongs to the installation. */}
+            {session.data?.isAdmin ? (
+              <>
+                <DropdownMenuSeparator />
+                <DropdownMenuItem onSelect={() => setReindexOpen(true)}>
+                  <RefreshCw aria-hidden="true" />
+                  {i18n.t("reindex.title")}
+                </DropdownMenuItem>
+              </>
+            ) : null}
             <DropdownMenuSeparator />
             <DropdownMenuItem
               disabled={logout.isPending}
@@ -116,6 +133,8 @@ export function UserFooter() {
         </DropdownMenu>
         {/* ⚠️ Outside the DropdownMenu on purpose — see the state above. */}
         <SettingsDialog open={settingsOpen} onOpenChange={setSettingsOpen} />
+        {/* ⚠️ Outside the DropdownMenu for the same reason as the settings dialog. */}
+        <ReindexDialog open={reindexOpen} onOpenChange={setReindexOpen} />
       </SidebarMenuItem>
       {/* ⚠️ Outside the menu on purpose. Choosing sign-out closes the popup, so a refusal rendered
           inside it would be gone in the same frame it was written — the one message that must

package/src/archive/archive.tsx

@@ -1,4 +1,5 @@
-import type { Flow, Node } from "@anchrd/intel-contract";
+import type { Flow } from "@anchrd/intel-contract/flow";
+import type { Node } from "@anchrd/intel-contract/node";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { ArchiveRestore } from "lucide-react";
 import { useI18n } from "@/i18n/i18n-context.tsx";