@saadnvd1/agent-os 0.3.479 → 0.3.482

package/components/Chat/timeline-selection.test.ts

@@ -0,0 +1,146 @@
+import "./composer/test-dom";
+import { act, createElement } from "react";
+import { createRoot, type Root } from "react-dom/client";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import type { ChatItem } from "@/lib/chat/events";
+import { groupTimeline } from "@/lib/chat/group";
+import { copySelection } from "./copy-selection";
+import { TimelineRows } from "./ChatPanel";
+
+(
+  globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }
+).IS_REACT_ACT_ENVIRONMENT = true;
+
+const user = (id: string, text: string): ChatItem => ({
+  id,
+  kind: "user",
+  createdAt: 1,
+  text,
+  tagged: true,
+});
+const reply = (id: string, text: string, streaming = false): ChatItem => ({
+  id,
+  kind: "assistant",
+  createdAt: 2,
+  text,
+  streaming,
+});
+
+describe("the conversation's rows", () => {
+  let host: HTMLElement;
+  let root: Root;
+  const actions = () => ({ respond: vi.fn() }) as never;
+  const show = (items: ChatItem[], a = actions()) =>
+    act(() =>
+      root.render(
+        createElement(TimelineRows, {
+          blocks: groupTimeline(items),
+          actions: a,
+        })
+      )
+    );
+  const rows = () => [...host.querySelectorAll("[data-block]")];
+
+  beforeEach(() => {
+    host = document.createElement("div");
+    document.body.append(host);
+    root = createRoot(host);
+  });
+  afterEach(() => {
+    act(() => root.unmount());
+    host.remove();
+    document.getSelection()?.removeAllRanges();
+  });
+
+  it("keeps a selection across messages through streaming updates", async () => {
+    const items = [
+      user("u1", "first"),
+      reply("a1", "second", true),
+      user("u2", "third"),
+    ];
+    await show(items);
+    const [r1, , r3] = rows();
+    const range = document.createRange();
+    range.setStart(r1, 0);
+    range.setEnd(r3, r3.childNodes.length);
+    document.getSelection()!.removeAllRanges();
+    document.getSelection()!.addRange(range);
+
+    await show([
+      items[0],
+      reply("a1", "second, and more words streamed in", true),
+      items[2],
+      reply("a2", "a new reply at the end", true),
+    ]);
+    await show(
+      [
+        items[0],
+        reply("a1", "second, and more words streamed in", false),
+        items[2],
+        reply("a2", "a new reply at the end, done", false),
+      ],
+      actions()
+    );
+
+    const after = rows();
+    expect(after).toHaveLength(4);
+    expect(after[0]).toBe(r1);
+    expect(after[2]).toBe(r3);
+    expect(r1.isConnected && r3.isConnected).toBe(true);
+    expect(after.map((r) => r.getAttribute("data-block"))).toEqual([
+      "u1",
+      "a1",
+      "u2",
+      "a2",
+    ]);
+    const sel = document.getSelection()!;
+    expect(sel.rangeCount).toBe(1);
+    expect(sel.isCollapsed).toBe(false);
+    expect(sel.getRangeAt(0).startContainer).toBe(r1);
+    expect(sel.getRangeAt(0).endContainer).toBe(r3);
+  });
+
+  describe("copying", () => {
+    const copy = (items: ChatItem[]) => {
+      const data: Record<string, string> = {};
+      const e = {
+        currentTarget: host,
+        clipboardData: { setData: (t: string, v: string) => (data[t] = v) },
+        preventDefault: vi.fn(),
+      };
+      copySelection(e as never, new Map(items.map((i) => [i.id, i])));
+      return { data, prevented: e.preventDefault.mock.calls.length > 0 };
+    };
+
+    it("gives speakers and blank lines across messages, from their source", async () => {
+      const items = [
+        user("u1", "fix `the` bug"),
+        reply("a1", "Done.\n\n- one\n- two"),
+        user("u2", "thanks"),
+      ];
+      await show(items);
+      const [r1, , r3] = rows();
+      const range = document.createRange();
+      range.selectNodeContents(host);
+      range.setStart(r1, 0);
+      range.setEnd(r3, r3.childNodes.length);
+      document.getSelection()!.addRange(range);
+      const { data, prevented } = copy(items);
+      expect(prevented).toBe(true);
+      expect(data["text/plain"]).toBe(
+        "User:\nfix `the` bug\n\nAssistant:\nDone.\n\n- one\n- two\n\nUser:\nthanks"
+      );
+    });
+
+    it("leaves a selection inside one message to the browser", async () => {
+      const items = [user("u1", "first"), reply("a1", "second words")];
+      await show(items);
+      const text = rows()[1].querySelector("p")!.firstChild!;
+      const range = document.createRange();
+      range.setStart(text, 1);
+      range.setEnd(text, 4);
+      document.getSelection()!.addRange(range);
+      expect(copy(items)).toEqual({ data: {}, prevented: false });
+    });
+  });
+});

package/components/Orchestrator/OrchestratorBar.tsx

@@ -8,6 +8,8 @@ import { usePauseOrchestrator } from "@/data/orchestrators";
 import { useOrchestratorHeader } from "@/hooks/useOrchestratorHeader";
 import { headerParts } from "@/lib/orchestrator/header-line";
 import { cn } from "@/lib/utils";
+import { useSchedulesGlance } from "@/components/SessionList/useSchedulesGlance";
+import { schedulesUiActions } from "@/stores/schedulesUi";
 import { NO_PASSKEYS_HERE, passkeysHere } from "@/data/presence";
 import { AsksList } from "./AsksList";
 
@@ -21,6 +23,7 @@ export const OrchestratorBar = memo(function OrchestratorBar({
 }) {
   const { overview, counts } = useOrchestratorHeader(workspaceId);
   const pause = usePauseOrchestrator(workspaceId);
+  const { upcomingText } = useSchedulesGlance(workspaceId);
   const [open, setOpen] = useState(true);
   const canProve = useSyncExternalStore(
     () => () => {},
@@ -73,6 +76,15 @@ export const OrchestratorBar = memo(function OrchestratorBar({
           {counts.paused ? "Resume" : "Pause"}
         </Button>
       </div>
+      {upcomingText && (
+        <button
+          type="button"
+          onClick={() => schedulesUiActions.open(workspaceId)}
+          className="text-muted-foreground hover:text-foreground flex min-h-11 w-full items-center px-1 text-left text-xs md:min-h-8"
+        >
+          {upcomingText}
+        </button>
+      )}
       {counts.paused && (
         <p className="text-muted-foreground px-1 text-xs">
           Paused: events wait and it won&apos;t start, merge or message anything

package/components/Schedules/ScheduleForm.tsx

@@ -31,8 +31,10 @@ import {
   minGapMinutes,
   nextRuns,
   presetCron,
+  wall,
   type PresetKind,
 } from "@/lib/schedules/cron";
+import { parseWhen, relativeTime } from "@/lib/schedules/when";
 
 const KINDS: { value: ScheduleKind; label: string; hint: string }[] = [
   {
@@ -57,7 +59,10 @@ const KINDS: { value: ScheduleKind; label: string; hint: string }[] = [
   },
 ];
 
-const PRESETS: { value: PresetKind | "custom"; label: string }[] = [
+type Preset = PresetKind | "custom" | "once";
+
+const PRESETS: { value: Preset; label: string }[] = [
+  { value: "once", label: "Once" },
   { value: "every", label: "Every…" },
   { value: "hourly", label: "Hourly" },
   { value: "daily", label: "Daily" },
@@ -115,6 +120,17 @@ function Segmented<T extends string>({
   );
 }
 
+const pad = (n: number) => String(n).padStart(2, "0");
+
+// The date and time inputs' values for an instant, as the zone's wall clock.
+function wallParts(ms: number, tz: string) {
+  const w = wall(ms, tz);
+  return {
+    date: `${w.y}-${pad(w.m)}-${pad(w.d)}`,
+    time: `${pad(w.h)}:${pad(w.mi)}`,
+  };
+}
+
 const Field = ({
   label,
   children,
@@ -148,7 +164,8 @@ export function ScheduleForm({
   const update = useUpdateSchedule();
   const mutation = existing ? update : create;
 
-  const initialPreset = existing ? cronPreset(existing.cron) : null;
+  const initialPreset =
+    existing && existing.run_at == null ? cronPreset(existing.cron) : null;
   const [wsId, setWsId] = useState(
     existing?.workspace_id ?? workspaceId ?? workspaces[0]?.id ?? ""
   );
@@ -161,9 +178,24 @@ export function ScheduleForm({
   );
   const [projectId, setProjectId] = useState(existing?.project_id ?? "");
   const [prompt, setPrompt] = useState(existing?.prompt ?? "");
-  const [preset, setPreset] = useState<PresetKind | "custom">(
-    existing ? (initialPreset?.kind ?? "custom") : draft ? "every" : "weekdays"
+  const [preset, setPreset] = useState<Preset>(
+    existing?.run_at != null
+      ? "once"
+      : existing
+        ? (initialPreset?.kind ?? "custom")
+        : draft
+          ? "every"
+          : "weekdays"
+  );
+  // A new one-off starts an hour out.
+  const [initialAt] = useState(() =>
+    wallParts(
+      existing?.run_at ?? Date.now() + 3_600_000,
+      existing?.timezone ?? DEFAULT_TIMEZONE
+    )
   );
+  const [atDate, setAtDate] = useState(initialAt.date);
+  const [atTime, setAtTime] = useState(initialAt.time);
   const [every, setEvery] = useState(initialPreset?.every ?? 30);
   const [hour, setHour] = useState(initialPreset?.hour ?? 9);
   const [minute, setMinute] = useState(initialPreset?.minute ?? 0);
@@ -197,12 +229,14 @@ export function ScheduleForm({
     .sort((a, b) => a.name.localeCompare(b.name));
   const target = targets.find((s) => s.id === targetId)?.id ?? "";
 
-  const cron =
-    preset === "custom"
+  const once = preset === "once";
+  const cron = once
+    ? ""
+    : preset === "custom"
       ? custom.trim()
       : presetCron({ kind: preset, hour, minute, weekday, every });
   const tzOk = isTimezone(timezone);
-  const cronProblem = cronError(cron);
+  const cronProblem = once ? null : cronError(cron);
   // The preview counts from now, kept fresh while the form is open.
   const [openedAt, setOpenedAt] = useState(() => Date.now());
   useEffect(() => {
@@ -214,13 +248,32 @@ export function ScheduleForm({
     [cron, cronProblem, timezone, tzOk, openedAt]
   );
 
+  // The picked wall time in the zone, or null while it's incomplete.
+  const runAt = useMemo(() => {
+    if (!once || !tzOk || !atDate || !atTime) return null;
+    try {
+      return parseWhen(`${atDate}T${atTime}`, timezone);
+    } catch {
+      return null;
+    }
+  }, [once, tzOk, atDate, atTime, timezone]);
+  // Saving a done one-off at its old time can't reopen it; a new time must be ahead.
+  const atProblem =
+    once && tzOk
+      ? runAt === null
+        ? "Pick a date and time"
+        : runAt <= openedAt && runAt !== existing?.run_at
+          ? "That time has passed"
+          : null
+      : null;
+
   const submit = (e: React.FormEvent) => {
     e.preventDefault();
     const input = {
       workspaceId: workspace,
       projectId: project || null,
       name,
-      cron,
+      ...(once ? { at: runAt } : { cron }),
       timezone,
       prompt,
       kind,
@@ -242,10 +295,11 @@ export function ScheduleForm({
   const tooOften = useMemo(
     () =>
       minGap > 0 &&
+      !once &&
       !cronProblem &&
       tzOk &&
       minGapMinutes(cron, timezone, openedAt) < minGap,
-    [minGap, cron, cronProblem, timezone, tzOk, openedAt]
+    [minGap, once, cron, cronProblem, timezone, tzOk, openedAt]
   );
 
   const ready =
@@ -253,6 +307,7 @@ export function ScheduleForm({
     prompt.trim() &&
     workspace &&
     !cronProblem &&
+    !atProblem &&
     tzOk &&
     !tooOften &&
     (kind === "message" ? target : kind === "orchestrator" || project);
@@ -362,7 +417,24 @@ export function ScheduleForm({
             setPreset(v);
           }}
         />
-        {preset === "custom" ? (
+        {once ? (
+          <div className="flex flex-wrap gap-2">
+            <Input
+              type="date"
+              aria-label="Date"
+              value={atDate}
+              onChange={(e) => setAtDate(e.target.value)}
+              className="h-11 w-44 md:h-9"
+            />
+            <Input
+              type="time"
+              aria-label="Time"
+              value={atTime}
+              onChange={(e) => setAtTime(e.target.value)}
+              className="h-11 w-32 md:h-9"
+            />
+          </div>
+        ) : preset === "custom" ? (
           <Input
             aria-label="Cron expression"
             value={custom}
@@ -450,10 +522,20 @@ export function ScheduleForm({
           className="text-muted-foreground h-11 md:h-8 md:text-xs"
         />
         <div className="bg-primary/[0.06] rounded-lg px-3 py-2.5 text-sm">
-          {cronProblem || !tzOk ? (
+          {cronProblem || !tzOk || atProblem ? (
             <p className="text-destructive">
-              {cronProblem ?? `Unknown time zone "${timezone}"`}
+              {!tzOk
+                ? `Unknown time zone "${timezone}"`
+                : (cronProblem ?? atProblem)}
             </p>
+          ) : once && runAt !== null ? (
+            <>
+              <p className="font-medium">{formatRunTime(runAt, timezone)}</p>
+              <p className="text-muted-foreground mt-1 text-xs">
+                Runs once, {relativeTime(runAt, openedAt)}, then turns itself
+                off.
+              </p>
+            </>
           ) : (
             <>
               <p className="font-medium">{describeCron(cron)}</p>

package/components/Schedules/SchedulesPanel.tsx

@@ -25,6 +25,7 @@ import {
 } from "@/data/schedules";
 import type { ScheduleView } from "@/lib/schedules";
 import { formatRunTime } from "@/lib/schedules/cron";
+import { relativeTime } from "@/lib/schedules/when";
 import { schedulesUi, schedulesUiActions } from "@/stores/schedulesUi";
 import { ScheduleForm } from "./ScheduleForm";
 import { OutcomeChip, RunHistory } from "./RunHistory";
@@ -50,10 +51,14 @@ const where = (s: ScheduleView) =>
       : "";
 
 function NextRun({ s }: { s: ScheduleView }) {
+  if (s.done_at) return <>Done {formatRunTime(s.done_at, s.timezone)}</>;
   if (!s.enabled) return <>Off</>;
   if (s.paused) return <>Paused with the orchestrator</>;
   return s.nextRunAt ? (
-    <>Next {formatRunTime(s.nextRunAt, s.timezone)}</>
+    <>
+      {s.oneOff ? "Runs" : "Next"} {formatRunTime(s.nextRunAt, s.timezone)}
+      {s.oneOff && ` (${relativeTime(s.nextRunAt)})`}
+    </>
   ) : (
     <>No upcoming run</>
   );
@@ -98,15 +103,44 @@ function ScheduleRow({ s, onOpen }: { s: ScheduleView; onOpen: () => void }) {
           </span>
         </div>
         <p className="text-muted-foreground truncate text-xs">
-          {s.description} · <NextRun s={s} />
+          {s.oneOff ? (
+            <NextRun s={s} />
+          ) : (
+            <>
+              {s.description} · <NextRun s={s} />
+            </>
+          )}
+          {s.oneOff && ` · by ${s.createdBy.name}`}
         </p>
       </div>
       {s.lastRun && <OutcomeChip run={s.lastRun} />}
-      <EnableSwitch s={s} />
+      {!s.done_at && <EnableSwitch s={s} />}
     </div>
   );
 }
 
+function Group({
+  title,
+  rows,
+  onOpen,
+}: {
+  title: string;
+  rows: ScheduleView[];
+  onOpen: (id: string) => void;
+}) {
+  if (rows.length === 0) return null;
+  return (
+    <section className="space-y-2">
+      <h4 className="text-muted-foreground px-1 text-xs font-medium">
+        {title} · {rows.length}
+      </h4>
+      {rows.map((s) => (
+        <ScheduleRow key={s.id} s={s} onOpen={() => onOpen(s.id)} />
+      ))}
+    </section>
+  );
+}
+
 function Detail({
   id,
   onEdit,
@@ -134,11 +168,12 @@ function Detail({
       <div className="space-y-1">
         <div className="flex items-center gap-2">
           <h3 className="min-w-0 flex-1 truncate font-semibold">{s.name}</h3>
-          <EnableSwitch s={s} />
+          {!s.done_at && <EnableSwitch s={s} />}
         </div>
         <p className="text-muted-foreground text-sm">
           {KIND_LABEL[s.kind]}
           {where(s)} · {s.description}
+          {s.oneOff && ` · by ${s.createdBy.name}`}
         </p>
         <p className="text-muted-foreground text-xs">
           <NextRun s={s} /> · {s.timezone}
@@ -151,7 +186,7 @@ function Detail({
         <Button
           size="sm"
           className="h-11 md:h-8"
-          disabled={run.isPending}
+          disabled={run.isPending || !!s.done_at}
           onClick={() => run.mutate(s.id)}
         >
           <Play className="h-3.5 w-3.5" />
@@ -174,7 +209,7 @@ function Detail({
             disabled={archive.isPending}
             onClick={() => archive.mutate(s.id, { onSuccess: onGone })}
           >
-            Remove (keeps history)
+            {s.oneOff && !s.done_at ? "Cancel it" : "Remove (keeps history)"}
           </Button>
         ) : (
           <Button
@@ -184,7 +219,7 @@ function Detail({
             onClick={() => setConfirm(true)}
           >
             <Trash2 className="h-3.5 w-3.5" />
-            Remove
+            {s.oneOff && !s.done_at ? "Cancel" : "Remove"}
           </Button>
         )}
       </div>
@@ -300,13 +335,24 @@ export function SchedulesPanel() {
               </p>
             </div>
           )}
-          {schedules.map((s) => (
-            <ScheduleRow
-              key={s.id}
-              s={s}
-              onOpen={() => setView({ mode: "detail", id: s.id })}
-            />
-          ))}
+          {(() => {
+            const open = (id: string) => setView({ mode: "detail", id });
+            const upcoming = schedules
+              .filter((s) => s.oneOff && !s.done_at)
+              .sort((a, b) => (a.run_at ?? 0) - (b.run_at ?? 0));
+            const done = schedules.filter((s) => s.done_at);
+            return (
+              <>
+                <Group title="Upcoming" rows={upcoming} onOpen={open} />
+                <Group
+                  title="Recurring"
+                  rows={schedules.filter((s) => !s.oneOff)}
+                  onOpen={open}
+                />
+                <Group title="Done" rows={done} onOpen={open} />
+              </>
+            );
+          })()}
           {!isPending && <PhoneLine />}
         </div>
       )}

package/components/SessionList/SidebarHeader.tsx

@@ -97,7 +97,7 @@ export function SidebarHeader(props: SidebarHeaderProps) {
             // Opens Settings > Schedules.
             menuItem("Schedules", () => schedulesUiActions.open(workspaceId), {
               icon: Clock,
-              description: schedules.nextText,
+              description: schedules.upcomingText ?? schedules.nextText,
               badge: schedules.failed > 0 && (
                 <span className="text-destructive flex items-center gap-1.5 text-xs font-medium tabular-nums">
                   <span aria-hidden className={failedDot} />

package/components/SessionList/useSchedulesGlance.ts

@@ -3,12 +3,13 @@
 import { useSchedulesQuery } from "@/data/schedules";
 import { schedulesBadge } from "@/lib/schedules/badge";
 import { formatRunTime } from "@/lib/schedules/cron";
+import { relativeTime } from "@/lib/schedules/when";
 
 // Schedules at a glance for the header's menu: how many failed their last
 // run (a red badge) and when the next one runs (a line under the item).
 export function useSchedulesGlance(workspaceId: string | null) {
   const { data: schedules = [] } = useSchedulesQuery(workspaceId);
-  const { next, failed } = schedulesBadge(schedules);
+  const { next, failed, upcoming, nextUpcoming } = schedulesBadge(schedules);
   const failedText = failed
     ? `${failed} schedule${failed === 1 ? "" : "s"} failed last run`
     : null;
@@ -17,5 +18,8 @@ export function useSchedulesGlance(workspaceId: string | null) {
     : schedules.length
       ? "Nothing scheduled to run"
       : "No schedules yet";
-  return { failed, failedText, nextText };
+  const upcomingText = upcoming
+    ? `${upcoming} upcoming${nextUpcoming ? ` · next ${relativeTime(nextUpcoming.at)}` : ""}`
+    : null;
+  return { failed, failedText, nextText, upcoming, upcomingText };
 }

package/lib/chat/copy-selection.ts

@@ -0,0 +1,58 @@
+import type { ChatItem } from "./events";
+import { eventParts, originOf } from "./origin";
+
+export interface TranscriptPart {
+  speaker: string;
+  text: string;
+}
+
+// Who a message is from when copied, or null for rows that aren't part of the
+// conversation itself (tools, turn markers, plans, approvals...).
+export function speakerOf(item: ChatItem): string | null {
+  switch (item.kind) {
+    case "user": {
+      const origin = originOf(item);
+      if (!origin) return "User";
+      return origin.kind === "decision" ? "Decision" : origin.label;
+    }
+    case "assistant":
+      return "Assistant";
+    case "error":
+      return "Error";
+    default:
+      return null;
+  }
+}
+
+// The whole message as written, for one a selection covers entirely.
+export function sourceText(item: ChatItem): string {
+  switch (item.kind) {
+    case "user": {
+      const origin = originOf(item);
+      if (!origin) return item.text;
+      const { body, decided } = eventParts(item, origin);
+      return [...decided, body].join("\n\n");
+    }
+    case "assistant":
+      return item.text;
+    case "error":
+      return item.message;
+    default:
+      return "";
+  }
+}
+
+// `Speaker:` then the text, a blank line between messages. Neighbours from
+// the same speaker (a reply split around its tools) read as one message.
+export function formatTranscript(parts: TranscriptPart[]): string {
+  const merged: TranscriptPart[] = [];
+  for (const p of parts) {
+    const text = p.text.trim();
+    if (!text) continue;
+    const last = merged.at(-1);
+    if (last && last.speaker === p.speaker)
+      last.text = `${last.text}\n\n${text}`;
+    else merged.push({ speaker: p.speaker, text });
+  }
+  return merged.map((p) => `${p.speaker}:\n${p.text}`).join("\n\n");
+}

package/lib/chat/drivers/demo.ts

@@ -64,7 +64,8 @@ export function demoConversation(stepMs = 40): ChatConversation {
     const words = DEMO_REPLY.split(/(?<= )/);
     let i = 0;
     for (; i < words.length && !stopped && !closed; i++) {
-      await sleep(stepMs);
+      // A step of 0 (tests) streams with no timer per word.
+      if (stepMs) await sleep(stepMs);
       out.push({ type: "delta", id, text: words[i] });
     }
     out.push({