@saadnvd1/agent-os 0.3.768 → 0.3.775

package/lib/share/service.ts

@@ -16,7 +16,11 @@ import {
   renderChatSnapshot,
 } from "./render";
 import { artifactToMarkdown, chatToMarkdown } from "./markdown";
-import { buildArtifactSnapshot, buildChatSnapshot } from "./snapshot";
+import {
+  RangeGone,
+  buildArtifactSnapshot,
+  buildChatSnapshot,
+} from "./snapshot";
 
 export interface ShareRequest {
   kind: "chat" | "artifact";
@@ -25,6 +29,9 @@ export interface ShareRequest {
   includeTools: boolean;
   /** Messages the reader left out in the preview. */
   dropIds?: string[];
+  /** The part of the chat shared: from this message to that one, ends included. */
+  fromId?: string;
+  toId?: string;
   follow?: "latest";
   sharedAt: string;
 }
@@ -34,6 +41,7 @@ export interface ItemRow {
   type: string;
   tools: boolean;
   excerpt: string;
+  createdAt?: number;
 }
 
 export interface Page {
@@ -87,6 +95,15 @@ export function parseRequest(raw: unknown, sharedAt?: unknown): ShareRequest {
       throw new BadShare("dropIds must be a list of ids", 400);
     dropIds = b.dropIds as string[];
   }
+  const end = (key: "fromId" | "toId") => {
+    const v = b[key];
+    if (v === undefined) return undefined;
+    if (typeof v !== "string" || !v || v.length > 200)
+      throw new BadShare(`${key} must be a message id`, 400);
+    return v;
+  };
+  const fromId = end("fromId");
+  const toId = end("toId");
   if (b.follow !== undefined && b.follow !== "latest")
     throw new BadShare("follow must be latest", 400);
   if (b.follow && kind !== "artifact")
@@ -100,11 +117,41 @@ export function parseRequest(raw: unknown, sharedAt?: unknown): ShareRequest {
     artifactId,
     includeTools: b.includeTools === true,
     dropIds,
+    fromId,
+    toId,
     follow: b.follow === "latest" ? "latest" : undefined,
     sharedAt: at,
   };
 }
 
+const rowOf = ({ id, type, tools, excerpt, createdAt }: ItemRow): ItemRow => ({
+  id,
+  type,
+  tools,
+  excerpt,
+  createdAt,
+});
+
+function chatSession(sessionId: string) {
+  let session;
+  try {
+    session = getSession(sessionId);
+  } catch {
+    throw new BadShare("No such chat", 404);
+  }
+  if (session.view !== "chat")
+    throw new BadShare("Only chats can be shared", 400);
+}
+
+/** Every shareable message of a chat, tool rows included, in order. */
+export async function listChatItems(req: ShareRequest): Promise<ItemRow[]> {
+  chatSession(req.sessionId!);
+  const all = await buildChatSnapshot(req.sessionId!, shareContext(), {
+    includeTools: true,
+  });
+  return all.items.map(rowOf);
+}
+
 const sha256 = (s: string) => createHash("sha256").update(s).digest("hex");
 
 /** Binds both parts: neither can change without the hash changing. */
@@ -120,29 +167,27 @@ export async function buildPage(req: ShareRequest): Promise<Page> {
   let items: ItemRow[] = [];
 
   if (req.kind === "chat") {
-    let session;
-    try {
-      session = getSession(req.sessionId!);
-    } catch {
-      throw new BadShare("No such chat", 404);
-    }
-    if (session.view !== "chat")
-      throw new BadShare("Only chats can be shared", 400);
+    chatSession(req.sessionId!);
     const all = await buildChatSnapshot(req.sessionId!, ctx, {
       includeTools: req.includeTools,
     });
-    items = all.items.map(({ id, type, tools, excerpt }) => ({
-      id,
-      type,
-      tools,
-      excerpt,
-    }));
-    const snap = req.dropIds?.length
-      ? await buildChatSnapshot(req.sessionId!, ctx, {
+    items = all.items.map(rowOf);
+    const narrowed =
+      req.dropIds?.length || req.fromId !== undefined || req.toId !== undefined;
+    let snap = all;
+    if (narrowed) {
+      try {
+        snap = await buildChatSnapshot(req.sessionId!, ctx, {
           includeTools: req.includeTools,
           dropIds: req.dropIds,
-        })
-      : all;
+          fromId: req.fromId,
+          toId: req.toId,
+        });
+      } catch (err) {
+        if (err instanceof RangeGone) throw new BadShare(err.message, 409);
+        throw err;
+      }
+    }
     if (!snap.items.length)
       throw new BadShare("Nothing to share: every message is left out", 400);
     html = renderChatSnapshot(snap, { sharedAt: req.sharedAt });

package/lib/share/snapshot.ts

@@ -15,6 +15,7 @@ import {
   type Hits,
   type ShareContext,
 } from "./redact";
+import { windowOf } from "./range";
 
 export type SnapshotType =
   "user" | "assistant" | "plan" | "error" | "divider" | "artifact" | "detail";
@@ -32,6 +33,7 @@ export interface SnapshotItem {
   excerpt: string;
   /** Hidden unless "include tool calls and thinking" is on. */
   tools: boolean;
+  createdAt?: number;
 }
 
 export interface Snapshot {
@@ -39,9 +41,19 @@ export interface Snapshot {
   items: SnapshotItem[];
   /** Whether the tools group was left out, to say so on the page. */
   toolsHidden: boolean;
+  /** Messages before / after the shared range were left out, to say so. */
+  cutBefore?: boolean;
+  cutAfter?: boolean;
   hits: Hits;
 }
 
+/** The range names a message that is no longer in the chat. */
+export class RangeGone extends Error {
+  constructor() {
+    super("That part of the chat changed; pick the range again.");
+  }
+}
+
 export const MAX_TOOL_INPUT = 4_000;
 export const MAX_TOOL_OUTPUT = 20_000;
 export const HIDDEN_FILE = "[contents of a secret file hidden]";
@@ -189,7 +201,12 @@ export function toRaw(item: ChatItem): Raw | null {
 export async function buildChatSnapshot(
   sessionId: string,
   ctx: ShareContext,
-  opts: { includeTools: boolean; dropIds?: string[] }
+  opts: {
+    includeTools: boolean;
+    dropIds?: string[];
+    fromId?: string;
+    toId?: string;
+  }
 ): Promise<Snapshot> {
   const session = getSession(sessionId);
   const dropped = new Set(opts.dropIds ?? []);
@@ -201,13 +218,31 @@ export async function buildChatSnapshot(
   };
 
   const items: SnapshotItem[] = [];
-  for (const item of visible(listItems(sessionId))) {
+  const all = visible(listItems(sessionId));
+  let window: { start: number; end: number } | null = null;
+  if (opts.fromId !== undefined || opts.toId !== undefined) {
+    window = windowOf(
+      all.map((i) => i.id),
+      opts.fromId,
+      opts.toId
+    );
+    if (!window) throw new RangeGone();
+  }
+  let cutBefore = false;
+  let cutAfter = false;
+  for (const [at, item] of all.entries()) {
     const raw = toRaw(item);
     if (!raw) continue;
     if (raw.tools && !opts.includeTools) continue;
+    if (window && (at < window.start || at > window.end)) {
+      if (at < window.start) cutBefore = true;
+      else cutAfter = true;
+      continue;
+    }
     if (dropped.has(raw.id)) continue;
     const row: SnapshotItem = {
       ...raw,
+      createdAt: item.createdAt,
       label: raw.label === undefined ? undefined : take(raw.label),
       text: take(raw.text),
       excerpt: "",
@@ -225,6 +260,8 @@ export async function buildChatSnapshot(
     title: take(session.name).slice(0, 120) || "Chat",
     items,
     toolsHidden: !opts.includeTools,
+    cutBefore,
+    cutAfter,
     hits,
   };
 }

package/lib/share/styles.ts

@@ -56,6 +56,8 @@ h1.title{margin:0 0 4px;font-size:20px;line-height:1.3}
 .plan>.kicker{margin-top:12px}
 .kicker{font-size:12px;font-weight:600;color:hsl(var(--muted-foreground));text-transform:uppercase;letter-spacing:.04em}
 .error{color:hsl(var(--destructive));border:1px solid hsl(var(--destructive)/.4);border-radius:10px;padding:8px 14px;white-space:pre-wrap;overflow-wrap:anywhere}
+.cut{display:flex;align-items:center;gap:12px;color:hsl(var(--muted-foreground));font-size:12px;font-style:italic}
+.cut::before,.cut::after{content:"";flex:1;border-top:1px dashed hsl(var(--border))}
 .divider{display:flex;align-items:center;gap:12px;color:hsl(var(--muted-foreground));font-size:12px}
 .divider::before,.divider::after{content:"";flex:1;border-top:1px solid hsl(var(--border))}
 details.tool{border:1px solid hsl(var(--border));border-radius:10px;background:hsl(var(--card))}

package/lib/share/view.ts

@@ -15,6 +15,11 @@ export interface PreviewRequest extends ShareTarget {
   includeTools: boolean;
   /** Messages left out of the share. */
   dropIds?: string[];
+  /** Only the messages from this one to `toId`, both included; either end open when absent. */
+  fromId?: string;
+  toId?: string;
+  /** Just the list of messages, no page: what the range picker needs first. */
+  listOnly?: boolean;
 }
 
 export interface PreviewItem {
@@ -22,11 +27,17 @@ export interface PreviewItem {
   type: string;
   tools: boolean;
   excerpt: string;
+  createdAt?: number;
 }
 
 /** Download formats a server can make; the client lists what it is told. */
 export type ShareFormat = "pdf" | "html" | "md";
 
+export interface MessageList {
+  /** Every shareable message in order, tool rows included. */
+  items: PreviewItem[];
+}
+
 export interface SharePreview {
   html: string;
   markdown: string;

package/lib/welcome-url.ts

@@ -1,5 +1,5 @@
 // The welcome has its own address: `/?welcome=<step>`, beside `?settings=`
-// and `?session=`. `/welcome` redirects here.
+// and a session's `/s/<name>-<id8>`. `/welcome` redirects here.
 
 export const WELCOME_PARAM = "welcome";
 

package/next.config.ts

@@ -13,6 +13,10 @@ const nextConfig: NextConfig = {
   experimental: {
     agentUpgrade: false,
   },
+  // A session's readable address (lib/session-url) is the same one page.
+  async rewrites() {
+    return { beforeFiles: [{ source: "/s/:ref", destination: "/" }] };
+  },
   turbopack: {
     root: resolve(import.meta.dirname),
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saadnvd1/agent-os",
-  "version": "0.3.768",
+  "version": "0.3.775",
   "description": "Self-hosted web UI for managing Claude Code sessions",
   "bin": {
     "agent-os": "scripts/agent-os"

package/stores/chatJump.ts

@@ -4,7 +4,11 @@ import { bookmarksUiActions } from "@/stores/bookmarksUi";
 // Opens a chat by its address, then takes it to one message (bookmarks and
 // search both end here). The chat takes the jump once it is on screen.
 export function openChatAt(sessionId: string, itemId: string): void {
-  window.history.pushState(null, "", hrefWithSession(location.href, sessionId));
+  window.history.pushState(
+    null,
+    "",
+    hrefWithSession(location.href, { id: sessionId })
+  );
   window.dispatchEvent(new PopStateEvent("popstate"));
   bookmarksUiActions.jump(sessionId, itemId);
 }

package/stores/palette.ts

@@ -1,5 +1,9 @@
 import { proxy, ref } from "valtio";
-import { PaletteRegistry, type PaletteCommand } from "@/lib/palette/registry";
+import {
+  PaletteRegistry,
+  type PaletteCommand,
+  type PaletteTab,
+} from "@/lib/palette/registry";
 
 // A one-off choice in the palette (which project, which machine), in place
 // of its commands. ⌘1-9 picks the first nine.
@@ -8,20 +12,18 @@ export interface PalettePicker {
   items: PaletteCommand[];
 }
 
-export type PaletteMode = "commands" | "conversations";
-
 export const paletteUi = proxy<{
   open: boolean;
   picker: PalettePicker | null;
-  mode: PaletteMode;
-  // What was typed when the mode changed, so the other mode starts with it.
+  tab: PaletteTab;
+  // What was typed when the tab changed, so a body that mounts starts with it.
   query: string;
-}>({ open: false, picker: null, mode: "commands", query: "" });
+}>({ open: false, picker: null, tab: "all", query: "" });
 
 export const paletteActions = {
   open: () => {
     paletteUi.picker = null;
-    paletteUi.mode = "commands";
+    paletteUi.tab = "all";
     paletteUi.query = "";
     paletteUi.open = true;
   },
@@ -29,17 +31,17 @@ export const paletteActions = {
     paletteUi.open = open;
     if (!open) {
       paletteUi.picker = null;
-      paletteUi.mode = "commands";
+      paletteUi.tab = "all";
       paletteUi.query = "";
     }
   },
-  setMode: (mode: PaletteMode, query = "") => {
+  setTab: (tab: PaletteTab, query = "") => {
     paletteUi.picker = null;
-    paletteUi.mode = mode;
+    paletteUi.tab = tab;
     paletteUi.query = query;
   },
   pick: (placeholder: string, items: PaletteCommand[]) => {
-    paletteUi.mode = "commands";
+    paletteUi.tab = "all";
     paletteUi.picker = ref({
       placeholder,
       items: items.map((c, i) => (i < 9 ? { ...c, hint: `⌘${i + 1}` } : c)),

package/stores/shareUi.ts

@@ -5,7 +5,12 @@ import type { ShareTarget } from "@/data/shares";
 // menu, the pane or the artifact card.
 // A page's version, when it has more than one, is named in the title; the
 // share is of that exact version.
-export type ShareUiTarget = ShareTarget & { title: string; version?: number };
+// A chat share can start from one message ("Share from here").
+export type ShareUiTarget = ShareTarget & {
+  title: string;
+  version?: number;
+  fromId?: string;
+};
 
 export const shareUi = proxy<{
   target: ShareUiTarget | null;