@anchrd/intel-ui 0.8.8 → 0.9.0

package/src/{knowledge/knowledge.tsx → nodes/nodes.tsx}

@@ -1,23 +1,29 @@
-import type { KnowledgeNode } from "@anchrd/intel-contract";
+import type { Node } from "@anchrd/intel-contract";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { useNavigate, useRouterState } from "@tanstack/react-router";
 import { Download, History, Paperclip } from "lucide-react";
 import { lazy, Suspense, useState } from "react";
+import { AgentAvatar } from "@/agent/agent-avatar/agent-avatar.tsx";
 import { ActionSlot } from "@/app/action-slot/action-slot.tsx";
 import { ViewToggle } from "@/app/view-toggle/view-toggle.tsx";
 import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@/components/ui/tooltip";
 import { FolderContents } from "@/folder-contents/folder-contents.tsx";
 import { GraphPane } from "@/graph-pane/graph-pane.tsx";
-import { KnowledgeTablePanel } from "@/knowledge-table/knowledge-table.tsx";
+import { NodeTablePanel } from "@/node-table/node-table.tsx";
 import { useIntelRouterContext } from "@/router/router-context.ts";
 import { graphViewFrom, selectedFrom } from "@/router/selection-search.ts";
 import { TitleRow } from "@/title-row/title-row.tsx";
 
-const KnowledgeEditor = lazy(async () => ({
-  default: (await import("@/knowledge-editor/knowledge-editor.tsx")).KnowledgeEditor,
+const NodeEditor = lazy(async () => ({
+  default: (await import("@/node-editor/node-editor.tsx")).NodeEditor,
+}));
+// Lazy for the same reason the editor is: assistant-ui and its stream client are the agent page's
+// alone, and every other screen would otherwise pay for them on first paint.
+const AgentPanel = lazy(async () => ({
+  default: (await import("@/agent/agent.tsx")).AgentPanel,
 }));
 
-export function Knowledge() {
+export function Nodes() {
   const { data, i18n } = useIntelRouterContext();
   const queryClient = useQueryClient();
   const navigate = useNavigate();
@@ -32,8 +38,8 @@ export function Knowledge() {
   const selectedId = selection.id;
   const [versionsOpen, setVersionsOpen] = useState(false);
   const document = useQuery({
-    queryKey: ["knowledge", selectedId],
-    queryFn: () => data.getKnowledge(selectedId ?? ""),
+    queryKey: ["node", selectedId],
+    queryFn: () => data.getNode(selectedId ?? ""),
     enabled: Boolean(selectedId),
   });
   const selected = document.data?.node ?? null;
@@ -47,7 +53,7 @@ export function Knowledge() {
   });
   return (
     <div className="flex h-full min-h-0 flex-col">
-      {/* The screen owns the one action that belongs to Knowledge as a whole. Creating things is
+      {/* The screen owns the one action that belongs to the tree as a whole. Creating things is
           the tree's, in the sidebar, at the place a new thing is meant to go.
 
           ⚠️ Mounted only where there is a graph to switch to. A switch on a document would point at
@@ -67,21 +73,21 @@ export function Knowledge() {
             query={relations}
             select={(node) =>
               void navigate({
-                to: node.kind === "flow" ? "/flows" : "/knowledge",
+                to: node.kind === "flow" ? "/flows" : "/nodes",
                 search: { select: node.id },
               })
             }
           />
         ) : !selectedId ? (
           <div className="grid flex-1 place-items-center p-8 text-center text-sm text-muted-foreground">
-            {i18n.t("knowledge.select")}
+            {i18n.t("node.select")}
           </div>
         ) : document.isPending ? (
           <p className="p-6 text-sm text-muted-foreground">{i18n.t("common.loading")}</p>
         ) : document.isError || !selected ? (
           <div role="alert" className="grid flex-1 place-items-center p-8 text-center text-sm">
             <div className="space-y-3">
-              <p className="text-destructive">{i18n.t("knowledge.loadFailed")}</p>
+              <p className="text-destructive">{i18n.t("node.loadFailed")}</p>
               <button
                 type="button"
                 onClick={() => void document.refetch()}
@@ -106,7 +112,8 @@ export function Knowledge() {
             <TitleRow
               title={selected.title}
               description={selected.description}
-              target={{ type: "knowledge", node: selected }}
+              target={{ type: "node", node: selected }}
+              leading={selected.kind === "agent" ? <AgentAvatar title={selected.title} /> : null}
             >
               {selected.kind !== "folder" && (
                 <TooltipProvider delayDuration={300}>
@@ -114,13 +121,13 @@ export function Knowledge() {
                     <TooltipTrigger
                       type="button"
                       onClick={() => setVersionsOpen((value) => !value)}
-                      aria-label={i18n.t("knowledge.versions")}
+                      aria-label={i18n.t("node.versions")}
                       aria-expanded={versionsOpen}
                       className="inline-flex size-8 items-center justify-center rounded-md border bg-background outline-none hover:bg-accent focus-visible:ring-2 focus-visible:ring-ring"
                     >
                       <History aria-hidden="true" className="size-4" />
                     </TooltipTrigger>
-                    <TooltipContent>{i18n.t("knowledge.versions")}</TooltipContent>
+                    <TooltipContent>{i18n.t("node.versions")}</TooltipContent>
                   </Tooltip>
                 </TooltipProvider>
               )}
@@ -130,7 +137,7 @@ export function Knowledge() {
                 query={relations}
                 select={(node) =>
                   void navigate({
-                    to: node.kind === "flow" ? "/flows" : "/knowledge",
+                    to: node.kind === "flow" ? "/flows" : "/nodes",
                     search: { select: node.id },
                   })
                 }
@@ -140,20 +147,30 @@ export function Knowledge() {
             ) : selected.kind === "attachment" ? (
               <AttachmentPanel node={selected} />
             ) : selected.kind === "table" ? (
-              <KnowledgeTablePanel node={selected} />
+              <NodeTablePanel node={selected} />
+            ) : selected.kind === "agent" ? (
+              // ⚠️ Before the editor branch, and never reaching it: an agent's version body is a
+              // definition document, not prose, and BlockNote would try to open JSON as a text.
+              <Suspense
+                fallback={
+                  <p className="p-6 text-sm text-muted-foreground">{i18n.t("common.loading")}</p>
+                }
+              >
+                <AgentPanel key={selected.id} node={selected} />
+              </Suspense>
             ) : document.data ? (
               <Suspense
                 fallback={
                   <p className="p-6 text-sm text-muted-foreground">{i18n.t("common.loading")}</p>
                 }
               >
-                <KnowledgeEditor
+                <NodeEditor
                   key={document.data.node.id}
                   data={data}
                   document={document.data}
                   i18n={i18n}
                   onSaved={(saved) => {
-                    queryClient.setQueryData(["knowledge", selected.id], saved);
+                    queryClient.setQueryData(["node", selected.id], saved);
                   }}
                 />
               </Suspense>
@@ -168,10 +185,10 @@ export function Knowledge() {
   );
 }
 
-function AttachmentPanel({ node }: { node: KnowledgeNode }) {
+function AttachmentPanel({ node }: { node: Node }) {
   const { data, i18n } = useIntelRouterContext();
   const download = useMutation({
-    mutationFn: () => data.getKnowledgeAttachment(node.id),
+    mutationFn: () => data.getNodeAttachment(node.id),
     onSuccess: (blob) => {
       const url = URL.createObjectURL(blob);
       const anchor = document.createElement("a");
@@ -188,7 +205,7 @@ function AttachmentPanel({ node }: { node: KnowledgeNode }) {
       <div className="max-w-md rounded-xl border bg-background p-8 text-center shadow-sm">
         <Paperclip aria-hidden="true" className="mx-auto size-10 text-primary" />
         <h3 className="mt-4 font-semibold">{node.title}</h3>
-        <p className="mt-2 text-sm text-muted-foreground">{i18n.t("knowledge.attachmentHelp")}</p>
+        <p className="mt-2 text-sm text-muted-foreground">{i18n.t("node.attachmentHelp")}</p>
         <button
           type="button"
           onClick={() => download.mutate()}
@@ -196,11 +213,11 @@ function AttachmentPanel({ node }: { node: KnowledgeNode }) {
           className="mt-5 inline-flex items-center gap-2 rounded-md bg-primary px-4 py-2 text-sm font-medium text-primary-foreground outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:opacity-50"
         >
           <Download aria-hidden="true" className="size-4" />
-          {download.isPending ? i18n.t("common.loading") : i18n.t("knowledge.download")}
+          {download.isPending ? i18n.t("common.loading") : i18n.t("node.download")}
         </button>
         {download.isError ? (
           <p role="alert" className="mt-4 text-sm text-destructive">
-            {i18n.t("knowledge.downloadFailed")}
+            {i18n.t("node.downloadFailed")}
           </p>
         ) : null}
       </div>
@@ -211,16 +228,16 @@ function AttachmentPanel({ node }: { node: KnowledgeNode }) {
 function VersionHistory({ nodeId, close }: { nodeId: string; close(): void }) {
   const { data, i18n } = useIntelRouterContext();
   const versions = useQuery({
-    queryKey: ["knowledge-versions", nodeId],
-    queryFn: () => data.listKnowledgeVersions(nodeId),
+    queryKey: ["node-versions", nodeId],
+    queryFn: () => data.listNodeVersions(nodeId),
   });
   return (
     <aside
-      aria-label={i18n.t("knowledge.versions")}
+      aria-label={i18n.t("node.versions")}
       className="absolute bottom-0 right-0 top-0 z-10 w-80 overflow-y-auto border-l bg-card p-5 shadow-xl"
     >
       <div className="flex items-start justify-between gap-4">
-        <h3 className="font-semibold">{i18n.t("knowledge.versions")}</h3>
+        <h3 className="font-semibold">{i18n.t("node.versions")}</h3>
         <button
           type="button"
           onClick={close}
@@ -235,14 +252,14 @@ function VersionHistory({ nodeId, close }: { nodeId: string; close(): void }) {
       ) : null}
       {versions.isError ? (
         <p role="alert" className="mt-4 text-sm text-destructive">
-          {i18n.t("knowledge.operationFailed")}
+          {i18n.t("node.operationFailed")}
         </p>
       ) : null}
       <ol className="mt-4 space-y-3">
         {versions.data?.items.map((version) => (
           <li key={version.id} className="rounded-md border p-3 text-sm">
             <span className="font-medium">
-              {i18n.t("knowledge.version", { sequence: version.sequence })}
+              {i18n.t("node.version", { sequence: version.sequence })}
             </span>
             <time className="mt-1 block text-xs text-muted-foreground" dateTime={version.createdAt}>
               {new Intl.DateTimeFormat(i18n.locale, {

package/src/resource-menu/resource-menu.tsx

@@ -1,9 +1,10 @@
 import type {
   Flow,
   FlowValidation,
-  KnowledgeNode,
+  Node,
+  NodeKind,
   ResourceVerb,
-  UnreadableKnowledge,
+  UnreadableNodes,
 } from "@anchrd/intel-contract";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { useNavigate, useRouterState } from "@tanstack/react-router";
@@ -11,6 +12,7 @@ import {
   Archive,
   CornerLeftUp,
   Ellipsis,
+  FolderDown,
   Link2,
   Pencil,
   Share2,
@@ -46,9 +48,7 @@ import { selectedFrom } from "@/router/selection-search.ts";
  * is shared through the folder it is filed in rather than on its own (ADR-0004 §2). A greyed-out row
  * still promises something is there.
  */
-export type ResourceTarget =
-  | { type: "knowledge"; node: KnowledgeNode }
-  | { type: "flow"; flow: Flow };
+export type ResourceTarget = { type: "node"; node: Node } | { type: "flow"; flow: Flow };
 
 // The same thing as a tree row, because that is what a move works on: a row with a place in the
 // shared tree. The two shapes are the same record seen from two screens, so this is a re-labelling
@@ -57,26 +57,41 @@ function entryOf(target: ResourceTarget): TreeEntry {
   return target.type === "flow"
     ? flowEntry(target.flow)
     : {
-        type: "knowledge",
+        type: "node",
         id: target.node.id,
         title: target.node.title,
         kind: target.node.kind,
-        // Ein Menü verschiebt eine Zeile; ob sie sich aufklappen lässt, spielt dabei keine Rolle.
+        // A menu moves a row; whether it can be expanded plays no part in that.
         openable: false,
         node: target.node,
       };
 }
 
 function idOf(target: ResourceTarget): string {
-  return target.type === "knowledge" ? target.node.id : target.flow.id;
+  return target.type === "node" ? target.node.id : target.flow.id;
 }
 
 function titleOf(target: ResourceTarget): string {
-  return target.type === "knowledge" ? target.node.title : target.flow.title;
+  return target.type === "node" ? target.node.title : target.flow.title;
 }
 
 function parentOfTarget(target: ResourceTarget): string | null {
-  return target.type === "knowledge" ? target.node.parentId : target.flow.parentId;
+  return target.type === "node" ? target.node.parentId : target.flow.parentId;
+}
+
+/**
+ * Which sentence explains a verb, for THIS kind of thing.
+ *
+ * ⚠️ "Run" does not mean the same thing twice. On a folder it grants starting the flows filed in
+ * it; on an agent it grants using the agent — through its chat, its schedules and its MCP address.
+ * Until #143 there was one sentence for both, and on an agent it named flows that have nothing to
+ * do with the grant being made. A key per kind, falling back to the general one, so a kind that
+ * needs no special wording needs no entry.
+ */
+export function verbHintKey(verb: ResourceVerb, kind: NodeKind): string {
+  return verb === "execute" && kind === "agent"
+    ? "node.verbHint.execute.agent"
+    : `node.verbHint.${verb}`;
 }
 
 // ⚠️ The same reading `moveErrorKey` does for a move, for the changes this menu makes. A conflict is
@@ -91,7 +106,7 @@ export function resourceErrorKey(error: unknown): string {
     case "update_conflict":
     case "flow_update_conflict":
       return "resource.conflict";
-    case "knowledge_forbidden":
+    case "node_forbidden":
     case "flow_edit_forbidden":
       return "resource.forbidden";
     default:
@@ -141,7 +156,7 @@ export function ResourceMenu({
 
   const id = idOf(target);
   const title = titleOf(target);
-  const node = target.type === "knowledge" ? target.node : null;
+  const node = target.type === "node" ? target.node : null;
   // A folder holds things; it is not itself retrieved, and nothing is written into it that could
   // link anywhere. Both entries are therefore absent on one rather than offered and inert.
   const retrievable = node !== null && node.kind !== "folder";
@@ -155,10 +170,10 @@ export function ResourceMenu({
     await Promise.all([
       queryClient.invalidateQueries({ queryKey: ["tree", parentOfTarget(target)] }),
       queryClient.invalidateQueries({
-        queryKey: target.type === "flow" ? ["flow", id] : ["knowledge", id],
+        queryKey: target.type === "flow" ? ["flow", id] : ["node", id],
       }),
       queryClient.invalidateQueries({
-        queryKey: [target.type === "flow" ? "flows" : "knowledge-graph"],
+        queryKey: [target.type === "flow" ? "flows" : "node-graph"],
       }),
       queryClient.invalidateQueries({ queryKey: ["relation-graph"] }),
     ]);
@@ -177,7 +192,7 @@ export function ResourceMenu({
         });
         return;
       }
-      await data.updateKnowledge({
+      await data.updateNode({
         nodeId: target.node.id,
         baseUpdatedAt: target.node.updatedAt,
         title: next,
@@ -204,7 +219,7 @@ export function ResourceMenu({
         });
         return;
       }
-      await data.archiveKnowledge({
+      await data.archiveNode({
         nodeId: target.node.id,
         baseUpdatedAt: target.node.updatedAt,
         archived: true,
@@ -216,16 +231,36 @@ export function ResourceMenu({
       // The row is gone from the tree. If it was also what the screen was showing, the screen has
       // nothing left to show either.
       //
-      // ⚠️ It drops the selection where it stands rather than always landing on /knowledge: a flow
+      // ⚠️ It drops the selection where it stands rather than always landing on /nodes: a flow
       // archived from the flow screen would otherwise throw the reader onto another screen for no
-      // reason they could see. A flow reached through the shared tree stays on /knowledge, which is
+      // reason they could see. A flow reached through the shared tree stays on /nodes, which is
       // where it was being read.
       if (selected === id) {
-        await navigate({ to: pathname === "/flows" ? "/flows" : "/knowledge", search: {} });
+        await navigate({ to: pathname === "/flows" ? "/flows" : "/nodes", search: {} });
       }
     },
   });
 
+  // The export as the user takes it home (#136): the streamed zip as a saved file, named after the
+  // thing itself. The same object-URL dance the attachment download does, because it is the same
+  // gesture — the data provider streams, the browser saves.
+  const exportBundle = useMutation({
+    mutationFn: async () =>
+      target.type === "flow"
+        ? await data.exportFlowBundle(target.flow.id)
+        : await data.exportNodeBundle(target.node.id),
+    onSuccess: (blob) => {
+      const url = URL.createObjectURL(blob);
+      const anchor = document.createElement("a");
+      anchor.href = url;
+      anchor.download = `${title}.zip`;
+      document.body.append(anchor);
+      anchor.click();
+      anchor.remove();
+      setTimeout(() => URL.revokeObjectURL(url), 0);
+    },
+  });
+
   const failure = rename.isError
     ? null // the rename dialog words its own refusal, beside the field that caused it
     : archive.isError
@@ -255,6 +290,13 @@ export function ResourceMenu({
             <CornerLeftUp aria-hidden="true" />
             {i18n.t("tree.move.action")}
           </DropdownMenuItem>
+          {/* Every kind exports: a folder takes its subtree along, everything else is a bundle of
+              one (#136). The entry sits with rename and move because it acts on the whole thing,
+              not on its content. */}
+          <DropdownMenuItem onSelect={() => exportBundle.mutate()}>
+            <FolderDown aria-hidden="true" />
+            {i18n.t("resource.export")}
+          </DropdownMenuItem>
           {/* Only a flow can be run, so only a flow can be asked whether it would. Rarely needed —
               which is why it is in the menu and not in the title line (#72). */}
           {node === null ? (
@@ -267,7 +309,7 @@ export function ResourceMenu({
           {linkable ? (
             <DropdownMenuItem onSelect={() => setLinksOpen(true)}>
               <Link2 aria-hidden="true" />
-              {i18n.t("knowledge.links")}
+              {i18n.t("node.links")}
             </DropdownMenuItem>
           ) : null}
           {/* A flow has no share of its own: it is reached through the folder it is filed in, and a
@@ -276,7 +318,7 @@ export function ResourceMenu({
           {node ? (
             <DropdownMenuItem onSelect={() => setSharing(true)}>
               <Share2 aria-hidden="true" />
-              {i18n.t("knowledge.share")}
+              {i18n.t("node.share")}
             </DropdownMenuItem>
           ) : null}
           {/* A flow is archived like a document (#109). It keeps its versions and its runs; what it
@@ -297,6 +339,9 @@ export function ResourceMenu({
       {failure !== undefined && failure !== null ? (
         <MenuFailure>{i18n.t(resourceErrorKey(failure))}</MenuFailure>
       ) : null}
+      {/* Its own sentence, not `resourceErrorKey`'s: nothing was changed, something failed to
+          arrive, and "the change was not saved" would send the reader looking for a change. */}
+      {exportBundle.isError ? <MenuFailure>{i18n.t("resource.exportFailed")}</MenuFailure> : null}
       {/* ⚠️ A move has four refusals of its own and they are told apart by `moveErrorKey`, not by
           `resourceErrorKey`: "that is not a folder" and "that would be a loop" have no equivalent
           among the changes above, and one shared sentence would leave the reader guessing. */}
@@ -341,8 +386,8 @@ export function ResourceMenu({
           submit={(next) => rename.mutate(next)}
         />
       ) : null}
-      {sharing && node ? <ShareKnowledge node={node} close={() => setSharing(false)} /> : null}
-      {linksOpen && node ? <KnowledgeLinks node={node} close={() => setLinksOpen(false)} /> : null}
+      {sharing && node ? <SharePanel node={node} close={() => setSharing(false)} /> : null}
+      {linksOpen && node ? <NodeLinksPanel node={node} close={() => setLinksOpen(false)} /> : null}
     </>
   );
 }
@@ -423,27 +468,27 @@ function RenameDialog({
  * the same predicate as every other read. A relationship reaching into a part of the tree they may
  * not enter is absent rather than shown without a name.
  */
-function KnowledgeLinks({ node, close }: { node: KnowledgeNode; close(): void }) {
+function NodeLinksPanel({ node, close }: { node: Node; close(): void }) {
   const { data, i18n } = useIntelRouterContext();
   const navigate = useNavigate();
   const links = useQuery({
-    queryKey: ["knowledge-links", node.id],
-    queryFn: () => data.listKnowledgeLinks(node.id),
+    queryKey: ["node-links", node.id],
+    queryFn: () => data.listNodeLinks(node.id),
   });
   // The dialog needs the names of the documents at the other end, and the graph is the one
   // authorized list of them the UI can ask for without walking the whole tree again. It is asked
   // for here rather than by the screen, because here is where it is read.
-  const knowledgeGraph = useQuery({
-    queryKey: ["knowledge-graph"],
-    queryFn: () => data.getKnowledgeGraph(),
+  const nodeGraph = useQuery({
+    queryKey: ["node-graph"],
+    queryFn: () => data.getNodeGraph(),
   });
   const titles = new Map(
-    (knowledgeGraph.data?.nodes ?? []).map((candidate) => [candidate.id, candidate.title]),
+    (nodeGraph.data?.nodes ?? []).map((candidate) => [candidate.id, candidate.title]),
   );
 
   return (
-    <Modal title={i18n.t("knowledge.links")} close={close}>
-      <p className="mb-4 text-sm text-muted-foreground">{i18n.t("knowledge.linksHelp")}</p>
+    <Modal title={i18n.t("node.links")} close={close}>
+      <p className="mb-4 text-sm text-muted-foreground">{i18n.t("node.linksHelp")}</p>
       <ul className="max-h-72 space-y-2 overflow-y-auto">
         {links.data?.items.map((link) => {
           const outgoing = link.sourceNodeId === node.id;
@@ -454,7 +499,7 @@ function KnowledgeLinks({ node, close }: { node: KnowledgeNode; close(): void })
                 type="button"
                 onClick={() => {
                   close();
-                  void navigate({ to: "/knowledge", search: { select: otherId } });
+                  void navigate({ to: "/nodes", search: { select: otherId } });
                 }}
                 className="flex w-full items-center gap-3 rounded-md border p-3 text-left outline-none hover:bg-muted focus-visible:ring-2 focus-visible:ring-ring"
               >
@@ -463,7 +508,7 @@ function KnowledgeLinks({ node, close }: { node: KnowledgeNode; close(): void })
                     {titles.get(otherId) ?? otherId}
                   </span>
                   <span className="text-xs text-muted-foreground">
-                    {outgoing ? i18n.t("knowledge.linkOutgoing") : i18n.t("knowledge.linkIncoming")}
+                    {outgoing ? i18n.t("node.linkOutgoing") : i18n.t("node.linkIncoming")}
                   </span>
                 </span>
               </button>
@@ -471,7 +516,7 @@ function KnowledgeLinks({ node, close }: { node: KnowledgeNode; close(): void })
           );
         })}
         {links.data?.items.length === 0 && (
-          <li className="text-sm text-muted-foreground">{i18n.t("knowledge.noLinks")}</li>
+          <li className="text-sm text-muted-foreground">{i18n.t("node.noLinks")}</li>
         )}
       </ul>
     </Modal>
@@ -482,28 +527,28 @@ function KnowledgeLinks({ node, close }: { node: KnowledgeNode; close(): void })
 // flows, which is where a permission decision belongs (ADR-0004 §2). Which verbs it offers is the
 // server's answer, not this component's: `execute` never appears on a document, because a document
 // has nothing to run.
-function ShareKnowledge({ node, close }: { node: KnowledgeNode; close(): void }) {
+function SharePanel({ node, close }: { node: Node; close(): void }) {
   const { data, i18n } = useIntelRouterContext();
   const queryClient = useQueryClient();
   const [email, setEmail] = useState("");
   const [verbs, setVerbs] = useState<ResourceVerb[]>(["read"]);
   // What the grant just made does not cover. It survives the form being cleared, because it is the
   // answer to the question the user just asked and they need a moment to read it.
-  const [unreadable, setUnreadable] = useState<UnreadableKnowledge | null>(null);
+  const [unreadable, setUnreadable] = useState<UnreadableNodes | null>(null);
   const grants = useQuery({
-    queryKey: ["knowledge-grants", node.id],
-    queryFn: () => data.listKnowledgeGrants(node.id),
+    queryKey: ["node-grants", node.id],
+    queryFn: () => data.listGrants(node.id),
   });
   const share = useMutation({
     // One request per verb, because one grant is one verb. The keys differ so a retry of the whole
     // form replays each verb on its own rather than collapsing them into one.
     mutationFn: async () => {
-      let last: UnreadableKnowledge | null = null;
+      let last: UnreadableNodes | null = null;
       for (const verb of verbs) {
         // The last verb's answer is the one kept: every request describes the access in force after
         // it, so the newest is the only one still true.
         last = (
-          await data.shareKnowledge({
+          await data.shareNode({
             resourceId: node.id,
             principal: { type: "email", email },
             verb,
@@ -523,46 +568,44 @@ function ShareKnowledge({ node, close }: { node: KnowledgeNode; close(): void })
     // before, and the user would read a permission picture that is not the one in force. Of all the
     // things to be silently wrong about, access is the worst.
     onSettled: async () => {
-      await queryClient.invalidateQueries({ queryKey: ["knowledge-grants", node.id] });
+      await queryClient.invalidateQueries({ queryKey: ["node-grants", node.id] });
     },
   });
   const revoke = useMutation({
     mutationFn: (grantId: string) =>
-      data.revokeKnowledgeGrant({
+      data.revokeGrant({
         resourceId: node.id,
         grantId,
         idempotencyKey: crypto.randomUUID(),
       }),
     onSettled: async () => {
-      await queryClient.invalidateQueries({ queryKey: ["knowledge-grants", node.id] });
+      await queryClient.invalidateQueries({ queryKey: ["node-grants", node.id] });
     },
   });
 
   return (
-    <Modal title={i18n.t("knowledge.share")} close={close}>
+    <Modal title={i18n.t("node.share")} close={close}>
       {(share.isError || revoke.isError || grants.isError) && (
         <p role="alert" className="mb-4 text-sm text-destructive">
-          {i18n.t("knowledge.shareFailed")}
+          {i18n.t("node.shareFailed")}
         </p>
       )}
       {/* ⚠️ `status`, not `alert`, and beside the grant rather than in place of it: the access was
-          given. A knowledge reference across the folder edge is a possible failure, not a way around
+          given. A node reference across the folder edge is a possible failure, not a way around
           permissions, so nothing here blocks anything (ADR-0004 §4). */}
       {unreadable && (unreadable.titles.length > 0 || unreadable.hidden > 0) && (
         <div role="status" className="mb-4 rounded-md border bg-muted p-3 text-sm">
           {unreadable.titles.length > 0 ? (
             <p>
-              {i18n.t("knowledge.shareUnreadable", { titles: unreadable.titles.join(", ") })}
+              {i18n.t("node.shareUnreadable", { titles: unreadable.titles.join(", ") })}
               {unreadable.hidden > 0
-                ? ` ${i18n.t("knowledge.shareUnreadableMore", { count: unreadable.hidden })}`
+                ? ` ${i18n.t("node.shareUnreadableMore", { count: unreadable.hidden })}`
                 : ""}
             </p>
           ) : (
-            <p>{i18n.t("knowledge.shareUnreadableHidden", { count: unreadable.hidden })}</p>
+            <p>{i18n.t("node.shareUnreadableHidden", { count: unreadable.hidden })}</p>
           )}
-          <p className="mt-1 text-xs text-muted-foreground">
-            {i18n.t("knowledge.shareUnreadableHint")}
-          </p>
+          <p className="mt-1 text-xs text-muted-foreground">{i18n.t("node.shareUnreadableHint")}</p>
         </div>
       )}
       <ul className="mb-5 max-h-44 space-y-2 overflow-y-auto">
@@ -576,15 +619,15 @@ function ShareKnowledge({ node, close }: { node: KnowledgeNode; close(): void })
                 ? grant.principal.email
                 : grant.principal.type === "user"
                   ? grant.principal.id
-                  : i18n.t("knowledge.organization")}
+                  : i18n.t("node.organization")}
               <span className="ml-2 text-xs text-muted-foreground">
-                {i18n.t(`knowledge.verb.${grant.verb}`)}
+                {i18n.t(`node.verb.${grant.verb}`)}
               </span>
             </span>
             <button
               type="button"
               onClick={() => revoke.mutate(grant.id)}
-              aria-label={i18n.t("knowledge.revokeShare")}
+              aria-label={i18n.t("node.revokeShare")}
               className="rounded-md p-2 text-destructive outline-none hover:bg-muted focus-visible:ring-2 focus-visible:ring-ring"
             >
               <Trash2 aria-hidden="true" className="size-4" />
@@ -592,7 +635,7 @@ function ShareKnowledge({ node, close }: { node: KnowledgeNode; close(): void })
           </li>
         ))}
         {grants.data?.items.length === 0 && (
-          <li className="text-sm text-muted-foreground">{i18n.t("knowledge.noGrants")}</li>
+          <li className="text-sm text-muted-foreground">{i18n.t("node.noGrants")}</li>
         )}
       </ul>
       <form
@@ -603,7 +646,7 @@ function ShareKnowledge({ node, close }: { node: KnowledgeNode; close(): void })
         className="space-y-4 border-t pt-5"
       >
         <label className="block text-sm font-medium">
-          {i18n.t("knowledge.email")}
+          {i18n.t("node.email")}
           <input
             type="email"
             required
@@ -613,7 +656,7 @@ function ShareKnowledge({ node, close }: { node: KnowledgeNode; close(): void })
           />
         </label>
         <fieldset className="space-y-2">
-          <legend className="text-sm font-medium">{i18n.t("knowledge.verbs")}</legend>
+          <legend className="text-sm font-medium">{i18n.t("node.verbs")}</legend>
           {(grants.data?.applicableVerbs ?? []).map((verb) => (
             <label key={verb} className="flex items-center gap-2 text-sm">
               <input
@@ -628,9 +671,9 @@ function ShareKnowledge({ node, close }: { node: KnowledgeNode; close(): void })
                 }
                 className="size-4 rounded border outline-none focus-visible:ring-2 focus-visible:ring-ring"
               />
-              <span>{i18n.t(`knowledge.verb.${verb}`)}</span>
+              <span>{i18n.t(`node.verb.${verb}`)}</span>
               <span className="text-xs text-muted-foreground">
-                {i18n.t(`knowledge.verbHint.${verb}`)}
+                {i18n.t(verbHintKey(verb, node.kind))}
               </span>
             </label>
           ))}
@@ -640,7 +683,7 @@ function ShareKnowledge({ node, close }: { node: KnowledgeNode; close(): void })
           disabled={share.isPending || verbs.length === 0}
           className="w-full rounded-md bg-primary px-4 py-2 text-sm font-medium text-primary-foreground outline-none hover:bg-primary/90 focus-visible:ring-2 focus-visible:ring-ring disabled:opacity-50"
         >
-          {i18n.t("knowledge.shareAction")}
+          {i18n.t("node.shareAction")}
         </button>
       </form>
     </Modal>