@saadnvd1/agent-os 0.3.585 → 0.3.588

package/components/Chat/Messages.test.ts

@@ -10,6 +10,16 @@ const item = {
   streaming: false,
 } as never;
 
+// The element with this aria-label, anywhere in an unrendered tree.
+function findByLabel(node: unknown, label: string): unknown {
+  if (Array.isArray(node))
+    return node.map((n) => findByLabel(n, label)).find(Boolean);
+  const props = (node as { props?: Record<string, unknown> } | null)?.props;
+  if (!props) return undefined;
+  if (props["aria-label"] === label) return node;
+  return findByLabel(props.children, label);
+}
+
 describe("AssistantMessage quote action", () => {
   it("shows a labelled Quote button next to Copy", () => {
     const html = renderToStaticMarkup(
@@ -22,15 +32,10 @@ describe("AssistantMessage quote action", () => {
 
   it("hands the markdown source to onQuote on click", () => {
     const onQuote = vi.fn();
-    const el = AssistantMessage({ item, onQuote }) as never as {
-      props: { children: unknown[] };
-    };
-    const group = (
-      el.props.children as { props: { children: unknown[] } }[]
-    )[1];
-    const button = group.props.children[1] as {
-      props: { onClick: () => void };
-    };
+    const button = findByLabel(
+      AssistantMessage({ item, onQuote }),
+      "Quote message"
+    ) as { props: { onClick: () => void } };
     button.props.onClick();
     expect(onQuote).toHaveBeenCalledWith("Hello\n\n```ts\nx\n```");
   });

package/components/Chat/Messages.tsx

@@ -21,6 +21,11 @@ import { Markdown } from "./Markdown";
 import { openSessionLink } from "./session-link";
 import { UndoButton } from "./Undo";
 import { useRowState } from "./rowState";
+import {
+  BookmarkButton,
+  TurnBookmark,
+  BookmarkPress,
+} from "@/components/Bookmarks/BookmarkButton";
 
 type Of<K extends ChatItem["kind"]> = Extract<ChatItem, { kind: K }>;
 
@@ -94,29 +99,34 @@ export function UserMessage({
   onUndo?: () => void;
 }) {
   return (
-    <div className="group flex flex-col items-end gap-1">
-      {item.from && (
-        <span data-copy-skip className="label-mono text-muted-foreground">
-          from {item.from}
-        </span>
-      )}
-      {item.images?.length ? (
-        <div data-copy-skip className="flex flex-wrap justify-end gap-1.5">
-          {item.images.map((img, i) => (
-            <ImageThumb
-              key={i}
-              src={`data:${img.mediaType};base64,${img.data}`}
-            />
-          ))}
-        </div>
-      ) : null}
-      {item.text && (
-        <div className="bg-foreground/[0.07] max-w-[85%] rounded-2xl rounded-br-md px-3.5 py-2 text-sm whitespace-pre-wrap">
-          <UserText text={item.text} />
+    <BookmarkPress itemId={item.id}>
+      <div className="group flex flex-col items-end gap-1">
+        {item.from && (
+          <span data-copy-skip className="label-mono text-muted-foreground">
+            from {item.from}
+          </span>
+        )}
+        {item.images?.length ? (
+          <div data-copy-skip className="flex flex-wrap justify-end gap-1.5">
+            {item.images.map((img, i) => (
+              <ImageThumb
+                key={i}
+                src={`data:${img.mediaType};base64,${img.data}`}
+              />
+            ))}
+          </div>
+        ) : null}
+        {item.text && (
+          <div className="bg-foreground/[0.07] max-w-[85%] rounded-2xl rounded-br-md px-3.5 py-2 text-sm whitespace-pre-wrap">
+            <UserText text={item.text} />
+          </div>
+        )}
+        <div className="-mr-1.5 flex items-center">
+          {onUndo && <UndoButton onClick={onUndo} />}
+          <BookmarkButton itemId={item.id} />
         </div>
-      )}
-      {onUndo && <UndoButton onClick={onUndo} />}
-    </div>
+      </div>
+    </BookmarkPress>
   );
 }
 
@@ -128,27 +138,32 @@ export function AssistantMessage({
   onQuote?: (text: string) => void;
 }) {
   return (
-    <div className="group">
-      <div data-quotable className={cn(item.streaming && "streaming-cursor")}>
-        <Markdown text={item.text} streaming={item.streaming} />
-      </div>
-      {!item.streaming && (
-        <div className="-ml-1.5 flex items-center opacity-40 group-hover:opacity-100 md:opacity-0">
-          <CopyButton text={item.text} label="Copy message" />
-          {onQuote && (
-            <button
-              type="button"
-              aria-label="Quote message"
-              title="Quote"
-              onClick={() => onQuote(item.text)}
-              className="text-muted-foreground hover:text-foreground hover:bg-foreground/[0.06] flex h-9 w-9 items-center justify-center rounded-md md:h-7 md:w-7"
-            >
-              <Quote className="h-3.5 w-3.5" />
-            </button>
-          )}
+    <BookmarkPress itemId={item.id}>
+      <div className="group">
+        <div data-quotable className={cn(item.streaming && "streaming-cursor")}>
+          <Markdown text={item.text} streaming={item.streaming} />
         </div>
-      )}
-    </div>
+        {!item.streaming && (
+          <div className="-ml-1.5 flex items-center">
+            <div className="flex items-center opacity-40 group-hover:opacity-100 md:opacity-0">
+              <CopyButton text={item.text} label="Copy message" />
+              {onQuote && (
+                <button
+                  type="button"
+                  aria-label="Quote message"
+                  title="Quote"
+                  onClick={() => onQuote(item.text)}
+                  className="text-muted-foreground hover:text-foreground hover:bg-foreground/[0.06] flex h-9 w-9 items-center justify-center rounded-md md:h-7 md:w-7"
+                >
+                  <Quote className="h-3.5 w-3.5" />
+                </button>
+              )}
+            </div>
+            <BookmarkButton itemId={item.id} />
+          </div>
+        )}
+      </div>
+    </BookmarkPress>
   );
 }
 
@@ -207,9 +222,10 @@ export function TurnEnd({ item }: { item: Of<"turn_end"> }) {
       ? `Done in ${secs}s`
       : "Done";
   return (
-    <div className="text-muted-foreground/60 flex items-center gap-3 font-mono text-[11px]">
+    <div className="group text-muted-foreground/60 flex items-center gap-3 font-mono text-[11px]">
       <span className="bg-foreground/[0.06] h-px flex-1" />
       {label}
+      <TurnBookmark turnEndId={item.id} />
       <span className="bg-foreground/[0.06] h-px flex-1" />
     </div>
   );

package/components/Chat/Tools.tsx

@@ -12,6 +12,7 @@ import { Highlighted } from "./Code";
 import { BackgroundButton, BackgroundState, useBackground } from "./background";
 import { useNow } from "./useNow";
 import { useRowState } from "./rowState";
+import { BookmarkButton } from "@/components/Bookmarks/BookmarkButton";
 
 // Output and diffs of tool calls sent without them (lib/chat/page), loaded
 // when one is opened.
@@ -152,7 +153,7 @@ function ToolRow({ tool }: { tool: ToolItem }) {
   );
   return (
     <div data-item={tool.id}>
-      <div className="hover:bg-foreground/[0.04] flex items-center gap-1 rounded-lg pr-1">
+      <div className="group hover:bg-foreground/[0.04] flex items-center gap-1 rounded-lg pr-1">
         <button
           type="button"
           onClick={() => setOpen(!open)}
@@ -169,6 +170,7 @@ function ToolRow({ tool }: { tool: ToolItem }) {
           )}
         </button>
         <BackgroundButton tool={tool} />
+        <BookmarkButton itemId={tool.id} />
       </div>
       {open && <ToolDetail tool={tool} />}
     </div>

package/components/Chat/composer/ComposerBody.tsx

@@ -163,7 +163,8 @@ export function ComposerBody({
     insertMarkdown(editor, content, insert.append);
   }, [insert, editor]);
 
-  const query = slashQuery(text);
+  const slash = slashQuery(caret.before);
+  const query = slash?.query ?? null;
   const mentions = useMentions(editor, caret, query === null, requestFiles);
   const matches = useMemo(() => {
     if (query === null) return [];
@@ -173,8 +174,9 @@ export function ComposerBody({
     ];
     return rankCommands(query, all);
   }, [query, commands, onSetModel]);
-  // One menu at a time: "/" commands at the start, "@" files at the caret.
-  const menuKey = query !== null ? `/${text}` : mentions.key;
+  // One menu at a time: "/" commands or "@" files at the caret.
+  const menuKey =
+    query !== null ? `/${caret.pos}:${caret.before}` : mentions.key;
   const menuOpen = menuKey !== null && dismissed !== menuKey;
   const options: MenuOption[] =
     query !== null
@@ -205,12 +207,18 @@ export function ComposerBody({
   );
 
   const pickCommand = (command: ChatCommand) => {
+    if (!editor || !slash) return;
+    // The "/" and what follows it, up to the caret.
+    const from = caret.pos - (caret.before.length - slash.start);
+    const chain = editor.chain().focus().deleteRange({ from, to: caret.pos });
     if (command === MODEL_COMMAND) {
-      setText("");
+      chain.run();
       setModelOpen(true);
       return;
     }
-    setText(insertCommand(command.name), true);
+    chain
+      .insertContent({ type: "text", text: insertCommand(command.name) })
+      .run();
   };
   const pick = (index: number) => {
     if (query !== null) {

package/components/Chat/useLongPress.ts

@@ -0,0 +1,43 @@
+"use client";
+
+import { useEffect, useRef, type PointerEvent } from "react";
+
+const HOLD_MS = 500;
+const SLOP_PX = 10;
+
+// A touch held still on an element. Moving the finger (a scroll) cancels it;
+// a mouse never triggers it.
+export function useLongPress(onLongPress: (() => void) | null) {
+  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const start = useRef<{ x: number; y: number } | null>(null);
+  const cancel = () => {
+    if (timer.current) clearTimeout(timer.current);
+    timer.current = null;
+    start.current = null;
+  };
+  useEffect(
+    () => () => {
+      if (timer.current) clearTimeout(timer.current);
+    },
+    []
+  );
+  if (!onLongPress) return {};
+  return {
+    onPointerDown: (e: PointerEvent) => {
+      if (e.pointerType !== "touch") return;
+      cancel();
+      start.current = { x: e.clientX, y: e.clientY };
+      timer.current = setTimeout(() => {
+        cancel();
+        navigator.vibrate?.(10);
+        onLongPress();
+      }, HOLD_MS);
+    },
+    onPointerMove: (e: PointerEvent) => {
+      const s = start.current;
+      if (s && Math.hypot(e.clientX - s.x, e.clientY - s.y) > SLOP_PX) cancel();
+    },
+    onPointerUp: cancel,
+    onPointerCancel: cancel,
+  };
+}

package/components/CommandPalette/useAppCommands.ts

@@ -4,6 +4,7 @@ import { useSnapshot } from "valtio";
 import { useTheme } from "next-themes";
 import {
   Archive,
+  Star,
   ChefHat,
   Code,
   FolderGit2,
@@ -27,6 +28,7 @@ import { useRecipesQuery } from "@/data/recipes";
 import { recipesUiActions } from "@/stores/recipesUi";
 import { usePaletteCommands } from "@/hooks/usePaletteCommands";
 import { archivedUiActions } from "@/stores/archivedUi";
+import { bookmarksUiActions } from "@/stores/bookmarksUi";
 import { busUiActions } from "@/stores/busUi";
 import { orchestratorOpenActions } from "@/stores/orchestratorOpen";
 import { sidebarUi, sidebarUiActions } from "@/stores/sidebarUi";
@@ -209,6 +211,14 @@ export function useAppCommands({
       icon: Archive,
       run: () => archivedUiActions.open(),
     },
+    {
+      id: "app.bookmarks",
+      title: "Bookmarks",
+      group: "Go to",
+      keywords: ["starred", "saved", "favourite", "favorite"],
+      icon: Star,
+      run: () => bookmarksUiActions.open(current?.id ?? null),
+    },
     ...settingsCommands(current?.id ?? null),
     {
       id: "app.theme",

package/components/Pane/DesktopTabBar.tsx

@@ -16,6 +16,7 @@ import { PaneViewToggle } from "./PaneViewToggle";
 import { PaneMenu } from "./PaneMenu";
 import { HostBadge } from "@/components/Hosts/HostBadge";
 import { usePaneBarSlots } from "./PaneBarSlots";
+import { ChatBookmarksButton } from "@/components/Bookmarks/ChatBookmarksButton";
 
 type ViewMode = "terminal" | "files" | "git" | "workers" | "log";
 
@@ -52,6 +53,8 @@ interface DesktopTabBarProps {
   onSplitVertical: () => void;
   onClose: () => void;
   onDetach: () => void;
+  // The chat on show, for its bookmarks; null for a terminal or another view.
+  bookmarksSessionId?: string | null;
 }
 
 export function DesktopTabBar({
@@ -80,6 +83,7 @@ export function DesktopTabBar({
   onSplitVertical,
   onClose,
   onDetach,
+  bookmarksSessionId,
 }: DesktopTabBarProps) {
   const { leading, trailing } = usePaneBarSlots(paneId);
 
@@ -160,6 +164,12 @@ export function DesktopTabBar({
         <ContextMeter sessionId={session?.id} />
         <SessionPrStage sessionId={session?.id} />
         <ViewSwitch session={session} />
+        {bookmarksSessionId && (
+          <ChatBookmarksButton
+            sessionId={bookmarksSessionId}
+            className="h-7 min-w-7"
+          />
+        )}
         {session?.working_directory && (
           <PaneViewToggle
             viewMode={viewMode}

package/components/Pane/MobileTabBar.tsx

@@ -37,6 +37,7 @@ import type { LucideIcon } from "lucide-react";
 import { HostBadge } from "@/components/Hosts/HostBadge";
 import { shareUiActions } from "@/stores/shareUi";
 import { MoveMenuItems } from "@/components/Tasks/MoveMenuItems";
+import { ChatBookmarksButton } from "@/components/Bookmarks/ChatBookmarksButton";
 
 type ViewMode = "terminal" | "files" | "git" | "workers" | "log";
 
@@ -90,6 +91,8 @@ interface MobileTabBarProps {
   onSelectSession?: (sessionId: string) => void;
   // Opens find in the chat on show (there's no ⌘F on a phone).
   onFind?: () => void;
+  // The chat on show, for its bookmarks.
+  bookmarksSessionId?: string | null;
 }
 
 export function MobileTabBar({
@@ -105,6 +108,7 @@ export function MobileTabBar({
   onViewModeChange,
   onSelectSession,
   onFind,
+  bookmarksSessionId,
 }: MobileTabBarProps) {
   const away = useAwayQuery().data?.away ?? null;
   // Find current session index and calculate prev/next
@@ -301,6 +305,12 @@ export function MobileTabBar({
         </button>
       </div>
 
+      {bookmarksSessionId && (
+        <ChatBookmarksButton
+          sessionId={bookmarksSessionId}
+          className="-my-1.5 h-11 min-w-11"
+        />
+      )}
       {onFind && (
         <Button
           variant="ghost"

package/components/Pane/index.tsx

@@ -173,6 +173,12 @@ export const Pane = memo(function Pane({
     return s?.view === "chat" ? s : null;
   };
 
+  // The chat on show in the main view, whose bookmarks the header lists.
+  const bookmarksSessionId =
+    activeTab && viewMode === "terminal"
+      ? (chatSessionFor(activeTab)?.id ?? null)
+      : null;
+
   // File editor state - lifted here so it persists across view switches
   const fileEditor = useFileEditor();
 
@@ -432,6 +438,7 @@ export const Pane = memo(function Pane({
           onMenuClick={onMenuClick}
           onViewModeChange={setViewMode}
           onSelectSession={onSelectSession}
+          bookmarksSessionId={bookmarksSessionId}
           onFind={
             activeTab && viewMode === "terminal" && chatSessionFor(activeTab)
               ? () => openFind(activeTab.sessionId as string)
@@ -465,6 +472,7 @@ export const Pane = memo(function Pane({
           onSplitVertical={() => splitVertical(paneId)}
           onClose={() => close(paneId)}
           onDetach={handleDetach}
+          bookmarksSessionId={bookmarksSessionId}
         />
       )}
 

package/components/SessionList/SidebarHeader.tsx

@@ -2,6 +2,7 @@
 
 import {
   Archive,
+  Star,
   BookOpen,
   ChefHat,
   Clock,
@@ -29,6 +30,7 @@ import {
 import { Button } from "@/components/ui/button";
 import type { Workspace } from "@/lib/db";
 import { archivedUiActions } from "@/stores/archivedUi";
+import { bookmarksUiActions } from "@/stores/bookmarksUi";
 import { tasksUiActions } from "@/stores/tasksUi";
 import { newDraft } from "@/stores/drafts";
 import { schedulesUiActions } from "@/stores/schedulesUi";
@@ -120,6 +122,9 @@ export function SidebarHeader(props: SidebarHeaderProps) {
             menuItem("Archived", () => archivedUiActions.open(), {
               icon: Archive,
             }),
+            menuItem("Bookmarks", () => bookmarksUiActions.open(workspaceId), {
+              icon: Star,
+            }),
             menuItem("Usage", () => usageUiActions.open(), { icon: Gauge }),
             menuItem("Model comparison", () => usageUiActions.open("compare"), {
               icon: Scale,

package/data/bookmarks/index.ts

@@ -0,0 +1,2 @@
+export * from "./keys";
+export * from "./queries";

package/data/bookmarks/keys.ts

@@ -0,0 +1,7 @@
+export const bookmarkKeys = {
+  all: ["bookmarks"] as const,
+  session: (sessionId: string) =>
+    [...bookmarkKeys.all, "session", sessionId] as const,
+  list: (workspace: string, q: string) =>
+    [...bookmarkKeys.all, "list", workspace, q] as const,
+};

package/data/bookmarks/queries.ts

@@ -0,0 +1,146 @@
+import {
+  useInfiniteQuery,
+  useMutation,
+  useQuery,
+  useQueryClient,
+} from "@tanstack/react-query";
+import {
+  bookmarkKey,
+  type Bookmark,
+  type BookmarkScope,
+  type BookmarksPage,
+} from "@/lib/bookmarks/types";
+import { bookmarkKeys } from "./keys";
+
+export type {
+  Bookmark,
+  BookmarkScope,
+  BookmarkState,
+  BookmarksPage,
+} from "@/lib/bookmarks/types";
+
+async function json<T>(res: Response): Promise<T> {
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok) throw new Error(data.error || "Request failed");
+  return data;
+}
+
+const send = (url: string, method: string, body?: unknown) =>
+  fetch(url, {
+    method,
+    headers: { "Content-Type": "application/json" },
+    body: body === undefined ? undefined : JSON.stringify(body),
+  });
+
+/** One chat's bookmarks, in chat order: what its stars and list read. */
+export function useSessionBookmarks(sessionId: string | null | undefined) {
+  return useQuery({
+    queryKey: bookmarkKeys.session(sessionId ?? ""),
+    queryFn: async () =>
+      (
+        await json<{ bookmarks: Bookmark[] }>(
+          await fetch(`/api/sessions/${sessionId}/bookmarks`)
+        )
+      ).bookmarks,
+    enabled: !!sessionId,
+    staleTime: 30_000,
+  });
+}
+
+/** Bookmarks across chats, a page at a time. `workspace`: an id or "all". */
+export function useBookmarks(workspace: string, q: string, enabled = true) {
+  return useInfiniteQuery({
+    queryKey: bookmarkKeys.list(workspace, q),
+    queryFn: async ({ pageParam }) => {
+      const p = new URLSearchParams({ workspace, q });
+      if (pageParam) p.set("before", pageParam);
+      return json<BookmarksPage>(await fetch(`/api/bookmarks?${p}`));
+    },
+    initialPageParam: null as string | null,
+    getNextPageParam: (last) => last.next,
+    enabled,
+  });
+}
+
+/**
+ * Stars or unstars an item. The star flips at once; the server's answer
+ * (or the change topic) settles it.
+ */
+export function useToggleBookmark(sessionId: string) {
+  const qc = useQueryClient();
+  const key = bookmarkKeys.session(sessionId);
+  return useMutation({
+    mutationFn: async (v: {
+      itemId: string;
+      scope: BookmarkScope;
+      existing: Bookmark | null;
+    }) => {
+      if (v.existing) {
+        await json(await send(`/api/bookmarks/${v.existing.id}`, "DELETE"));
+        return null;
+      }
+      return (
+        await json<{ bookmark: Bookmark }>(
+          await send(`/api/sessions/${sessionId}/bookmarks`, "POST", {
+            itemId: v.itemId,
+            scope: v.scope,
+          })
+        )
+      ).bookmark;
+    },
+    onMutate: async (v) => {
+      await qc.cancelQueries({ queryKey: key });
+      const before = qc.getQueryData<Bookmark[]>(key);
+      const k = bookmarkKey(v.itemId, v.scope);
+      qc.setQueryData<Bookmark[]>(key, (list = []) =>
+        v.existing
+          ? list.filter((b) => bookmarkKey(b.itemId, b.scope) !== k)
+          : [...list, placeholder(sessionId, v.itemId, v.scope)]
+      );
+      return { before };
+    },
+    onError: (_e, _v, ctx) => qc.setQueryData(key, ctx?.before),
+    onSettled: () => qc.invalidateQueries({ queryKey: bookmarkKeys.all }),
+  });
+}
+
+// Stands in for a new bookmark until the server's comes back.
+const placeholder = (
+  sessionId: string,
+  itemId: string,
+  scope: BookmarkScope
+): Bookmark => ({
+  id: `pending:${itemId}:${scope}`,
+  sessionId,
+  itemId,
+  scope,
+  kind: scope === "turn" ? "turn" : "user",
+  text: "",
+  note: null,
+  sessionName: "",
+  workspaceId: null,
+  createdAt: new Date().toISOString(),
+  state: "live",
+});
+
+export function useSetBookmarkNote() {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: async (v: { id: string; note: string | null }) =>
+      (
+        await json<{ bookmark: Bookmark }>(
+          await send(`/api/bookmarks/${v.id}`, "PATCH", { note: v.note })
+        )
+      ).bookmark,
+    onSettled: () => qc.invalidateQueries({ queryKey: bookmarkKeys.all }),
+  });
+}
+
+export function useRemoveBookmark() {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: async (id: string) =>
+      json<{ ok: true }>(await send(`/api/bookmarks/${id}`, "DELETE")),
+    onSettled: () => qc.invalidateQueries({ queryKey: bookmarkKeys.all }),
+  });
+}

package/data/chat/useChat.ts

@@ -143,6 +143,8 @@ export function useChat(
   const [state, setState] = useState<ChatState>("idle");
   const [compacting, setCompacting] = useState<Compacting | null>(null);
   const [connected, setConnected] = useState(false);
+  // The chat whose snapshot the items are, once one has landed.
+  const [loadedFor, setLoadedFor] = useState<string | null>(null);
   const [commands, setCommands] = useState<ChatCommand[]>([]);
   const [models, setModels] = useState<ChatModel[]>([]);
   const [model, setModelState] = useState("");
@@ -232,6 +234,7 @@ export function useChat(
           setCompacting(m.compacting ?? null);
           setQueue(m.queue ?? []);
           setSuggestion(m.suggestion ?? null);
+          setLoadedFor(sessionId);
         } else if (m.type === "queue") {
           setQueue(m.queue);
         } else if (m.type === "suggestion") {
@@ -509,6 +512,7 @@ export function useChat(
 
   return {
     items,
+    loadedFor,
     hasMore,
     loadingOlder,
     loadOlder,

package/data/push/topics.ts

@@ -16,6 +16,7 @@ import { recipeKeys } from "../recipes";
 import { featureKeys } from "../features";
 import { archivedKeys } from "../done";
 import { awayKeys } from "../away";
+import { bookmarkKeys } from "../bookmarks/keys";
 
 // What each pushed topic (a table that changed, lib/db/changes.ts, or a
 // pushed view) means the browser should refetch. Only queries on screen
@@ -72,6 +73,8 @@ function keysFor(topic: string): QueryKey[] {
       return [awayKeys.all];
     case "dev_servers":
       return [devServerKeys.all];
+    case "chat_bookmarks":
+      return [bookmarkKeys.all];
     default:
       return [];
   }

package/lib/bookmarks/body.ts

@@ -0,0 +1,23 @@
+import { NextResponse } from "next/server";
+import { readCapped } from "../security/read-capped";
+
+// An item id, a scope and a note of at most MAX_NOTE_CHARS, with room over.
+export const MAX_BOOKMARK_BODY_BYTES = 8192;
+
+/** A bookmark route's JSON body, or the response that refuses it. */
+export async function readBookmarkBody(
+  request: Request
+): Promise<Record<string, unknown> | NextResponse> {
+  const raw = await readCapped(request, MAX_BOOKMARK_BODY_BYTES);
+  if (raw === null)
+    return NextResponse.json({ error: "Too large" }, { status: 413 });
+  let body: unknown = null;
+  try {
+    body = JSON.parse(raw);
+  } catch {
+    // Not JSON: refused below.
+  }
+  if (!body || typeof body !== "object" || Array.isArray(body))
+    return NextResponse.json({ error: "Bad request" }, { status: 400 });
+  return body as Record<string, unknown>;
+}