@saadnvd1/agent-os 0.3.768 → 0.3.775

package/components/SessionList/useSessionSwitching.ts

@@ -36,7 +36,7 @@ export function useSessionSwitching(
     {
       id: "session.previous",
       title: "Previous session",
-      group: "Sessions",
+      group: "Actions",
       hint: chordHint(PREVIOUS),
       keywords: ["switch", "up"],
       icon: MessageSquare,
@@ -45,7 +45,7 @@ export function useSessionSwitching(
     {
       id: "session.next",
       title: "Next session",
-      group: "Sessions",
+      group: "Actions",
       hint: chordHint(NEXT),
       keywords: ["switch", "down"],
       icon: MessageSquare,

package/components/Share/MessageList.tsx

@@ -0,0 +1,87 @@
+"use client";
+
+import { useEffect, useRef } from "react";
+import { cn } from "@/lib/utils";
+import { TYPE_LABEL } from "@/lib/share/view";
+import type { PreviewItem } from "@/data/shares";
+
+// The chat's messages. The text picks the range (click for a start,
+// shift-click for an end); the checkbox leaves one message out of it.
+export function MessageList({
+  rows,
+  inside,
+  dropped,
+  touch,
+  onPick,
+  onToggle,
+}: {
+  rows: PreviewItem[];
+  inside: Set<string>;
+  dropped: string[];
+  touch: boolean;
+  onPick: (id: string, extend: boolean) => void;
+  onToggle: (id: string) => void;
+}) {
+  const first = rows.find((r) => inside.has(r.id))?.id;
+  const listRef = useRef<HTMLUListElement>(null);
+  const firstRef = useRef<HTMLLIElement>(null);
+  useEffect(() => {
+    if (listRef.current && firstRef.current)
+      listRef.current.scrollTop = firstRef.current.offsetTop;
+  }, [first]);
+
+  return (
+    <div className="shrink-0">
+      <div className="text-muted-foreground mb-1 text-xs font-medium">
+        Messages
+      </div>
+      <p className="text-muted-foreground mb-1.5 text-xs">
+        {touch
+          ? "Tap a message to start the range, then another to end it."
+          : "Click a message to start the range, shift-click to end it."}
+      </p>
+      <ul
+        ref={listRef}
+        className="relative max-h-64 divide-y overflow-y-auto rounded-lg border md:max-h-[40vh]"
+      >
+        {rows.map((item) => {
+          const on = inside.has(item.id);
+          return (
+            <li
+              key={item.id}
+              ref={item.id === first ? firstRef : undefined}
+              className={cn("flex items-center", on && "bg-primary/5")}
+            >
+              <label className="flex min-h-11 w-11 shrink-0 cursor-pointer items-center justify-center">
+                <input
+                  type="checkbox"
+                  className="h-4 w-4"
+                  aria-label="Include this message"
+                  disabled={!on}
+                  checked={on && !dropped.includes(item.id)}
+                  onChange={() => onToggle(item.id)}
+                />
+              </label>
+              <button
+                type="button"
+                aria-pressed={on}
+                onClick={(e) => onPick(item.id, e.shiftKey)}
+                className={cn(
+                  "flex min-h-11 min-w-0 flex-1 items-center gap-3 py-1.5 pr-3 text-left text-sm",
+                  !on && "text-muted-foreground opacity-60"
+                )}
+              >
+                <span className="text-muted-foreground w-12 shrink-0 text-xs">
+                  {TYPE_LABEL[item.type] ?? item.type}
+                </span>
+                <span className="min-w-0 flex-1 truncate">
+                  {item.excerpt || "(empty)"}
+                </span>
+              </button>
+            </li>
+          );
+        })}
+      </ul>
+    </div>
+  );
+}

package/components/Share/RangePicker.tsx

@@ -0,0 +1,59 @@
+"use client";
+
+import { Button } from "@/components/ui/button";
+import {
+  PRESETS,
+  presetRange,
+  type RangePreset,
+  type RangeRow,
+} from "@/lib/share/range";
+
+// The part of the chat to share: a preset, with what it comes to underneath.
+export function RangePicker({
+  rows,
+  active,
+  summary,
+  onPick,
+}: {
+  rows: RangeRow[];
+  active: RangePreset | null;
+  summary: string;
+  onPick: (preset: RangePreset) => void;
+}) {
+  const now = new Date();
+  return (
+    <div className="space-y-1.5">
+      <div
+        className="grid grid-cols-2 gap-2 sm:flex sm:flex-wrap"
+        role="group"
+        aria-label="Part of the chat to share"
+      >
+        {PRESETS.map((p) => {
+          const empty = !presetRange(rows, p.id, now);
+          return (
+            <Button
+              key={p.id}
+              size="sm"
+              variant={active === p.id ? "default" : "outline"}
+              className="min-h-11"
+              aria-pressed={active === p.id}
+              disabled={empty}
+              title={empty ? "No messages today" : undefined}
+              onClick={() => onPick(p.id)}
+            >
+              {p.label}
+            </Button>
+          );
+        })}
+      </div>
+      <p
+        className="text-muted-foreground text-xs"
+        aria-live="polite"
+        data-testid="share-range-summary"
+      >
+        {summary}
+        {!active && " · Custom range"}
+      </p>
+    </div>
+  );
+}

package/components/Share/ShareDialog.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { useEffect, useRef, useState } from "react";
+import { useEffect, useMemo, useRef, useState } from "react";
 import { useSnapshot } from "valtio";
 import { toast } from "sonner";
 import { Check, Copy, ExternalLink, Link2 } from "lucide-react";
@@ -19,12 +19,18 @@ import {
   SelectValue,
 } from "@/components/ui/select";
 import { DownloadMenu } from "./DownloadMenu";
+import { MessageList } from "./MessageList";
+import { RangePicker } from "./RangePicker";
+import { useCoarsePointer } from "@/components/Chat/composer/useCoarsePointer";
 import { cn } from "@/lib/utils";
 import { Switch } from "@/components/ui/switch";
 import { writeClipboard } from "@/hooks/useCopyToClipboard";
 import {
   useCreateShare,
+  useShareMessages,
   useSharePreview,
+  type PreviewItem,
+  type PreviewRequest,
   type ShareExpiry,
   type SharePreview,
 } from "@/data/shares";
@@ -34,12 +40,21 @@ import {
   DEFAULT_EXPIRY,
   EXPIRIES,
   EXPIRY_LABEL,
-  TYPE_LABEL,
   formatBytes,
-  nothingLeft,
   redactionSummary,
   toggleDrop,
 } from "@/lib/share/view";
+import {
+  DEFAULT_PRESET,
+  activePreset,
+  clickRange,
+  inRange,
+  presetRange,
+  rangeFromHere,
+  rangeSummary,
+  type RangePreset,
+  type ShareRange,
+} from "@/lib/share/range";
 
 // Opened from a menu or an artifact: the redacted page exactly as it would be
 // uploaded, with what to leave out, then Create link or Download.
@@ -52,7 +67,7 @@ export function ShareDialog() {
     >
       {target && (
         <ShareBody
-          key={target.sessionId ?? target.artifactId}
+          key={`${target.sessionId ?? target.artifactId}:${target.fromId ?? ""}`}
           target={{ ...target }}
         />
       )}
@@ -69,6 +84,7 @@ function ShareBody({
     artifactId?: string;
     title: string;
     version?: number;
+    fromId?: string;
   };
 }) {
   const [tools, setTools] = useState(false);
@@ -80,22 +96,60 @@ function ShareBody({
   const [follow, setFollow] = useState(false);
   const [copied, setCopied] = useState(false);
   const [tab, setTab] = useState<"page" | "markdown">("page");
+  const [rows, setRows] = useState<PreviewItem[] | null>(null);
+  const [range, setRange] = useState<ShareRange | null>(null);
+  const [anchor, setAnchor] = useState<string | null>(null);
+  const [armed, setArmed] = useState(false);
   const previewReq = useSharePreview();
+  const listReq = useShareMessages();
   const create = useCreateShare();
+  const coarse = useCoarsePointer();
   const seq = useRef(0);
 
   const { kind, sessionId, artifactId } = target;
+  const chat = kind === "chat";
+
+  // A chat opens on its last exchange, or on the message it was shared from.
   useEffect(() => {
+    if (!chat) return;
+    let live = true;
+    listReq
+      .mutateAsync({ kind, sessionId, includeTools: true })
+      .then(({ items }) => {
+        if (!live) return;
+        const from = target.fromId ? rangeFromHere(items, target.fromId) : null;
+        setRows(items);
+        setRange(from ?? presetRange(items, DEFAULT_PRESET, new Date()));
+        setAnchor(from?.fromId ?? null);
+      })
+      .catch((err: Error) => live && setError(err.message));
+    return () => {
+      live = false;
+    };
+    // listReq is stable enough; re-running on it would loop.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [chat, kind, sessionId, target.fromId]);
+
+  const ready =
+    !chat || (rows !== null && range !== null) || rows?.length === 0;
+  const request: PreviewRequest = useMemo(
+    () => ({
+      kind,
+      sessionId,
+      artifactId,
+      includeTools: tools,
+      dropIds: dropped,
+      ...(range ?? {}),
+    }),
+    [kind, sessionId, artifactId, tools, dropped, range]
+  );
+
+  useEffect(() => {
+    if (!ready) return;
     const mine = ++seq.current;
     const timer = setTimeout(async () => {
       try {
-        const p = await previewReq.mutateAsync({
-          kind,
-          sessionId,
-          artifactId,
-          includeTools: tools,
-          dropIds: dropped,
-        });
+        const p = await previewReq.mutateAsync(request);
         if (mine === seq.current) {
           setPreview(p);
           setError(null);
@@ -107,7 +161,7 @@ function ShareBody({
     return () => clearTimeout(timer);
     // previewReq is stable enough; re-running on it would loop.
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [kind, sessionId, artifactId, tools, dropped]);
+  }, [ready, request]);
 
   const toggle = (id: string) => setDropped((d) => toggleDrop(d, id));
 
@@ -115,11 +169,7 @@ function ShareBody({
     if (!preview) return;
     try {
       const res = await create.mutateAsync({
-        kind,
-        sessionId,
-        artifactId,
-        includeTools: tools,
-        dropIds: dropped,
+        ...request,
         sharedAt: preview.sharedAt,
         hash: preview.hash,
         expiresIn,
@@ -149,8 +199,33 @@ function ShareBody({
   };
 
   const linked = preview?.connectLinked ?? false;
-  const empty =
-    kind === "chat" && !!preview && nothingLeft(preview.items, dropped);
+  const visibleRows = useMemo(
+    () => (rows ?? []).filter((r) => tools || !r.tools),
+    [rows, tools]
+  );
+  const covered = useMemo(() => inRange(rows ?? [], range), [rows, range]);
+  const inside = useMemo(() => new Set(covered.map((r) => r.id)), [covered]);
+  const shared = visibleRows.filter(
+    (r) => inside.has(r.id) && !dropped.includes(r.id)
+  );
+  const empty = chat && !!rows && shared.length === 0;
+  const active = activePreset(rows ?? [], range, new Date());
+
+  const pickPreset = (preset: RangePreset) => {
+    const r = presetRange(rows ?? [], preset, new Date());
+    if (!r) return;
+    setRange(r);
+    setAnchor(r.fromId);
+    setArmed(false);
+  };
+  const pickRow = (id: string, shift: boolean) => {
+    const extend = shift || (coarse && armed);
+    setRange(
+      clickRange(rows ?? [], anchor ?? range?.fromId ?? null, id, extend)
+    );
+    if (!extend) setAnchor(id);
+    setArmed(coarse && !extend);
+  };
   const summary = preview ? redactionSummary(preview.hits) : "";
 
   return (
@@ -166,6 +241,15 @@ function ShareBody({
         </DialogDescription>
       </div>
 
+      {chat && rows && rows.length > 0 && (
+        <RangePicker
+          rows={rows}
+          active={active}
+          summary={rangeSummary(visibleRows.length, shared)}
+          onPick={pickPreset}
+        />
+      )}
+
       <div className="flex min-h-0 flex-1 flex-col gap-3 overflow-y-auto md:flex-row md:overflow-hidden">
         <div className="flex min-h-[45vh] flex-1 flex-col gap-2 md:min-h-0">
           <div className="flex gap-2" role="group" aria-label="Preview format">
@@ -210,31 +294,14 @@ function ShareBody({
                 <span>Include tool calls and thinking</span>
                 <Switch checked={tools} onCheckedChange={setTools} />
               </label>
-              <div className="min-h-0">
-                <div className="text-muted-foreground mb-1 text-xs font-medium">
-                  Messages
-                </div>
-                <ul className="max-h-64 divide-y overflow-y-auto rounded-lg border">
-                  {preview?.items.map((item) => (
-                    <li key={item.id}>
-                      <label className="flex min-h-11 cursor-pointer items-center gap-3 px-3 py-1.5 text-sm">
-                        <input
-                          type="checkbox"
-                          className="h-4 w-4 shrink-0"
-                          checked={!dropped.includes(item.id)}
-                          onChange={() => toggle(item.id)}
-                        />
-                        <span className="text-muted-foreground w-12 shrink-0 text-xs">
-                          {TYPE_LABEL[item.type] ?? item.type}
-                        </span>
-                        <span className="min-w-0 flex-1 truncate">
-                          {item.excerpt || "(empty)"}
-                        </span>
-                      </label>
-                    </li>
-                  ))}
-                </ul>
-              </div>
+              <MessageList
+                rows={visibleRows}
+                inside={inside}
+                dropped={dropped}
+                touch={coarse}
+                onPick={pickRow}
+                onToggle={toggle}
+              />
             </>
           )}
 
@@ -372,15 +439,9 @@ function ShareBody({
           <div className="flex gap-2">
             <DownloadMenu
               preview={preview}
-              title={target.title}
+              title={target.title || preview?.title || ""}
               disabled={!preview || preview.tooBig || empty}
-              request={{
-                kind,
-                sessionId,
-                artifactId,
-                includeTools: tools,
-                dropIds: dropped,
-              }}
+              request={request}
             />
             {linked && (
               <Button

package/components/Shares/SharedLinksPanel.tsx

@@ -10,6 +10,7 @@ import {
   type SharedLinkRow,
 } from "@/data/shares";
 import { cn } from "@/lib/utils";
+import { SessionAnchor } from "@/components/Chat/SessionAnchor";
 
 const when = (iso: string) =>
   new Date(iso).toLocaleDateString(undefined, {
@@ -44,12 +45,9 @@ function Row({ share }: { share: SharedLinkRow }) {
 
   const title =
     share.kind === "chat" && share.sessionId ? (
-      <a
-        href={`/?session=${encodeURIComponent(share.sessionId)}`}
-        className="hover:underline"
-      >
+      <SessionAnchor sessionId={share.sessionId} className="hover:underline">
         {share.title}
-      </a>
+      </SessionAnchor>
     ) : (
       share.title
     );

package/data/session-artifacts/keys.ts

@@ -7,4 +7,6 @@ export const sessionArtifactKeys = {
   // A page's versions, by any version's id; pageId keys the invalidation.
   versions: (pageId: string) =>
     [...sessionArtifactKeys.all, "versions", pageId] as const,
+  compare: (sessionId: string, from: string, to: string, mode: string) =>
+    [...sessionArtifactKeys.all, "compare", sessionId, from, to, mode] as const,
 };

package/data/session-artifacts/queries.ts

@@ -1,6 +1,7 @@
 import { useQuery } from "@tanstack/react-query";
 import type { SessionArtifact } from "@/lib/session-artifacts/types";
 import type { PageVersions } from "@/lib/artifacts/actions";
+import type { CompareMode, CompareResult } from "@/lib/artifacts/compare/types";
 import { sessionArtifactKeys } from "./keys";
 
 export type { SessionArtifact } from "@/lib/session-artifacts/types";
@@ -76,3 +77,27 @@ export function useArtifactVersions(
     staleTime: 30_000,
   });
 }
+
+/** What changed between two versions of a page. */
+export function useArtifactCompare(
+  sessionId: string,
+  fromId: string,
+  toId: string,
+  mode: CompareMode,
+  enabled = true
+) {
+  return useQuery({
+    queryKey: sessionArtifactKeys.compare(sessionId, fromId, toId, mode),
+    queryFn: async (): Promise<Extract<CompareResult, { ok: true }>> => {
+      const res = await fetch(
+        `${artifactContentUrl(sessionId, fromId)}/compare?to=${encodeURIComponent(toId)}&mode=${mode}`
+      );
+      const data = await res.json().catch(() => ({}));
+      if (!res.ok) throw new Error(data.error || "Couldn't compare versions");
+      return data;
+    },
+    enabled: enabled && !!fromId && !!toId,
+    // Versions never change once saved.
+    staleTime: Infinity,
+  });
+}

package/data/shares/queries.ts

@@ -1,6 +1,7 @@
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import type {
   CreatedShare,
+  MessageList,
   PreviewRequest,
   SharePreview,
   SharesResponse,
@@ -40,6 +41,16 @@ export function useSharePreview() {
   });
 }
 
+/** Every message of a chat, for picking the part to share. */
+export function useShareMessages() {
+  return useMutation({
+    mutationFn: async (req: PreviewRequest) =>
+      json<MessageList>(
+        await post("/api/shares/preview", { ...req, listOnly: true })
+      ),
+  });
+}
+
 /** The share as a PDF, printed by the server. */
 export function useSharePdf() {
   return useMutation({

package/hooks/useCopyToClipboard.ts

@@ -65,9 +65,12 @@ export async function writeClipboard(text: string): Promise<void> {
 }
 
 // A session's own address (lib/session-url), for a bookmark or another device.
-export async function copySessionLink(sessionId: string): Promise<void> {
+export async function copySessionLink(session: {
+  id: string;
+  name: string;
+}): Promise<void> {
   try {
-    await writeClipboard(sessionLink(window.location.origin, sessionId));
+    await writeClipboard(sessionLink(window.location.origin, session));
     toast.success("Link copied");
   } catch {
     toast.error("Could not copy to clipboard");

package/hooks/usePaletteCommands.ts

@@ -17,7 +17,10 @@ export function usePaletteCommands(
   });
   const shape = commands
     ? commands
-        .map((c) => `${c.id}\u0000${c.title}\u0000${c.hint ?? ""}`)
+        .map(
+          (c) =>
+            `${c.id}\u0000${c.title}\u0000${c.hint ?? ""}\u0000${c.status ?? ""}`
+        )
         .join("\u0001")
     : null;
   useEffect(() => {

package/hooks/useSessionHref.ts

@@ -0,0 +1,20 @@
+"use client";
+
+import { useContext } from "react";
+import { QueryClientContext } from "@tanstack/react-query";
+import { sessionKeys } from "@/data/sessions/keys";
+import type { SessionsResponse } from "@/data/sessions/queries";
+import { sessionPath } from "@/lib/session-url";
+
+/**
+ * A session's address from just its id: readable when the list has its name,
+ * `/s/<id8>` otherwise (opening that fills the slug in). Works without a
+ * query client too: a chat rendered to static markup (an export, a share).
+ */
+export function useSessionHref(id: string): string {
+  const list = useContext(QueryClientContext)?.getQueryData<SessionsResponse>(
+    sessionKeys.list()
+  );
+  const name = list?.sessions.find((s) => s.id === id)?.name;
+  return sessionPath({ id, name });
+}

package/hooks/useSessionUrl.ts

@@ -3,7 +3,12 @@
 import { useCallback, useEffect, useLayoutEffect, useRef } from "react";
 import { toast } from "sonner";
 import type { Session } from "@/lib/db";
-import { SessionUrlSync, locateSession } from "@/lib/session-url";
+import {
+  SessionUrlSync,
+  locateSession,
+  pickSession,
+  type SessionRef,
+} from "@/lib/session-url";
 import { usePanes } from "@/contexts/PaneContext";
 
 interface Options {
@@ -16,9 +21,9 @@ interface Options {
 }
 
 /**
- * The address bar names the focused session (`/?session=<id>`), and an
- * address opens its session: on load, after pairing, and on back/forward.
- * With split panes it follows the focused pane.
+ * The address bar names the focused session (`/s/<name>-<id8>`, following
+ * renames), and an address opens its session: on load, after pairing, and on
+ * back/forward. With split panes it follows the focused pane.
  */
 export function useSessionUrl({
   sessions,
@@ -78,23 +83,22 @@ export function useSessionUrl({
         replace: (href) => window.history.replaceState(null, "", href),
       },
       {
-        isKnown: (id) => latest.current.sessions.some((s) => s.id === id),
+        find: (ref) => pickSession(ref, latest.current.sessions)?.id ?? null,
+        nameOf: (id) =>
+          latest.current.sessions.find((s) => s.id === id)?.name ?? null,
         open: (id) => {
           const session = latest.current.sessions.find((s) => s.id === id);
           if (session) reveal(session);
         },
         // Made a moment ago and not in the list yet: ask once more. Archived,
         // merged and dropped sessions aren't listed and stay not found.
-        openUnlisted: async (id) => {
+        openUnlisted: async (ref) => {
           const fresh = await latest.current.reloadSessions();
-          const session = fresh.find((s) => s.id === id);
+          const session = pickSession(ref, fresh);
           if (session) reveal(session);
           return !!session;
         },
-        notFound: () =>
-          toast.error("Session not found", {
-            description: "It may have been archived or deleted.",
-          }),
+        notFound: (ref) => void explainNotFound(ref),
       }
     );
     return syncRef.current;
@@ -112,6 +116,12 @@ export function useSessionUrl({
     getSync().focusChanged(focusedId);
   }, [getSync, focusedId]);
 
+  // A rename (by hand, or the title a first turn gives it) moves the slug.
+  const focusedName = sessions.find((s) => s.id === focusedId)?.name ?? null;
+  useEffect(() => {
+    if (focusedName !== null) getSync().renamed();
+  }, [getSync, focusedName]);
+
   const ready = hydrated && loaded;
   useEffect(() => {
     if (ready) void getSync().start();
@@ -123,3 +133,22 @@ export function useSessionUrl({
     return () => window.removeEventListener("popstate", onPop);
   }, [getSync]);
 }
+
+// An archived session says so, by name; anything else isn't found.
+async function explainNotFound(ref: SessionRef): Promise<void> {
+  const params = new URLSearchParams(
+    "id" in ref ? { ref: ref.id } : { ref: ref.short, slug: ref.slug ?? "" }
+  );
+  const found = await fetch(`/api/sessions/resolve?${params}`)
+    .then((r) => (r.ok ? r.json() : null))
+    .catch(() => null);
+  if (found?.archived) {
+    toast.error(`${found.name} is on the Done shelf`, {
+      description: "Bring it back from there to open it.",
+    });
+    return;
+  }
+  toast.error("Session not found", {
+    description: "It may have been archived or deleted.",
+  });
+}