@saadnvd1/agent-os 0.3.502 → 0.3.505

package/README.md

@@ -1084,6 +1084,53 @@ to each idle or stopped session, and `aos done --all-idle` does the same
 sweep. A clean-up never merges: open PRs are listed for their own done.
 `aos done` reaches only sessions in the caller's workspace (or project).
 
+### Session logs
+
+When a task merges, AgentOS writes a log of it. It costs no model tokens: the
+log is a fixed template filled from records AgentOS already holds, and nothing
+that makes it can call a model (a test holds it to that). Dropped tasks get
+none.
+
+A log holds:
+
+- **Header:** task name and id, workspace, project, branch, PR number and
+  link, merge commit, start, merge time and duration.
+- **Brief:** the task's prompt and every scope change recorded on it, in
+  order.
+- **Plan:** `.agentos/plan.md`, read at the merge before cleanup removes the
+  worktree. A task with no plan says so.
+- **Timeline:** PR opened, gate failures per commit (CI with the failing
+  check's name, review, scope), each review and scope verdict per commit with
+  its text trimmed, escalations to you and your answers, and the merge.
+- **Usage:** tokens, estimated cost and model per role, from the usage ledger.
+- **Outcome:** the task agent's last message, verbatim.
+- **Links:** the PR and the session.
+
+Text from tasks, CI and reviewers is untrusted. It is written inside fences
+or code spans, so it can't add headings or links to the document, and
+credential-shaped strings are redacted.
+
+The database is the record: `session_logs`, one row per task, never deleted.
+Each log is also written to
+`~/.agent-os/session-logs/<workspace>/<project>/YYYY-MM-DD-<task>.md`. A
+project's settings have a **Session log folder** (an absolute or `~` path) to
+put its files elsewhere; a folder inside the project's repository is refused,
+because repositories can be public, and the files are never written into one.
+The same dialog lists the project's logs, newest first, and a merged task's
+view has a **Log** tab. The orchestrator reads them with its `logs` tool: the
+latest headers of a workspace or project, or one log in full. It only reads.
+
+The log is made once per task, in the background, from wherever the merge
+happens: a sign-off, Done, a stack landing, or a merge seen on GitHub. A
+failure is logged and never reaches the merge. For tasks that merged before
+this existed:
+
+```bash
+npx tsx scripts/backfill-session-logs.ts --db <path to agent-os.db> [--no-gh] [--dry]
+```
+
+Their plan files are gone, so those logs say "plan not kept".
+
 ### Orchestrator
 
 Each workspace has one standing orchestrator, pinned at the top of its

package/app/api/projects/[id]/session-logs/route.ts

@@ -0,0 +1,39 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getProject } from "@/lib/projects";
+import { DEFAULT_ROOT } from "@/lib/session-logs/folder";
+import { listLogs, logFolder, setLogFolder } from "@/lib/session-logs";
+
+interface RouteParams {
+  params: Promise<{ id: string }>;
+}
+
+function state(id: string) {
+  return {
+    folder: logFolder(id),
+    defaultFolder: DEFAULT_ROOT(),
+    logs: listLogs({ projectId: id }, 100),
+  };
+}
+
+// The project's merged-task logs, newest first, and its log folder setting.
+export async function GET(_request: NextRequest, { params }: RouteParams) {
+  const { id } = await params;
+  if (!getProject(id))
+    return NextResponse.json({ error: "Project not found" }, { status: 404 });
+  return NextResponse.json(state(id));
+}
+
+// A folder inside the project's repository is refused with the reason.
+export async function PUT(request: NextRequest, { params }: RouteParams) {
+  const { id } = await params;
+  if (!getProject(id))
+    return NextResponse.json({ error: "Project not found" }, { status: 404 });
+  try {
+    const { folder } = await request.json();
+    setLogFolder(id, typeof folder === "string" ? folder : null);
+    return NextResponse.json(state(id));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return NextResponse.json({ error: message }, { status: 400 });
+  }
+}

package/app/api/session-logs/[id]/route.ts

@@ -0,0 +1,18 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getLog, headerOf } from "@/lib/session-logs";
+
+interface RouteParams {
+  params: Promise<{ id: string }>;
+}
+
+// One task's log: its header fields and the markdown.
+export async function GET(_request: NextRequest, { params }: RouteParams) {
+  const { id } = await params;
+  const row = getLog(id);
+  if (!row)
+    return NextResponse.json(
+      { error: "No log for this task" },
+      { status: 404 }
+    );
+  return NextResponse.json({ header: headerOf(row), markdown: row.markdown });
+}

package/components/Pane/DesktopTabBar.tsx

@@ -1,5 +1,6 @@
 "use client";
 
+import { SessionPrStage } from "@/components/PrStageBadge";
 import { ViewSwitch } from "@/components/Chat/ViewSwitch";
 import { ContextMeter } from "@/components/Chat/ContextMeter";
 import { Button } from "@/components/ui/button";
@@ -16,7 +17,7 @@ import { PaneMenu } from "./PaneMenu";
 import { HostBadge } from "@/components/Hosts/HostBadge";
 import { usePaneBarSlots } from "./PaneBarSlots";
 
-type ViewMode = "terminal" | "files" | "git" | "workers";
+type ViewMode = "terminal" | "files" | "git" | "workers" | "log";
 
 interface Tab {
   id: string;
@@ -34,6 +35,7 @@ interface DesktopTabBarProps {
   viewMode: ViewMode;
   isFocused: boolean;
   isConductor: boolean;
+  hasLog?: boolean;
   workerCount: number;
   canSplit: boolean;
   canClose: boolean;
@@ -61,6 +63,7 @@ export function DesktopTabBar({
   viewMode,
   isFocused,
   isConductor,
+  hasLog,
   workerCount,
   canSplit,
   canClose,
@@ -155,12 +158,14 @@ export function DesktopTabBar({
       <div className="flex shrink-0 items-center gap-1.5">
         <HostBadge hostId={session?.host_id} />
         <ContextMeter sessionId={session?.id} />
+        <SessionPrStage sessionId={session?.id} />
         <ViewSwitch session={session} />
         {session?.working_directory && (
           <PaneViewToggle
             viewMode={viewMode}
             isLocalSession={isLocalSession}
             isConductor={isConductor}
+            hasLog={hasLog}
             workerCount={workerCount}
             gitDrawerOpen={gitDrawerOpen}
             shellDrawerOpen={shellDrawerOpen}

package/components/Pane/MobileTabBar.tsx

@@ -1,5 +1,6 @@
 "use client";
 
+import { SessionPrStage } from "@/components/PrStageBadge";
 import { ViewSwitch } from "@/components/Chat/ViewSwitch";
 import { paletteActions } from "@/stores/palette";
 import { newDraft } from "@/stores/drafts";
@@ -25,6 +26,7 @@ import {
   Terminal as TerminalIcon,
   TextSearch,
   Users,
+  ScrollText,
 } from "lucide-react";
 import { cn } from "@/lib/utils";
 import { useAwayQuery } from "@/data/away";
@@ -34,7 +36,7 @@ import type { LucideIcon } from "lucide-react";
 import { HostBadge } from "@/components/Hosts/HostBadge";
 import { MoveMenuItems } from "@/components/Tasks/MoveMenuItems";
 
-type ViewMode = "terminal" | "files" | "git" | "workers";
+type ViewMode = "terminal" | "files" | "git" | "workers" | "log";
 
 interface ViewModeButtonProps {
   mode: ViewMode;
@@ -79,6 +81,7 @@ interface MobileTabBarProps {
   projects: Project[];
   viewMode: ViewMode;
   isConductor: boolean;
+  hasLog?: boolean;
   workerCount: number;
   onMenuClick?: () => void;
   onViewModeChange: (mode: ViewMode) => void;
@@ -94,6 +97,7 @@ export function MobileTabBar({
   projects,
   viewMode,
   isConductor,
+  hasLog,
   workerCount,
   onMenuClick,
   onViewModeChange,
@@ -317,6 +321,7 @@ export function MobileTabBar({
       >
         <Plus className="h-4 w-4" />
       </Button>
+      <SessionPrStage sessionId={session?.id} />
       <ViewSwitch session={session} />
 
       {/* View mode toggle */}
@@ -344,6 +349,14 @@ export function MobileTabBar({
               onClick={onViewModeChange}
             />
           )}
+          {hasLog && (
+            <ViewModeButton
+              mode="log"
+              currentMode={viewMode}
+              icon={ScrollText}
+              onClick={onViewModeChange}
+            />
+          )}
           {isConductor && (
             <ViewModeButton
               mode="workers"

package/components/Pane/PaneViewToggle.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { FolderOpen, GitBranch, Home, Users } from "lucide-react";
+import { FolderOpen, GitBranch, Home, ScrollText, Users } from "lucide-react";
 import {
   Tooltip,
   TooltipContent,
@@ -8,12 +8,14 @@ import {
 } from "@/components/ui/tooltip";
 import { cn } from "@/lib/utils";
 
-type ViewMode = "terminal" | "files" | "git" | "workers";
+type ViewMode = "terminal" | "files" | "git" | "workers" | "log";
 
 interface PaneViewToggleProps {
   viewMode: ViewMode;
   isLocalSession: boolean;
   isConductor: boolean;
+  // The task merged and has a log.
+  hasLog?: boolean;
   workerCount: number;
   gitDrawerOpen: boolean;
   shellDrawerOpen: boolean;
@@ -68,6 +70,7 @@ export function PaneViewToggle({
   viewMode,
   isLocalSession,
   isConductor,
+  hasLog,
   workerCount,
   gitDrawerOpen,
   shellDrawerOpen,
@@ -110,6 +113,15 @@ export function PaneViewToggle({
           </ToggleButton>
         </>
       )}
+      {hasLog && (
+        <ToggleButton
+          label="Log"
+          active={viewMode === "log"}
+          onClick={() => onViewModeChange("log")}
+        >
+          <ScrollText className="h-3.5 w-3.5" />
+        </ToggleButton>
+      )}
       {isConductor && (
         <ToggleButton
           label="Workers"

package/components/Pane/index.tsx

@@ -1,5 +1,6 @@
 "use client";
 
+import { useTaskLogQuery } from "@/data/session-logs";
 import { SetupCard } from "@/components/Chat/SetupCard";
 import type { TabData } from "@/lib/panes";
 import { useRef, useCallback, useEffect, memo, useMemo } from "react";
@@ -34,6 +35,14 @@ import { useDemoMode } from "@/data/demo";
 import { DemoNotice } from "@/components/DemoNotice";
 
 // Dynamic imports for client-only components with loading states
+const LogDocument = dynamic(
+  () =>
+    import("@/components/SessionLogs/LogDocument").then(
+      (mod) => mod.LogDocument
+    ),
+  { ssr: false }
+);
+
 const Terminal = dynamic(
   () => import("@/components/Terminal").then((mod) => mod.Terminal),
   { ssr: false, loading: () => <TerminalSkeleton /> }
@@ -87,7 +96,7 @@ interface PaneProps {
   onAttachSession?: (terminal: TerminalHandle, session: Session) => void;
 }
 
-type ViewMode = "terminal" | "files" | "git" | "workers";
+type ViewMode = "terminal" | "files" | "git" | "workers" | "log";
 
 export const Pane = memo(function Pane({
   paneId,
@@ -173,6 +182,12 @@ export const Pane = memo(function Pane({
 
   const isConductor = workerCount > 0;
 
+  // A merged task keeps the log AgentOS wrote of it.
+  const merged =
+    !!session?.task_prompt &&
+    (session.task_status === "merged" || session.pr_status === "merged");
+  const hasLog = !!useTaskLogQuery(session?.id, merged).data;
+
   // Get current project and its repositories
   const currentProject = useMemo(() => {
     if (!session?.project_id) return null;
@@ -403,6 +418,7 @@ export const Pane = memo(function Pane({
           projects={projects}
           viewMode={viewMode}
           isConductor={isConductor}
+          hasLog={hasLog}
           workerCount={workerCount}
           onMenuClick={onMenuClick}
           onViewModeChange={setViewMode}
@@ -423,6 +439,7 @@ export const Pane = memo(function Pane({
           viewMode={viewMode}
           isFocused={isFocused}
           isConductor={isConductor}
+          hasLog={hasLog}
           workerCount={workerCount}
           canSplit={canSplit}
           canClose={canClose}
@@ -485,6 +502,11 @@ export const Pane = memo(function Pane({
             </div>
           )}
 
+          {/* Log */}
+          {viewMode === "log" && session && (
+            <LogDocument sessionId={session.id} />
+          )}
+
           {/* Workers */}
           {viewMode === "workers" && session && (
             <ConductorPanel
@@ -542,6 +564,11 @@ export const Pane = memo(function Pane({
                     </div>
                   )}
 
+                  {/* Log */}
+                  {viewMode === "log" && session && (
+                    <LogDocument sessionId={session.id} />
+                  )}
+
                   {/* Workers */}
                   {viewMode === "workers" && session && (
                     <ConductorPanel

package/components/PrStageBadge.tsx

@@ -0,0 +1,78 @@
+"use client";
+
+import { useQuery } from "@tanstack/react-query";
+import { Loader2 } from "lucide-react";
+import { statusKeys } from "@/data/sessions/keys";
+import {
+  PR_STAGE_BUSY,
+  prStageText,
+  PR_STAGE_SHORT,
+  type PrStage,
+  type PrStageName,
+} from "@/lib/tasks/pr-stage";
+import { cn } from "@/lib/utils";
+
+const TONE: Record<PrStageName, string> = {
+  merged: "bg-purple-500/15 text-purple-700 dark:text-purple-400",
+  conflicts: "bg-amber-500/15 text-amber-700 dark:text-amber-400",
+  "ci-failed": "bg-red-500/15 text-red-700 dark:text-red-400",
+  "ci-running": "bg-blue-500/15 text-blue-700 dark:text-blue-400",
+  "ci-settling": "bg-blue-500/15 text-blue-700 dark:text-blue-400",
+  "review-running": "bg-blue-500/15 text-blue-700 dark:text-blue-400",
+  "review-blocked": "bg-red-500/15 text-red-700 dark:text-red-400",
+  waiting: "bg-amber-500/15 text-amber-700 dark:text-amber-400",
+  armed: "bg-green-500/15 text-green-700 dark:text-green-400",
+  open: "bg-muted text-muted-foreground",
+};
+
+// Where a task's PR is in the gates, linking to the PR. The short stage word
+// is all the text; the PR number, full wording and sha live in the tooltip
+// and label. `showNumber` (the session header) prefixes "PR #n".
+export function PrStageBadge({
+  stage,
+  showNumber = false,
+}: {
+  stage?: PrStage;
+  showNumber?: boolean;
+}) {
+  if (!stage) return null;
+  const text = prStageText(stage);
+  const short = PR_STAGE_SHORT[stage.stage];
+  const visible = !showNumber
+    ? short
+    : stage.stage === "open"
+      ? `PR #${stage.number}`
+      : `PR #${stage.number} · ${short}`;
+  return (
+    <a
+      href={stage.url}
+      target="_blank"
+      rel="noreferrer"
+      title={`${text}${stage.sha ? ` · ${stage.sha}` : ""}`}
+      aria-label={`${text}${stage.sha ? ` · ${stage.sha}` : ""}`}
+      onClick={(e) => e.stopPropagation()}
+      className={cn(
+        "inline-flex shrink-0 items-center gap-1 rounded-md px-1.5 py-0.5 text-[11px] font-semibold whitespace-nowrap hover:underline",
+        TONE[stage.stage]
+      )}
+    >
+      {PR_STAGE_BUSY.has(stage.stage) && (
+        <Loader2 className="h-3 w-3 animate-spin" aria-hidden />
+      )}
+      {visible}
+    </a>
+  );
+}
+
+// The badge for one session, read from the status the sidebar already holds.
+export function SessionPrStage({ sessionId }: { sessionId?: string | null }) {
+  const { data } = useQuery<{
+    statuses: Record<string, { prStage?: PrStage }>;
+  }>({ queryKey: statusKeys.all, enabled: false });
+  return (
+    <PrStageBadge
+      stage={sessionId ? data?.statuses[sessionId]?.prStage : undefined}
+      showNumber
+    />
+  );
+}

package/components/Projects/ProjectSettingsDialog.tsx

@@ -1,5 +1,6 @@
 "use client";
 
+import dynamic from "next/dynamic";
 import { useState, useEffect } from "react";
 import {
   Dialog,
@@ -73,6 +74,14 @@ interface ProjectSettingsDialogProps {
   onSave: () => void;
 }
 
+const ProjectLogsSection = dynamic(
+  () =>
+    import("@/components/SessionLogs/ProjectLogsSection").then(
+      (mod) => mod.ProjectLogsSection
+    ),
+  { ssr: false }
+);
+
 export function ProjectSettingsDialog({
   project,
   open,
@@ -766,6 +775,8 @@ export function ProjectSettingsDialog({
 
             <ProjectMergeSection projectId={project.id} open={open} />
 
+            <ProjectLogsSection projectId={project.id} open={open} />
+
             {error && <p className="text-sm text-red-500">{error}</p>}
 
             <DialogFooter>

package/components/SessionList/LiveLine.tsx

@@ -0,0 +1,75 @@
+"use client";
+
+import { Loader2 } from "lucide-react";
+import { liveParts, liveText, type LiveTone } from "@/lib/sidebar/live-status";
+import type { PrStage } from "@/lib/tasks/pr-stage";
+import { prStageText } from "@/lib/tasks/pr-stage";
+import { cn } from "@/lib/utils";
+
+export interface LiveInput {
+  compacting?: boolean;
+  prStage?: PrStage;
+}
+
+const TONE: Record<LiveTone, string> = {
+  blue: "text-blue-700 dark:text-blue-400",
+  amber: "text-amber-700 dark:text-amber-400",
+  red: "text-red-700 dark:text-red-400",
+  green: "text-green-700 dark:text-green-400",
+  purple: "text-purple-700 dark:text-purple-400",
+  muted: "text-muted-foreground",
+};
+
+// The row's live status in small coloured words under the name: "Compacting
+// · PR CI". The PR word links to the PR; its number, full wording and sha are
+// in the tooltip. Renders nothing when there is nothing to say.
+export function LiveLine({ compacting, prStage }: LiveInput) {
+  const parts = liveParts({ compacting, prStage });
+  if (parts.length === 0) return null;
+  const pr = prStage
+    ? `${prStageText(prStage)}${prStage.sha ? ` · ${prStage.sha}` : ""}`
+    : "";
+  return (
+    <span
+      aria-label={liveText(parts)}
+      className="flex shrink-0 items-center gap-1 text-xs font-medium whitespace-nowrap"
+    >
+      {parts.map((p, i) => {
+        const isPr = p.text.startsWith("PR");
+        const body = (
+          <>
+            {p.busy && (
+              <Loader2 className="h-2.5 w-2.5 animate-spin" aria-hidden />
+            )}
+            {p.text}
+          </>
+        );
+        return (
+          <span key={p.text} className="flex items-center gap-1">
+            {i > 0 && <span className="text-muted-foreground/50">·</span>}
+            {isPr && prStage ? (
+              <a
+                href={prStage.url}
+                target="_blank"
+                rel="noreferrer"
+                title={pr}
+                aria-label={pr}
+                onClick={(e) => e.stopPropagation()}
+                className={cn(
+                  "flex items-center gap-1 hover:underline",
+                  TONE[p.tone]
+                )}
+              >
+                {body}
+              </a>
+            ) : (
+              <span className={cn("flex items-center gap-1", TONE[p.tone])}>
+                {body}
+              </span>
+            )}
+          </span>
+        );
+      })}
+    </span>
+  );
+}

package/components/SessionList/RowParts.tsx

@@ -26,7 +26,7 @@ export function RowDot({ row }: { row: SidebarRow }) {
   );
 }
 
-// What it needs from you, or a purple dot when it changed since you looked.
+// What it needs from you, stalled, or a purple dot when it changed since you looked.
 export function RowBadge({ row }: { row: SidebarRow }) {
   if (row.need) {
     const asks = row.status?.asks ?? 0;
@@ -44,12 +44,6 @@ export function RowBadge({ row }: { row: SidebarRow }) {
       </span>
     );
   }
-  if (row.compacting)
-    return (
-      <span className="rounded-md bg-blue-500/15 px-1.5 py-0.5 text-[11px] font-semibold text-blue-700 dark:text-blue-400">
-        Compacting
-      </span>
-    );
   if (row.status?.stalled)
     return (
       <span className="rounded-md bg-amber-500/15 px-1.5 py-0.5 text-[11px] font-semibold text-amber-700 dark:text-amber-400">

package/components/SessionList/RowShell.tsx

@@ -65,7 +65,7 @@ export function RowShell({
       )}
     >
       {leading}
-      <span className="flex min-w-0 flex-1 flex-col leading-tight">
+      <span className="flex min-w-[7rem] flex-1 flex-col leading-tight">
         {children}
       </span>
       {aside}

package/components/SessionList/RowSubtitle.tsx

@@ -2,6 +2,7 @@
 
 import { HostBadge } from "@/components/Hosts";
 import type { Session } from "@/lib/db";
+import { LiveLine, type LiveInput } from "./LiveLine";
 import { headerParts } from "@/lib/orchestrator/header-line";
 import { cn } from "@/lib/utils";
 import { usageLabel, useSessionUsage } from "@/data/load";
@@ -16,9 +17,11 @@ const ATTENTION = (part: string) => part === "paused" || /\basks?$/.test(part);
 export function RowSubtitle({
   session,
   detail,
+  live,
 }: {
   session: Session;
   detail?: string | null;
+  live?: LiveInput;
 }) {
   const ctx = useRowContext();
   // What its processes use, on a busy session: "3.1 cores · 4.2 GB".
@@ -52,6 +55,7 @@ export function RowSubtitle({
   const project = ctx.projectNames.get(session.project_id ?? "");
   return (
     <span className="flex min-w-0 items-center gap-1.5">
+      <LiveLine {...live} />
       {(project || detail || usage) && (
         <span className="text-muted-foreground/70 truncate text-xs">
           {[usage && usageLabel(usage), detail?.slice(0, 200), project]

package/components/SessionList/SessionList.types.ts

@@ -1,3 +1,4 @@
+import type { PrStage } from "@/lib/tasks/pr-stage";
 import type { SessionNeed } from "@/lib/sidebar/shelves";
 
 export interface SessionStatus {
@@ -11,6 +12,7 @@ export interface SessionStatus {
   unread?: boolean;
   stalled?: boolean;
   compacting?: { since: number; before?: number };
+  prStage?: PrStage;
 }
 
 export interface SessionListProps {

package/components/SessionList/SessionRow.tsx

@@ -122,7 +122,15 @@ export const SessionRow = memo(function SessionRow({
             {session.name}
           </span>
         )}
-        <RowSubtitle session={session} detail={row.status?.detail} />
+        <RowSubtitle
+          session={session}
+          detail={row.status?.detail}
+          live={
+            row.need
+              ? undefined
+              : { compacting: row.compacting, prStage: row.status?.prStage }
+          }
+        />
       </RowShell>
       {session.role === "orchestrator" && row.need && (
         <OrchestratorAsks workspaceId={session.workspace_id} />

package/components/SessionLogs/LogDocument.tsx

@@ -0,0 +1,29 @@
+"use client";
+
+import { Markdown } from "@/components/Chat/Markdown";
+import { useTaskLogQuery } from "@/data/session-logs";
+
+// A merged task's stored log, as the document AgentOS wrote.
+export function LogDocument({ sessionId }: { sessionId: string }) {
+  const { data, isPending, isError, error } = useTaskLogQuery(sessionId);
+  if (isPending)
+    return <div className="bg-muted/40 m-4 h-40 animate-pulse rounded-lg" />;
+  if (isError)
+    return <p className="text-destructive p-4 text-sm">{error.message}</p>;
+  if (!data)
+    return (
+      <p className="text-muted-foreground p-4 text-sm">This task has no log.</p>
+    );
+  return (
+    <div className="h-full overflow-y-auto">
+      <div className="mx-auto max-w-3xl px-4 py-4">
+        <Markdown text={data.markdown} />
+        {data.header.filePath && (
+          <p className="text-muted-foreground mt-4 border-t pt-3 text-xs break-all">
+            Also saved at {data.header.filePath}
+          </p>
+        )}
+      </div>
+    </div>
+  );
+}