@saadnvd1/agent-os 0.3.594 → 0.3.596

package/data/session-artifacts/queries.ts

@@ -0,0 +1,53 @@
+import { useQuery } from "@tanstack/react-query";
+import type { SessionArtifact } from "@/lib/session-artifacts/types";
+import { sessionArtifactKeys } from "./keys";
+
+export type { SessionArtifact } from "@/lib/session-artifacts/types";
+
+export interface SessionArtifacts {
+  artifacts: SessionArtifact[];
+  // A linked machine's session: which one, and whether it answered.
+  host?: string;
+  unreachable?: boolean;
+}
+
+export const artifactContentUrl = (sessionId: string, id: string) =>
+  `/api/sessions/${encodeURIComponent(sessionId)}/artifacts/${encodeURIComponent(id)}`;
+
+/** What a session made. Read only while the view is open. */
+export function useSessionArtifacts(sessionId: string | null | undefined) {
+  return useQuery({
+    queryKey: sessionArtifactKeys.session(sessionId ?? ""),
+    queryFn: async (): Promise<SessionArtifacts> => {
+      const res = await fetch(
+        `/api/sessions/${encodeURIComponent(sessionId!)}/artifacts`
+      );
+      const data = await res.json().catch(() => ({}));
+      if (!res.ok) throw new Error(data.error || "Couldn't load artifacts");
+      return data;
+    },
+    enabled: !!sessionId,
+    staleTime: 5_000,
+    refetchInterval: 20_000,
+  });
+}
+
+/** A text artifact's content: markdown, a file, a log. */
+export function useArtifactText(url: string | null) {
+  return useQuery({
+    queryKey: sessionArtifactKeys.content(url ?? ""),
+    queryFn: async () => {
+      const res = await fetch(url!);
+      if (!res.ok) {
+        const data = await res.json().catch(() => ({}));
+        throw new Error(data.error || "Couldn't open it");
+      }
+      return {
+        text: await res.text(),
+        truncated: res.headers.get("X-Artifact-Truncated") === "1",
+      };
+    },
+    enabled: !!url,
+    staleTime: 5_000,
+  });
+}

package/lib/chat/task-output.ts

@@ -10,7 +10,7 @@ const found = new Map<string, string>();
 // Claude Code writes each background task's output under
 // <tmp>/claude-<uid>/<project>/<session>/tasks/<task id>.output; the path is
 // only reported when the task ends, so a running one is found by name.
-function findOutputFile(taskId: string): string | null {
+export function findOutputFile(taskId: string): string | null {
   const cached = found.get(taskId);
   if (cached && fs.existsSync(cached)) return cached;
   const uid = process.getuid?.() ?? "";

package/lib/done/worktree.ts

@@ -11,6 +11,7 @@ import { git as runGit } from "../git-exec";
 import { mergePolicy } from "../tasks/merge-policy";
 import { getProject } from "../projects";
 import { deleteWorktree, isAgentOSWorktree } from "../worktrees";
+import { keepSessionFiles } from "../session-artifacts/collect";
 import { removalRunning, removalSettled } from "../worktree-removal";
 import { describeChanges, unsavedChanges } from "../worktree-placed";
 import { dropSnapshot, snapshotWorktree } from "../resurrect/snapshot";
@@ -234,6 +235,8 @@ export async function settleWorktree(
   }
   await snapshot;
   const path = session.worktree_path!;
+  // What it made that git doesn't hold (a plan, a mockup) outlives it.
+  if (session.id) await keepSessionFiles(session.id);
   await deleteWorktree(path, fate.repo, true).catch(() => {});
   if (fs.existsSync(path))
     return { action: "kept", why: "removing it failed", path };

package/lib/hover-tip.ts

@@ -0,0 +1,161 @@
+// One hover tooltip for the whole app. An element opts in with data-tip
+// (plain text) or data-tip-key ("session:<id>", resolved when it opens by
+// whoever registered that prefix). Rows carry an attribute and nothing
+// else: one element and a few passive document listeners do the rest, and
+// a touch screen attaches none. It opens after resting on something, and
+// once one is open the next opens at once, so a list can be scanned.
+
+export interface TipContent {
+  title: string;
+  lines: [label: string, value: string][];
+}
+export type TipValue = string | TipContent | null | undefined;
+
+export const OPEN_DELAY_MS = 600;
+export const WARM_MS = 400;
+const SELECTOR = "[data-tip],[data-tip-key]";
+const TIP_ID = "hover-tip";
+
+const resolvers = new Map<string, (id: string) => TipValue>();
+
+export function registerTip(
+  prefix: string,
+  resolve: (id: string) => TipValue
+): () => void {
+  resolvers.set(prefix, resolve);
+  return () => {
+    if (resolvers.get(prefix) === resolve) resolvers.delete(prefix);
+  };
+}
+
+export function resolveTip(el: Element): TipValue {
+  const key = el.getAttribute("data-tip-key");
+  if (key) {
+    const at = key.indexOf(":");
+    const value = resolvers.get(key.slice(0, at))?.(key.slice(at + 1));
+    if (value) return value;
+  }
+  return el.getAttribute("data-tip");
+}
+
+// Text only: names are user text and never parsed as HTML.
+function fill(el: HTMLElement, value: string | TipContent) {
+  if (typeof value === "string") {
+    el.textContent = value;
+    return;
+  }
+  const doc = el.ownerDocument;
+  const title = doc.createElement("div");
+  title.className = "font-medium";
+  title.textContent = value.title;
+  const rows = value.lines.map(([label, text]) => {
+    const line = doc.createElement("div");
+    const k = doc.createElement("span");
+    k.className = "text-muted-foreground";
+    k.textContent = `${label} `;
+    line.append(k, text);
+    return line;
+  });
+  el.replaceChildren(title, ...rows);
+}
+
+// Beside the target (a sidebar row's tip opens over the page, not the
+// list), flipped or dropped below when there's no room. One measure.
+function place(el: HTMLElement, target: Element, win: Window) {
+  const r = target.getBoundingClientRect();
+  const w = el.offsetWidth;
+  const h = el.offsetHeight;
+  const gap = 8;
+  let x = r.right + gap;
+  let y = r.top;
+  if (x + w > win.innerWidth - gap) x = r.left - w - gap;
+  if (x < gap) {
+    x = Math.min(Math.max(gap, r.left), win.innerWidth - w - gap);
+    y = r.bottom + gap;
+  }
+  y = Math.max(gap, Math.min(y, win.innerHeight - h - gap));
+  el.style.transform = `translate(${Math.round(x)}px, ${Math.round(y)}px)`;
+}
+
+// Works across documents (tests, frames), unlike instanceof Element.
+const isElement = (node: EventTarget | null): node is Element =>
+  !!node && typeof (node as Element).closest === "function";
+
+export function installHoverTip(win: Window = window): () => void {
+  if (!win.matchMedia?.("(hover: hover) and (pointer: fine)").matches)
+    return () => {};
+  const doc = win.document;
+  const el = doc.createElement("div");
+  el.id = TIP_ID;
+  el.setAttribute("role", "tooltip");
+  el.className =
+    "popover-surface text-popover-foreground pointer-events-none fixed top-0 left-0 z-[60] max-w-72 rounded-lg px-2.5 py-1.5 text-xs leading-relaxed whitespace-pre-line";
+  el.hidden = true;
+  doc.body.append(el);
+
+  let timer: ReturnType<typeof setTimeout> | undefined;
+  let pending: Element | null = null;
+  let shown: Element | null = null;
+  let warmUntil = 0;
+
+  const hide = () => {
+    clearTimeout(timer);
+    timer = undefined;
+    pending = null;
+    if (shown) {
+      shown.removeAttribute("aria-describedby");
+      warmUntil = Date.now() + WARM_MS;
+      shown = null;
+    }
+    el.hidden = true;
+  };
+  const show = (target: Element) => {
+    timer = undefined;
+    if (!target.isConnected) return;
+    const value = resolveTip(target);
+    if (!value) return;
+    fill(el, value);
+    el.hidden = false;
+    place(el, target, win);
+    target.setAttribute("aria-describedby", TIP_ID);
+    shown = target;
+  };
+  const arm = (target: Element | null) => {
+    if (target && (target === pending || target === shown)) return;
+    hide();
+    if (!target) return;
+    pending = target;
+    if (Date.now() < warmUntil) show(target);
+    else timer = setTimeout(() => show(target), OPEN_DELAY_MS);
+  };
+  const tipOf = (node: EventTarget | null) =>
+    isElement(node) ? node.closest(SELECTOR) : null;
+
+  const onOver = (e: Event) => arm(tipOf(e.target));
+  const onOut = (e: Event) => {
+    if (!(e as PointerEvent).relatedTarget) hide();
+  };
+  const onFocusIn = (e: Event) => {
+    const t = e.target;
+    if (isElement(t) && t.matches(SELECTOR) && t.matches(":focus-visible"))
+      arm(t);
+  };
+  const passive = { passive: true } as const;
+  const listeners: [string, (e: Event) => void, AddEventListenerOptions][] = [
+    ["pointerover", onOver, passive],
+    ["pointerout", onOut, passive],
+    ["pointerdown", hide, passive],
+    ["keydown", hide, passive],
+    ["focusin", onFocusIn, passive],
+    ["focusout", hide, passive],
+    ["scroll", hide, { passive: true, capture: true }],
+  ];
+  for (const [type, fn, opts] of listeners)
+    doc.addEventListener(type, fn, opts);
+  return () => {
+    hide();
+    for (const [type, fn, opts] of listeners)
+      doc.removeEventListener(type, fn, opts);
+    el.remove();
+  };
+}

package/lib/security/demo.ts

@@ -84,6 +84,7 @@ const READS = [
   "sessions/[id]/messages",
   "sessions/[id]/pr",
   "sessions/[id]/artifacts",
+  "sessions/[id]/artifacts/[id]",
   "sessions/[id]/setup",
   "sessions/[id]/preview",
   "projects",

package/lib/session-artifacts/access.ts

@@ -0,0 +1,81 @@
+/**
+ * Which files the Artifacts view may open: inside the session's own folders
+ * or the few AgentOS folders agents write output to, never a secret, judged
+ * on the real path so a link can't lead out. Stricter than the file browser.
+ */
+
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { artifactsDir } from "../artifacts/store";
+import { auditsRoot } from "../session-audit/store";
+import { WORKTREES_DIR } from "../worktrees";
+import { isSecretPath } from "../secret-paths";
+import { keptDir } from "./keep";
+
+export interface RootsFor {
+  worktree_path?: string | null;
+  working_directory?: string | null;
+  projectPath?: string | null;
+}
+
+const expand = (p: string) =>
+  p === "~" || p.startsWith("~/") ? os.homedir() + p.slice(1) : p;
+
+// A folder and, when it differs, its real path (/tmp is /private/tmp).
+function withReal(dirs: string[]): string[] {
+  const out = new Set<string>();
+  for (const d of dirs) {
+    const abs = path.resolve(expand(d));
+    out.add(abs);
+    try {
+      out.add(fs.realpathSync(abs));
+    } catch {
+      // Not there (a removed worktree): its literal path still counts.
+    }
+  }
+  return [...out];
+}
+
+export function allowedRoots(s: RootsFor): string[] {
+  const dirs = [
+    s.worktree_path,
+    s.working_directory,
+    s.projectPath,
+    artifactsDir(),
+    keptDir(),
+    auditsRoot(),
+    WORKTREES_DIR,
+    os.tmpdir(),
+    "/tmp",
+  ].filter((d): d is string => !!d);
+  // A session started in ~ (or /) would otherwise open everything.
+  const home = path.resolve(os.homedir());
+  return withReal(dirs).filter((d) => d !== path.parse(d).root && d !== home);
+}
+
+export const within = (file: string, roots: string[]) =>
+  roots.some((r) => file === r || file.startsWith(r + path.sep));
+
+// The real file to serve, or why not. Regular files only.
+export function resolveAllowed(
+  file: string,
+  roots: string[]
+): { ok: true; real: string; size: number } | { ok: false; status: 403 | 404 } {
+  if (isSecretPath(file)) return { ok: false, status: 403 };
+  let real: string;
+  try {
+    real = fs.realpathSync(file);
+  } catch {
+    return { ok: false, status: 404 };
+  }
+  if (isSecretPath(real) || !within(real, roots))
+    return { ok: false, status: 403 };
+  try {
+    const stat = fs.statSync(real);
+    if (!stat.isFile()) return { ok: false, status: 404 };
+    return { ok: true, real, size: stat.size };
+  } catch {
+    return { ok: false, status: 404 };
+  }
+}

package/lib/session-artifacts/collect.ts

@@ -0,0 +1,318 @@
+/**
+ * A session's artifacts, read cheaply: one indexed query over its chat items
+ * (never a tool's output or a Write's content), a stat per file, one git
+ * status while its worktree is there, and its PR, recipe run and log rows.
+ * Cached until the chat moves on, and for a minute at most.
+ */
+
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { db, queries, type Session } from "../db";
+import { flushItems } from "../chat/store";
+import { git } from "../git-exec";
+import { PLAN_FILE } from "../models/plan-step";
+import { listArtifacts } from "../artifacts/store";
+import { allowedRoots, within } from "./access";
+import {
+  fromItems,
+  fromPr,
+  fromRun,
+  fromSessionLog,
+  fromStatus,
+  mergePlan,
+  parsePorcelain,
+  sortEntries,
+  stateOf,
+  toArtifact,
+  type Candidate,
+  type Entry,
+  type FileFacts,
+  type ItemRow,
+  type RunRow,
+} from "./derive";
+import { keepFiles, readManifest, relInside, sessionKeptDir } from "./keep";
+
+export const MAX_FILES = 500;
+const CACHE_MS = 60_000;
+const CACHE_SIZE = 50;
+const STATUS_TIMEOUT_MS = 3000;
+
+const ITEMS_SQL = `
+  SELECT item_id, kind,
+         json_extract(data, '$.createdAt') AS at,
+         json_extract(data, '$.name') AS name,
+         json_extract(data, '$.status') AS status,
+         json_extract(data, '$.input.file_path') AS file_path,
+         json_extract(data, '$.input.notebook_path') AS notebook_path,
+         json_extract(data, '$.input.path') AS input_path,
+         json_extract(data, '$.input.filePath') AS file_path_camel,
+         json_extract(data, '$.input.changes') AS changes,
+         json_extract(data, '$.artifactId') AS artifact_id,
+         json_extract(data, '$.title') AS title,
+         json_extract(data, '$.taskId') AS task_id,
+         json_extract(data, '$.outputFile') AS output_file,
+         json_extract(data, '$.taskType') AS task_type,
+         json_extract(data, '$.subagentType') AS subagent_type,
+         json_extract(data, '$.description') AS description,
+         json_extract(data, '$.ambient') AS ambient,
+         json_array_length(data, '$.images') AS image_count
+    FROM chat_items
+   WHERE session_id = ? AND kind IN ('tool', 'artifact', 'task', 'plan', 'user')
+   ORDER BY seq`;
+
+const expand = (p: string) =>
+  p === "~" || p.startsWith("~/") ? os.homedir() + p.slice(1) : p;
+
+const sqliteMs = (t: string | null | undefined) =>
+  t ? Date.parse(t.includes("T") ? t : `${t.replace(" ", "T")}Z`) || 0 : 0;
+
+export function getSession(id: string): Session | undefined {
+  return queries.getSession(db).get(id) as Session | undefined;
+}
+
+function projectPath(session: Session): string | null {
+  if (!session.project_id) return null;
+  const row = db
+    .prepare(`SELECT working_directory FROM projects WHERE id = ?`)
+    .get(session.project_id) as { working_directory: string } | undefined;
+  return row ? expand(row.working_directory) : null;
+}
+
+export function rootsOf(session: Session): string[] {
+  return allowedRoots({
+    worktree_path: session.worktree_path,
+    working_directory: session.working_directory,
+    projectPath: projectPath(session),
+  });
+}
+
+function runs(sessionId: string): RunRow[] {
+  return (
+    db
+      .prepare(
+        `SELECT r.id, r.status, x.name AS recipe_name,
+                COALESCE(r.ended_at, r.started_at, r.created_at) AS t
+           FROM recipe_runs r LEFT JOIN recipes x ON x.id = r.recipe_id
+          WHERE r.session_id = ? ORDER BY r.id`
+      )
+      .all(sessionId) as (RunRow & { t: string })[]
+  ).map((r) => ({ ...r, at: sqliteMs(r.t) }));
+}
+
+function logAt(sessionId: string): number | null {
+  const row = db
+    .prepare(`SELECT created_at FROM session_logs WHERE session_id = ?`)
+    .get(sessionId) as { created_at: string } | undefined;
+  return row ? sqliteMs(row.created_at) : null;
+}
+
+const filePathOf = (c: Candidate): string | undefined =>
+  c.source.type === "file"
+    ? c.source.path
+    : c.source.type === "plan" || c.source.type === "log"
+      ? c.source.path
+      : undefined;
+
+async function sizeOf(file: string): Promise<number | undefined> {
+  try {
+    const stat = await fs.promises.stat(file);
+    return stat.isFile() ? stat.size : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+function realWithin(file: string, roots: string[]): boolean {
+  if (!within(file, roots)) return false;
+  try {
+    return within(fs.realpathSync(file), roots);
+  } catch {
+    return true;
+  }
+}
+
+async function build(session: Session): Promise<Entry[]> {
+  flushItems();
+  const rows = db.prepare(ITEMS_SQL).all(session.id) as ItemRow[];
+  const cwd = session.working_directory
+    ? expand(session.working_directory)
+    : null;
+  let candidates = fromItems(rows, cwd);
+
+  const isLocal = !session.host_id || session.host_id === "local";
+  const worktree =
+    isLocal && session.worktree_path ? expand(session.worktree_path) : null;
+  const worktreeThere = !!worktree && fs.existsSync(worktree);
+  const latest = rows.reduce((m, r) => Math.max(m, r.at ?? 0), 0);
+
+  if (worktreeThere) {
+    const out = await git(
+      worktree,
+      ["status", "--porcelain", "-z", "--untracked-files=all"],
+      { timeout: STATUS_TIMEOUT_MS }
+    ).catch(() => "");
+    const known = new Set(candidates.map((c) => c.key));
+    candidates.push(
+      ...fromStatus(parsePorcelain(out), worktree, latest, known)
+    );
+  }
+
+  const manifest = worktree && !worktreeThere ? readManifest(session.id) : null;
+  if (worktree) {
+    const planFile = path.join(worktree, PLAN_FILE);
+    const named = candidates.some((c) => c.key === `file:${planFile}`);
+    const there = worktreeThere
+      ? fs.existsSync(planFile)
+      : !!manifest?.kept.includes(PLAN_FILE);
+    if (named || there) candidates = mergePlan(candidates, planFile);
+  }
+
+  const pr = fromPr({
+    pr_url: session.pr_url,
+    pr_number: session.pr_number,
+    pr_status: session.pr_status,
+    at: sqliteMs(session.merged_at ?? session.updated_at),
+  });
+  if (pr) candidates.push(pr);
+  candidates.push(...runs(session.id).map(fromRun));
+  const log = logAt(session.id);
+  if (log !== null) candidates.push(fromSessionLog(log));
+
+  // The newest files first, so the cap drops the oldest.
+  const fileBacked = candidates
+    .filter((c) => filePathOf(c))
+    .sort((a, b) => b.at - a.at);
+  const dropped = new Set(fileBacked.slice(MAX_FILES).map((c) => c.key));
+  candidates = candidates.filter((c) => !dropped.has(c.key));
+
+  const roots = rootsOf(session);
+  const keptBase = sessionKeptDir(session.id);
+  const tracked = new Set(manifest?.tracked);
+  const kept = new Set(manifest?.kept);
+  const pages = new Map(listArtifacts(session.id).map((a) => [a.id, a.path]));
+  const entries = await Promise.all(
+    candidates.map(async (c): Promise<Entry> => {
+      if (c.source.type === "page") {
+        const page = pages.get(c.source.artifactId);
+        const size = page ? await sizeOf(page) : undefined;
+        return toArtifact(
+          c,
+          size === undefined ? { state: "gone" } : { state: "live", size }
+        );
+      }
+      const file = filePathOf(c);
+      if (!file) return toArtifact(c, null);
+      const facts: FileFacts = {
+        size: await sizeOf(file),
+        allowed: realWithin(file, roots),
+      };
+      const rel = worktree ? relInside(worktree, file) : null;
+      let read: string | undefined =
+        facts.size !== undefined ? file : undefined;
+      if (facts.size === undefined && rel && manifest) {
+        if (kept.has(rel)) {
+          const copy = path.join(keptBase, rel);
+          facts.keptSize = await sizeOf(copy);
+          if (facts.keptSize !== undefined) read = copy;
+        }
+        facts.committed = tracked.has(rel) && !!session.pr_number;
+      }
+      const state = stateOf(facts);
+      // A plan proposed in chat still opens when its file has gone.
+      if (
+        c.source.type === "plan" &&
+        c.source.chatItemId &&
+        (state.state === "gone" || state.state === "in-pr")
+      )
+        return toArtifact(c, { state: "live", path: file });
+      // A running job's output file is named only once it ends.
+      if (c.source.type === "log" && !c.source.path)
+        return toArtifact(c, { state: "live" });
+      return toArtifact(c, {
+        ...state,
+        path: file,
+        read: state.state === "outside" ? undefined : read,
+      });
+    })
+  );
+  if (worktree)
+    for (const { artifact: a } of entries) {
+      const rel = a.path && relInside(worktree, untilde(a.path));
+      if (rel) a.folder = path.posix.dirname(rel).replace(/^\.$/, "");
+    }
+  return sortEntries(entries);
+}
+
+const untilde = (p: string) =>
+  p.startsWith("~/") ? path.join(os.homedir(), p.slice(2)) : p;
+
+interface Cached {
+  sig: string;
+  at: number;
+  entries: Promise<Entry[]>;
+}
+const cache = new Map<string, Cached>();
+
+function signature(session: Session): string {
+  const row = db
+    .prepare(`SELECT max(seq) AS seq FROM chat_items WHERE session_id = ?`)
+    .get(session.id) as { seq: number | null };
+  return [
+    row.seq ?? 0,
+    session.pr_status,
+    session.pr_number,
+    session.worktree_path,
+    session.updated_at,
+  ].join("|");
+}
+
+export function forgetArtifacts(sessionId: string): void {
+  cache.delete(sessionId);
+}
+
+export async function collectArtifacts(
+  session: Session,
+  now = Date.now()
+): Promise<Entry[]> {
+  flushItems();
+  const sig = signature(session);
+  const hit = cache.get(session.id);
+  if (hit && hit.sig === sig && now - hit.at < CACHE_MS) {
+    // Recently used stays.
+    cache.delete(session.id);
+    cache.set(session.id, hit);
+    return hit.entries;
+  }
+  const entries = build(session);
+  cache.set(session.id, { sig, at: now, entries });
+  entries.catch(() => cache.delete(session.id));
+  while (cache.size > CACHE_SIZE) cache.delete(cache.keys().next().value!);
+  return entries;
+}
+
+export const cachedCount = () => cache.size;
+
+/**
+ * Before a session's worktree is removed: copy what it made there that git
+ * doesn't hold. Never throws, and never holds up the removal for long.
+ */
+export async function keepSessionFiles(sessionId: string): Promise<void> {
+  try {
+    const session = getSession(sessionId);
+    if (!session?.worktree_path) return;
+    if (session.host_id && session.host_id !== "local") return;
+    const worktree = expand(session.worktree_path);
+    if (!fs.existsSync(worktree)) return;
+    forgetArtifacts(sessionId);
+    const entries = await collectArtifacts(session);
+    const files = entries
+      .map((e) => e.read)
+      .filter((f): f is string => !!f && !!relInside(worktree, f));
+    await keepFiles(sessionId, worktree, files);
+  } catch (error) {
+    console.error(`[session-artifacts] keeping ${sessionId}:`, error);
+  } finally {
+    forgetArtifacts(sessionId);
+  }
+}