@saadnvd1/agent-os 0.3.833 → 0.3.839

package/lib/fork/note.ts

@@ -0,0 +1,6 @@
+/** The one line the parent's chat keeps where forks were started. */
+
+export const FORK_NOTE_PREFIX = "fork-";
+
+export const startedText = (ns: number[], labels: string[]): string =>
+  `${ns.length === 1 ? `Fork ${ns[0]}` : `Forks ${ns.join(", ")}`} started · ${labels.join(" · ")}`;

package/lib/fork/start.ts

@@ -18,6 +18,7 @@ import { getProject } from "../projects";
 import { limitOf, runningIn, startingIn } from "../tasks/queue-rows";
 import { currentLevel, loadEnabled } from "../load/monitor";
 import { childFirstMessage } from "./brief";
+import { FORK_NOTE_PREFIX, startedText } from "./note";
 import { ForkError, forkConversation } from "./conversation";
 import {
   childrenOf,
@@ -120,7 +121,7 @@ export function startFork(req: ForkRequest): ForkStarted {
     instruction,
     worktree,
   }));
-  const noteId = `fork-${groupId}`;
+  const noteId = `${FORK_NOTE_PREFIX}${groupId}`;
   insertGroup({
     id: groupId,
     parentId: parent.id,
@@ -136,7 +137,10 @@ export function startFork(req: ForkRequest): ForkStarted {
     kind: "note" as const,
     tone: "note" as const,
     createdAt: Date.now(),
-    text: `Forked ${children.length === 1 ? "1 copy" : `${children.length} copies`}: ${children.map((c) => c.label).join(" · ")}`,
+    text: startedText(
+      children.map((c) => numberOf(parent.id, c.childId)),
+      children.map((c) => c.label)
+    ),
   };
   saveItem(parent.id, item);
   emit(parent.id, { type: "item", item });

package/lib/fork/types.ts

@@ -71,6 +71,8 @@ export interface ChildView {
   delivered: boolean;
   // A question or approval it's waiting on.
   asks: string | null;
+  // What it is doing now (its latest tool), while it runs.
+  activity: string | null;
 }
 
 export interface GroupView {

package/lib/fork/view.ts

@@ -1,5 +1,6 @@
 /** What clients and `aos children` show, and the numbers behind them. */
 
+import { lastItems } from "../chat/store";
 import { childrenOf, getGroup } from "./ledger";
 import type { ChildRow, ChildView, GroupView } from "./types";
 
@@ -21,8 +22,16 @@ export const childView = (c: ChildRow): ChildView => ({
   settledAt: c.settled_at,
   delivered: c.delivered_at != null,
   asks: c.state === "needs_input" ? c.hold : null,
+  activity: null,
 });
 
+// The title of the latest tool a running child used, to say what it is doing.
+const activityOf = (c: ChildRow): string | null => {
+  if (c.state !== "running") return null;
+  const tool = lastItems(c.child_session_id, 1, "tool")[0];
+  return tool && tool.kind === "tool" ? tool.title : null;
+};
+
 export function childrenView(parentId: string): {
   children: ChildView[];
   groups: GroupView[];
@@ -45,7 +54,11 @@ export function childrenView(parentId: string): {
       });
   }
   return {
-    children: rows.map((c, i) => ({ ...childView(c), n: i + 1 })),
+    children: rows.map((c, i) => ({
+      ...childView(c),
+      n: i + 1,
+      activity: activityOf(c),
+    })),
     groups,
   };
 }

package/lib/settings/defaults.ts

@@ -0,0 +1,27 @@
+// Every setting's default, in one pure module the server's constants and the
+// settings UI both import, so the two can't disagree (lib/settings/defaults.test).
+// Context sizes are in tokens; 0 is off.
+
+export const SETTING_DEFAULTS = {
+  fresh: {
+    orchestratorTokens: 200_000,
+    taskTokens: 0,
+    compactTokens: 150_000,
+    autoCompactTokens: 300_000,
+    interactiveAutoCompactTokens: 300_000,
+  },
+  // What a switch turns on with when the default is off.
+  freshOnValue: 200_000,
+  stallMinutes: 8,
+  awayWindowMinutes: 60,
+  // Off by default; what the switch turns on with.
+  taskLimitOn: 3,
+  sweepDays: 7,
+} as const;
+
+export type FreshKey = keyof typeof SETTING_DEFAULTS.fresh;
+
+export function freshOnValue(key: FreshKey): number {
+  const d = SETTING_DEFAULTS.fresh[key];
+  return d > 0 ? d : SETTING_DEFAULTS.freshOnValue;
+}

package/lib/settings/parse.ts

@@ -0,0 +1,17 @@
+// A typed number, checked before anything is sent. An invalid one stays in
+// the field with this message; nothing reaches the server.
+export function parseSettingNumber(
+  text: string,
+  { min, max, integer = true }: { min: number; max?: number; integer?: boolean }
+): { value: number } | { error: string } {
+  const t = text.trim();
+  const n = Number(t);
+  const range = max === undefined ? `${min} or more` : `from ${min} to ${max}`;
+  const msg = integer
+    ? `Enter a whole number ${range}.`
+    : `Enter a number ${range}.`;
+  if (!t || !Number.isFinite(n)) return { error: msg };
+  if (integer && !Number.isInteger(n)) return { error: msg };
+  if (n < min || (max !== undefined && n > max)) return { error: msg };
+  return { value: n };
+}

package/lib/settings-url.ts

@@ -8,6 +8,7 @@ export const SETTINGS_SECTIONS = [
   "merging",
   "approvals",
   "workspaces",
+  "context",
   "models",
   "agent-roles",
   "devices",

package/lib/worktree-sweep/limits.ts

@@ -0,0 +1,3 @@
+// The sweep's day range, client-safe: the server (./settings) and the
+// Settings box share it.
+export const MAX_SWEEP_DAYS = 365;

package/lib/worktree-sweep/settings.ts

@@ -5,10 +5,12 @@
 
 import { z } from "zod";
 import { db } from "../db";
+import { SETTING_DEFAULTS } from "../settings/defaults";
+import { MAX_SWEEP_DAYS } from "./limits";
 import type { ResolvedDays } from "./types";
 
-export const DEFAULT_SWEEP_DAYS = 7;
-export const MAX_SWEEP_DAYS = 365;
+export const DEFAULT_SWEEP_DAYS = SETTING_DEFAULTS.sweepDays;
+export { MAX_SWEEP_DAYS } from "./limits";
 
 const GLOBAL_KEY = "worktree_sweep";
 const projectKey = (projectId: string) => `worktree_sweep.project.${projectId}`;

package/package.json

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

package/components/Away/AwayWindowForm.tsx

@@ -1,91 +0,0 @@
-"use client";
-
-import { useState } from "react";
-import { toast } from "sonner";
-import { Button } from "@/components/ui/button";
-import { Input } from "@/components/ui/input";
-import {
-  useAwaySettingsQuery,
-  useUpdateAwaySettings,
-  type AwaySettings,
-} from "@/data/away";
-import {
-  MAX_WINDOW_MINUTES,
-  MIN_WINDOW_MINUTES,
-  parseWindow,
-} from "@/lib/away/window-limits";
-
-// Settings → Workspaces: how recent a session's work must be for Away mode
-// to touch it. App-wide.
-export function AwayWindowForm() {
-  const { data, isPending, isError, error } = useAwaySettingsQuery();
-  if (isPending)
-    return <div className="bg-muted/40 h-24 animate-pulse rounded-lg" />;
-  if (isError)
-    return <p className="text-destructive text-sm">{error.message}</p>;
-  return <Form key={data.windowMinutes} saved={data} />;
-}
-
-function Form({ saved }: { saved: AwaySettings }) {
-  const update = useUpdateAwaySettings();
-  const [text, setText] = useState(String(saved.windowMinutes));
-  const minutes = parseWindow(text);
-  const error =
-    minutes === null
-      ? `A whole number from ${MIN_WINDOW_MINUTES} to ${MAX_WINDOW_MINUTES}`
-      : null;
-  return (
-    <form
-      onSubmit={(e) => {
-        e.preventDefault();
-        if (minutes === null) return;
-        update.mutate(
-          { windowMinutes: minutes },
-          {
-            onSuccess: () => toast.success("Away mode settings saved"),
-            onError: (err) => toast.error(err.message),
-          }
-        );
-      }}
-      className="bg-muted/40 space-y-3 rounded-lg px-3 py-3"
-    >
-      <h3 className="text-sm font-medium">Away mode</h3>
-      <p className="text-muted-foreground text-sm">
-        Away mode works through orchestrators that were busy in this window, and
-        only lists sessions with a real turn inside it. Older ones are left
-        alone: a message wakes an agent and re-reads its whole conversation.
-      </p>
-      <label className="flex items-center justify-between gap-3 text-sm">
-        <span className="text-muted-foreground">Recent means the last</span>
-        <span className="flex items-center gap-2">
-          <Input
-            type="number"
-            inputMode="numeric"
-            min={MIN_WINDOW_MINUTES}
-            max={MAX_WINDOW_MINUTES}
-            step={1}
-            value={text}
-            onChange={(e) => setText(e.target.value)}
-            aria-label="Away window, minutes"
-            aria-invalid={!!error}
-            className="h-11 w-24 text-base sm:h-9 md:text-sm"
-          />
-          <span className="text-muted-foreground">min</span>
-        </span>
-      </label>
-      {error && <p className="text-destructive text-xs">{error}</p>}
-      <div className="flex justify-end">
-        <Button
-          type="submit"
-          size="sm"
-          className="h-11 sm:h-8"
-          disabled={
-            !!error || minutes === saved.windowMinutes || update.isPending
-          }
-        >
-          Save
-        </Button>
-      </div>
-    </form>
-  );
-}

package/components/Workspaces/FreshStartForm.tsx

@@ -1,177 +0,0 @@
-"use client";
-
-import { useState } from "react";
-import { toast } from "sonner";
-import { Button } from "@/components/ui/button";
-import { Input } from "@/components/ui/input";
-import { Switch } from "@/components/ui/switch";
-import type { RefreshSettings } from "@/lib/chat/refresh";
-import { useFreshStartQuery, useUpdateFreshStart } from "@/data/fresh-start";
-import { parseFreshStart } from "./fresh-start";
-
-// When a chat's agent starts a fresh conversation instead of carrying a
-// long one: app-wide, one threshold for orchestrators and one for tasks.
-export function FreshStartForm() {
-  const { data, isPending, isError, error } = useFreshStartQuery();
-  if (isPending)
-    return <div className="bg-muted/40 h-24 animate-pulse rounded-lg" />;
-  if (isError)
-    return <p className="text-destructive text-sm">{error.message}</p>;
-  return (
-    <Form
-      key={`${data.orchestratorTokens}:${data.taskTokens}:${data.compactTokens}:${data.autoCompactTokens}:${data.interactiveAutoCompactTokens}`}
-      saved={data}
-    />
-  );
-}
-
-function Form({ saved }: { saved: RefreshSettings }) {
-  const update = useUpdateFreshStart();
-  const orchestrator = useThreshold(saved.orchestratorTokens, 200);
-  const task = useThreshold(saved.taskTokens, 200);
-  const compact = useThreshold(saved.compactTokens, 150);
-  const midTurn = useThreshold(saved.autoCompactTokens, 300);
-  const interactive = useThreshold(saved.interactiveAutoCompactTokens, 200);
-  const error =
-    orchestrator.error ??
-    task.error ??
-    compact.error ??
-    midTurn.error ??
-    interactive.error;
-  const dirty =
-    !error &&
-    (orchestrator.tokens !== saved.orchestratorTokens ||
-      task.tokens !== saved.taskTokens ||
-      compact.tokens !== saved.compactTokens ||
-      midTurn.tokens !== saved.autoCompactTokens ||
-      interactive.tokens !== saved.interactiveAutoCompactTokens);
-
-  return (
-    <form
-      onSubmit={(e) => {
-        e.preventDefault();
-        if (error) return;
-        update.mutate(
-          {
-            orchestratorTokens: orchestrator.tokens,
-            taskTokens: task.tokens,
-            compactTokens: compact.tokens,
-            autoCompactTokens: midTurn.tokens,
-            interactiveAutoCompactTokens: interactive.tokens,
-          },
-          {
-            onSuccess: () => toast.success("Context settings saved"),
-            onError: (err) => toast.error(err.message),
-          }
-        );
-      }}
-      className="bg-muted/40 space-y-3 rounded-lg px-3 py-3"
-    >
-      <h3 className="text-sm font-medium">Fresh starts</h3>
-      <p className="text-muted-foreground text-sm">
-        When a conversation&apos;s context passes the threshold, its agent
-        starts a new one at the next turn boundary, with its brief. An
-        orchestrator also gets its rules and the workspace&apos;s current state,
-        so nothing is lost. A task keeps only its brief and its branch.
-      </p>
-      <ThresholdRow label="Orchestrators" field={orchestrator} />
-      <ThresholdRow label="Tasks" field={task} />
-      <h3 className="pt-2 text-sm font-medium">Compact</h3>
-      <p className="text-muted-foreground text-sm">
-        Chats and tasks compact twice over. Mid-turn, Claude Code summarizes its
-        own context when a job runs long: set this high, since it happens while
-        the agent is holding its files. Between turns, nothing is in flight, so
-        AgentOS compacts a chat over the smaller size, or idle past its prompt
-        cache, before the next message; the composer offers to first. Either way
-        AgentOS hands the agent its task, scope changes, files and todos back.
-        Your own sessions, in a chat or a terminal, have their own mid-turn
-        size; a terminal can&apos;t be compacted between turns, so that is the
-        only compaction it gets. Orchestrators start fresh instead.
-      </p>
-      <ThresholdRow
-        label="Mid-turn, tasks"
-        field={midTurn}
-        switchLabel="Let a task's agent compact itself mid-turn"
-      />
-      <ThresholdRow
-        label="Mid-turn, your sessions"
-        field={interactive}
-        switchLabel="Let your own sessions compact themselves mid-turn"
-      />
-      <ThresholdRow
-        label="Between turns"
-        field={compact}
-        switchLabel="Compact chats and tasks between turns"
-      />
-      {error && <p className="text-destructive text-xs">{error}</p>}
-      <div className="flex justify-end">
-        <Button
-          type="submit"
-          size="sm"
-          className="h-11 sm:h-8"
-          disabled={!!error || !dirty || update.isPending}
-        >
-          Save
-        </Button>
-      </div>
-    </form>
-  );
-}
-
-function useThreshold(tokens: number, fallbackK: number) {
-  const [on, setOn] = useState(tokens > 0);
-  const [text, setText] = useState(
-    String(tokens > 0 ? tokens / 1000 : fallbackK)
-  );
-  const parsed = parseFreshStart(on, text);
-  return {
-    on,
-    setOn,
-    text,
-    setText,
-    tokens: "tokens" in parsed ? parsed.tokens : tokens,
-    error: "error" in parsed ? parsed.error : null,
-  };
-}
-
-function ThresholdRow({
-  label,
-  field,
-  switchLabel,
-}: {
-  label: string;
-  field: ReturnType<typeof useThreshold>;
-  switchLabel?: string;
-}) {
-  return (
-    <div className="space-y-2">
-      <label className="flex min-h-11 items-center justify-between gap-3 text-sm md:min-h-9">
-        {label}
-        <Switch
-          checked={field.on}
-          onCheckedChange={field.setOn}
-          aria-label={switchLabel ?? `Fresh starts for ${label.toLowerCase()}`}
-        />
-      </label>
-      {field.on && (
-        <label className="flex items-center justify-between gap-3 text-sm">
-          <span className="text-muted-foreground">At</span>
-          <span className="flex items-center gap-2">
-            <Input
-              type="number"
-              inputMode="numeric"
-              min={50}
-              step={10}
-              value={field.text}
-              onChange={(e) => field.setText(e.target.value)}
-              aria-label={`${label} threshold, thousands of tokens`}
-              aria-invalid={!!field.error}
-              className="h-11 w-24 text-base sm:h-9 md:text-sm"
-            />
-            <span className="text-muted-foreground">k tokens</span>
-          </span>
-        </label>
-      )}
-    </div>
-  );
-}

package/components/Workspaces/StallForm.tsx

@@ -1,101 +0,0 @@
-"use client";
-
-import { useState } from "react";
-import { toast } from "sonner";
-import { Button } from "@/components/ui/button";
-import { Input } from "@/components/ui/input";
-import { Switch } from "@/components/ui/switch";
-import { useStallQuery, useUpdateStall } from "@/data/stall";
-import {
-  DEFAULT_STALL_MINUTES,
-  MAX_STALL_MINUTES,
-  MIN_STALL_MINUTES,
-} from "@/lib/chat/stall-limits";
-
-// How long a turn may produce nothing before it's flagged stalled and the
-// workspace's orchestrator is told: app-wide.
-export function StallForm() {
-  const { data, isPending, isError, error } = useStallQuery();
-  if (isPending)
-    return <div className="bg-muted/40 h-24 animate-pulse rounded-lg" />;
-  if (isError)
-    return <p className="text-destructive text-sm">{error.message}</p>;
-  return <Form key={data.minutes} saved={data.minutes} />;
-}
-
-function Form({ saved }: { saved: number }) {
-  const update = useUpdateStall();
-  const [on, setOn] = useState(saved > 0);
-  const [text, setText] = useState(
-    String(saved > 0 ? saved : DEFAULT_STALL_MINUTES)
-  );
-  const n = Number(text);
-  const valid =
-    Number.isInteger(n) && n >= MIN_STALL_MINUTES && n <= MAX_STALL_MINUTES;
-  const minutes = on ? n : 0;
-  const error =
-    on && !valid
-      ? `Between ${MIN_STALL_MINUTES} and ${MAX_STALL_MINUTES} minutes`
-      : null;
-  const dirty = !error && minutes !== saved;
-
-  return (
-    <form
-      onSubmit={(e) => {
-        e.preventDefault();
-        if (error) return;
-        update.mutate(minutes, {
-          onSuccess: () => toast.success("Stall alert saved"),
-          onError: (err) => toast.error(err.message),
-        });
-      }}
-      className="bg-muted/40 space-y-3 rounded-lg px-3 py-3"
-    >
-      <h3 className="text-sm font-medium">Stalled turns</h3>
-      <p className="text-muted-foreground text-sm">
-        A turn that produces nothing for this long (no text, tool call or
-        result) shows as stalled, and the workspace&apos;s orchestrator is told
-        once. A long command that is still printing, or a background command the
-        agent is waiting on, isn&apos;t a stall.
-      </p>
-      <label className="flex min-h-11 items-center justify-between gap-3 text-sm md:min-h-9">
-        Flag stalled turns
-        <Switch
-          checked={on}
-          onCheckedChange={setOn}
-          aria-label="Flag stalled turns"
-        />
-      </label>
-      {on && (
-        <label className="flex items-center justify-between gap-3 text-sm">
-          <span className="text-muted-foreground">After</span>
-          <span className="flex items-center gap-2">
-            <Input
-              type="number"
-              inputMode="numeric"
-              min={MIN_STALL_MINUTES}
-              max={MAX_STALL_MINUTES}
-              value={text}
-              onChange={(e) => setText(e.target.value)}
-              aria-label="Stall threshold, minutes"
-              aria-invalid={!!error}
-              className="h-11 w-24 text-base sm:h-9 md:text-sm"
-            />
-            <span className="text-muted-foreground">minutes</span>
-          </span>
-        </label>
-      )}
-      {error && <p className="text-destructive text-xs">{error}</p>}
-      <div className="flex justify-end">
-        <Button
-          type="submit"
-          size="sm"
-          className="h-11 sm:h-8"
-          disabled={!!error || !dirty || update.isPending}
-        >
-          Save
-        </Button>
-      </div>
-    </form>
-  );
-}

package/components/Workspaces/TaskLimitForm.tsx

@@ -1,84 +0,0 @@
-"use client";
-
-import { useState } from "react";
-import { toast } from "sonner";
-import { Button } from "@/components/ui/button";
-import { Input } from "@/components/ui/input";
-import { Switch } from "@/components/ui/switch";
-import type { Workspace } from "@/lib/db";
-import { useUpdateWorkspace } from "@/data/workspaces";
-import { parseTaskLimit } from "./task-limit";
-
-// How many tasks the workspace runs at once. Off by default; over the limit
-// a new task is queued and starts by itself when one finishes.
-export function TaskLimitForm({ workspace }: { workspace: Workspace }) {
-  const update = useUpdateWorkspace();
-  const current = workspace.max_running_tasks;
-  const [on, setOn] = useState(current !== null);
-  const [text, setText] = useState(String(current ?? 3));
-  const parsed = parseTaskLimit(on, text);
-  const dirty = !("error" in parsed) && parsed.limit !== current;
-
-  return (
-    <form
-      onSubmit={(e) => {
-        e.preventDefault();
-        if ("error" in parsed) return;
-        update.mutate(
-          { id: workspace.id, maxRunningTasks: parsed.limit },
-          {
-            onSuccess: () =>
-              toast.success(
-                parsed.limit
-                  ? `Up to ${parsed.limit} tasks run at once`
-                  : "No running task limit"
-              ),
-            onError: (error) => toast.error(error.message),
-          }
-        );
-      }}
-      className="space-y-4"
-    >
-      <label className="flex min-h-11 items-center justify-between gap-3 text-sm md:min-h-9">
-        Limit running tasks
-        <Switch
-          checked={on}
-          onCheckedChange={setOn}
-          aria-label="Limit running tasks"
-        />
-      </label>
-      {on && (
-        <label className="flex items-center justify-between gap-3 text-sm">
-          <span>At most</span>
-          <span className="flex items-center gap-2">
-            <Input
-              type="number"
-              inputMode="numeric"
-              min={1}
-              step={1}
-              value={text}
-              onChange={(e) => setText(e.target.value)}
-              aria-label="Running task limit"
-              aria-invalid={"error" in parsed}
-              className="h-11 w-20 text-base sm:h-9 md:text-sm"
-            />
-            <span className="text-muted-foreground">at a time</span>
-          </span>
-        </label>
-      )}
-      {"error" in parsed && (
-        <p className="text-destructive text-xs">{parsed.error}</p>
-      )}
-      <div className="flex justify-end">
-        <Button
-          type="submit"
-          size="sm"
-          className="h-11 sm:h-8"
-          disabled={"error" in parsed || !dirty || update.isPending}
-        >
-          Save
-        </Button>
-      </div>
-    </form>
-  );
-}

package/components/Workspaces/fresh-start.ts

@@ -1,19 +0,0 @@
-import {
-  MAX_REFRESH_TOKENS,
-  MIN_REFRESH_TOKENS,
-} from "@/lib/chat/refresh-limits";
-
-// A threshold's input, in thousands of tokens: off is 0; on takes a whole
-// number in the range the server holds (lib/chat/refresh).
-export function parseFreshStart(
-  on: boolean,
-  text: string
-): { tokens: number } | { error: string } {
-  if (!on) return { tokens: 0 };
-  const k = Number(text.trim());
-  const min = MIN_REFRESH_TOKENS / 1000;
-  const max = MAX_REFRESH_TOKENS / 1000;
-  if (!text.trim() || !Number.isInteger(k) || k < min || k > max)
-    return { error: `A whole number from ${min} to ${max}` };
-  return { tokens: k * 1000 };
-}