@stevecastaneda/paseo-progress 1.0.0 → 1.2.0

package/OVERVIEW.md

@@ -1,6 +1,6 @@
 Progress gives each worktree a live dashboard for long agent jobs. The agent records its tickets or steps with a `paseo-progress` command, along with what's stuck, questions for you and finished work. The Progress panel in Explorer shows all of it. Needs Paseo 0.11 or later, and Node.js 22.18 or later on the computer running the Paseo daemon.
 
-The panel shows how much of the estimated work is done, what the agent is doing right now, and where each ticket stands. A ticket turns stuck when it's blocked or runs past its estimate without an update. Press a ticket to see its timeline, activity, questions and deliverables. Images and text files the agent records open in a preview inside Paseo. Any other file opens in an app on the computer running the Paseo daemon, and so does a previewed file when you press Open. That's true from your phone too. The app opens on that computer, not on the phone.
+The panel shows how much of the estimated work is done, what the agent is doing right now, and where each ticket stands. A ticket turns stuck when it's blocked or runs past its estimate without an update. Press a ticket to see its timeline, activity, questions and deliverables. Images, videos and text files the agent records open in a preview inside Paseo, and a folder opens as a list of its files. Videos play only in the desktop app. Any other file opens in an app on the computer running the Paseo daemon, and so does a previewed file when you press Open. Open is hidden when that computer can't open files, like a Linux server with no desktop. That's true from your phone too. The app opens on that computer, not on the phone.
 
 When the agent needs a decision, it asks a numbered question with lettered options and says which one it recommends. A pill above the message box counts open questions and stuck work. Each option has a Copy button. Paste the answer into the chat and the agent records it.
 

package/README.md

@@ -13,7 +13,7 @@ The dashboard shows:
 - percent of estimated work done, time done of time estimated (like "1h 30m of 2h"; once everything is done, how long it really took), and a bar with one segment per ticket
 - **Stuck:** blocked tickets, working tickets with no update for longer than their estimate, and blockers the agent flags
 - **Tickets:** estimate, status, and the working ticket's stage. A ticket that waits for another (`--waits-for T03`) shows "Waits for Ticket 03" under its title until that one is done; waiting is the order of work, so it never counts as stuck, even if the agent also marked it blocked. Press a ticket for its story in a dialog. A summary on top shows its status and stage, time worked against the estimate as a bar that turns red past it, the agent's latest status line while it's working, and the agent on it. Tabs below hold the rest, each only when it has something: the ticket's write-up when it has a `--source` file (the start of it, with the rest a press away), a timeline of its stages and statuses with how long each took, and the activity, questions and deliverables that belong to it. The agent on a ticket shows by its chat title; pressing it opens that chat. Items tagged with `--ticket` belong exactly; older, untagged ones are matched by when they happened and marked "by time"
-- **Questions:** each with a permanent reference (Q1, Q2, ...), lettered options, and the option the agent recommends. The agent builds nothing a question affects until you answer; it works on other things meanwhile, and stops when nothing else is left. Press a question to open it in a dialog, then press **Copy Q2 B** to copy `Q2 (title): B` for your reply. Files and links the agent attached (`--file`) open like deliverables: images and text files preview in Paseo (with **Back** to the question), links open in Paseo's browser, and other files open in their default app. From the pill's popover, the preview opens over the popover, which stays open so you can go back to it. Answers stay listed under the same reference.
+- **Questions:** each with a permanent reference (Q1, Q2, ...), lettered options, and the option the agent recommends. The agent builds nothing a question affects until you answer; it works on other things meanwhile, and stops when nothing else is left. Press a question to open it in a dialog, then press **Copy Q2 B** to copy `Q2 (title): B` for your reply. Files and links the agent attached (`--file`) open like deliverables: images, videos and text files preview in Paseo (with **Back** to the question), a folder lists its files there, links open in Paseo's browser, and other files open in their default app. From the pill's popover, the preview opens over the popover, which stays open so you can go back to it. Answers stay listed under the same reference.
 - **Activity**, **Answered** questions and **Deliverables** (press one to open it), sharing one card with a tab for each; the panel remembers the tab you picked. Each shows the newest 10, with **Show 10 older** below
 
 <img src="images/2-ticket.png" alt="A ticket's story: its status, time against the estimate, the agent on it, and its timeline" width="400"> <img src="images/3-question.png" alt="A question waiting for an answer, with lettered options, the agent's recommendation and Copy buttons" width="400">
@@ -22,7 +22,7 @@ The panel lives in Explorer, beside the agent chat, so you can watch both. Open
 
 <img src="images/4-pill.png" alt="The pill above the message box, showing two questions waiting" width="600">
 
-On phones, where Paseo has no Explorer pane, Progress opens as a tab of its own, and the pill stays above the message box while a run is open so there's always a way in. SVG files preview on desktop; on phones they open on the daemon host.
+On phones, where Paseo has no Explorer pane, Progress opens as a tab of its own, and the pill stays above the message box while a run is open so there's always a way in. SVG files and videos preview on desktop; on phones they open on the daemon host.
 
 The first time a run starts in a worktree whose Progress panel has never been opened, the pill shows a spinner and reads **Progress** instead; pressing it opens the panel. Once the panel has been opened there, the plugin writes an empty `progress-panel-opened` file next to the progress file and the nudge never comes back, even for later runs. It doesn't open the panel by itself because Paseo switches to a workspace to open its panel, which would pull you away from whatever you're looking at.
 
@@ -100,7 +100,7 @@ paseo-progress finish "Snapshots ship for all four tables"
 - `ticket add` and `ticket update` take an optional `--source <path or link>[=<label>]`: where the ticket is written up, like its spec file or issue. It shows under the ticket's status in its dialog and opens like a deliverable. `--source ""` clears it. Tickets without one are fine.
 - A working ticket is stuck once it goes longer than its estimate without an update, timed from its last status, stage or note change, or activity tagged to it. The ticket's dialog still shows total time worked against the estimate.
 - `question ask` needs `--recommend`, the agent's pick. The question dialog tags that option "Recommended".
-- Deliverable paths are stored relative to the worktree root. Web links open in Paseo's browser. Pressing an image (PNG, JPEG, GIF, WebP, up to 10 MB) or text deliverable (Markdown, text, logs, JSON, YAML, CSV; the first 256 KB) previews it in a dialog inside Paseo, which also works from a phone; **Open** there opens the file in its default app. Pressing any other local deliverable opens it with its default app on the machine running the Paseo daemon (for example HTML in your browser and folders in the file manager). On macOS, **Open** sends text files to your default browser. Only recorded deliverables inside the worktree open this way; otherwise the path is copied. The copy icon on each row copies the path.
+- Deliverable paths are stored relative to the worktree root. Web links open in Paseo's browser. Pressing an image (PNG, JPEG, GIF, WebP, up to 10 MB) or text deliverable (Markdown, text, logs, JSON, YAML, CSV; the first 256 KB) previews it in a dialog inside Paseo, which also works from a phone; **Open** there opens the file in its default app. **Open** shows only when the computer running Paseo can open files. A Linux server with no desktop can't, so there a file Paseo can't preview copies its path and says why. A video (MP4, MOV, WebM, up to 200 MB) plays in the same dialog in the desktop app. When there are several files, **Previous** and **Next** step through them, and so do the left and right arrow keys. Pressing a folder lists its files in the same dialog. Press a file to preview it, or a folder inside to list that one, and **Back** returns to the list. Pressing any other local deliverable opens it with its default app on the machine running the Paseo daemon (for example HTML in your browser). On macOS, **Open** sends text files to your default browser. Only recorded deliverables inside the worktree open this way; otherwise the path is copied. The copy icon on each row copies the path.
 - Several agents can share one run. When another session adds a ticket, each agent sees it at the end of its next command's output (and in `show`), and the skill has it work that ticket in order after its current one. An agent only hears about tickets added since its own last update in the run, and only once.
 - Subagents record their own progress. Since Paseo 0.11, an agent waiting on background subagents shows as idle, so only the subagents' updates show the work is still going. The skill has the agent give each subagent the worktree path and ticket id, and the subagent records its stages and a ticker line on that worktree's dashboard.
 - `start` begins a fresh dashboard. Earlier runs stay in the file. Question references stay unique across runs.
@@ -120,11 +120,25 @@ The progress file, `progress.jsonl`, holds one JSON event per line, each with a
 - Progress folders outside the repo stay behind when a worktree is deleted. They're small, and you can delete them from `~/.local/state/paseo-progress/`.
 - Paseo can't open a panel without switching you to its workspace. So a new run shows a "Progress" pill, and you open the panel yourself.
 - Pills check busy worktrees every 5 seconds and quiet ones every 30. In a quiet worktree, a new question can take up to half a minute to show.
-- Previews cover images up to 10 MB and the first 256 KB of a text file. Other files open in their default app.
+- Previews cover images up to 10 MB, videos up to 200 MB (desktop app only), the first 256 KB of a text file, and the first 500 items in a folder. The folder list leaves out hidden files. Other files open in their default app. A video the app can't decode shows the player's error, and **Open** still works.
 - Stale warnings and overdue times use the daemon host's clock.
 
 ## Changelog
 
+### 1.2.0
+
+- A folder deliverable opens in Paseo as a list of its files. Press a file to preview it, or a folder inside to list that one; **Back** returns to the list. This works from a phone and when the worktree is on another computer. Before, Progress asked the computer running Paseo to open the folder. On a Linux server with no desktop, that failed with `spawn xdg-open ENOENT`.
+- A folder attached to a question lists its files the same way.
+- Every **Back** button says just **Back**. Before, it named where it went, like **Back to Q3**.
+- The preview hides **Open** when the computer running Paseo can't open files, like a Linux server you reach over ssh. There, a file Paseo can't preview copies its path and says why: `Can't open files on my-server. Copied path`.
+- Error messages in the panel no longer end in Paseo's `requestType=… code=…` text.
+
+### 1.1.0
+
+- Videos play in the preview. MP4, MOV and WebM files up to 200 MB play in Paseo's desktop app, with a loading percentage while they arrive. On a phone, a video opens on the computer running the Paseo daemon, as before.
+- The left and right arrow keys move to the previous and next file in a preview. **Next** has focus when the preview opens, so Enter moves on too.
+- An image too tall for the preview, like a phone screenshot, could make it flicker between two sizes until you closed it. It now opens at its real shape and holds still.
+
 ### 1.0.0
 
 - Version 1.0. Nothing you use changes. From now on, a new first number means an update breaks something, a new middle number means a new feature, and a new last number means a fix.

package/client/attachments.tsx

@@ -3,6 +3,7 @@ import { copyText, Icon, useToast } from "@getpaseo/plugin/client/react-native";
 import React from "react";
 import { Platform, Text, View } from "react-native";
 import { type Attachment, attachmentIcon, canPreview, shortName } from "../shared/attachments";
+import { errorText } from "./errors";
 import { PressableRow } from "./row";
 import { openDeliverable } from "../shared/rpc";
 
@@ -24,10 +25,6 @@ export function absolutePath(path: string, root: string): string {
   return path === "./" ? `${base}/` : `${base}/${path}`;
 }
 
-// Opens attachments the same way everywhere. Web links go to Paseo's browser
-// (the system browser where there is none); images and text go to `onPreview` when the
-// caller can show the preview dialog; every other local file opens with its
-// default app on the daemon host.
 export function useAttachmentOpener({ workspaceId, workspaceDirectory, navigation, onPreview }: {
   workspaceId: string;
   workspaceDirectory: string;
@@ -49,7 +46,7 @@ export function useAttachmentOpener({ workspaceId, workspaceDirectory, navigatio
       await openOnHostRpc({ workspaceId, workspaceDirectory, ref: attachment.ref });
       toast.show(`Opened ${attachment.title}`, { variant: "success" });
     } catch (error) {
-      await copyPath(attachment, `${error instanceof Error ? error.message : "Could not open it"}. `);
+      await copyPath(attachment, `${errorText(error, "Could not open it")}. `);
     }
   }
   async function open(attachment: Attachment) {
@@ -71,21 +68,23 @@ export function useAttachmentOpener({ workspaceId, workspaceDirectory, navigatio
   return { open, openOnHost, copyPath };
 }
 
+export const ATTACHMENT_ROW = { gap: 2, paddingVertical: 3, lineHeight: 17 };
+
 // A question's attachments as pressable rows.
 // Drawn in dialogs and the popover (surface1) unless `onSurface1` is false.
 // `onOpen` also gets the whole list, so a preview can step through its siblings.
 export function AttachmentList({ colors, attachments, onOpen, onSurface1 = true }: { colors: Colors; attachments: Attachment[]; onOpen(attachment: Attachment, group: Attachment[]): void; onSurface1?: boolean }) {
   if (!attachments.length) return null;
   return (
-    <View style={{ gap: 2 }}>
+    <View style={{ gap: ATTACHMENT_ROW.gap }}>
       {attachments.map((attachment) => (
         <PressableRow key={attachment.ref} colors={colors} onSurface1={onSurface1} accessibilityRole={attachment.url ? "link" : "button"} accessibilityLabel={`Open ${attachment.title}`}
           onPress={() => onOpen(attachment, attachments)}
-          style={{ flexDirection: "row", gap: 6, alignItems: "center", paddingVertical: 3, paddingHorizontal: 4, marginHorizontal: -4, borderRadius: 4 }}>
+          style={{ flexDirection: "row", gap: 6, alignItems: "center", paddingVertical: ATTACHMENT_ROW.paddingVertical, paddingHorizontal: 4, marginHorizontal: -4, borderRadius: 4 }}>
           {/* A 14px slot, like a section icon, so the title lines up with the heading above. */}
           <View style={{ width: 14, alignItems: "center" }}><Icon name={attachmentIcon(attachment)} size={12} color={colors.foregroundMuted} /></View>
           {/* The row is the target, so nothing in it is styled as a link. */}
-          <Text numberOfLines={1} style={{ flexShrink: 1, color: colors.foreground, fontSize: 12, lineHeight: 17 }}>{attachment.title}</Text>
+          <Text numberOfLines={1} style={{ flexShrink: 1, color: colors.foreground, fontSize: 12, lineHeight: ATTACHMENT_ROW.lineHeight }}>{attachment.title}</Text>
           {shortName(attachment) !== attachment.title ? (
             <Text numberOfLines={1} style={{ flex: 1, minWidth: 0, color: colors.foregroundMuted, fontSize: 11, lineHeight: 16 }}>{shortName(attachment)}</Text>
           ) : <View style={{ flex: 1 }} />}

package/client/deliverables.tsx

@@ -6,7 +6,8 @@ import type { Deliverable } from "../shared/dashboard";
 import { type Attachment, attachmentIcon, deliverableAttachment, shortName, useAttachmentOpener } from "./attachments";
 import { formatAgo } from "../shared/format";
 import { PressScale } from "./motion";
-import { PreviewDialog, previewable } from "./preview";
+import { StackedDialog } from "./dialog-stack";
+import { galleryFiles } from "./preview";
 import { PressableRow } from "./row";
 import { ShowMoreRow, usePaged } from "./show-more";
 
@@ -25,8 +26,7 @@ export function DeliverablesList({ colors, deliverables, now, workspaceId, works
   navigation: Navigation;
 }) {
   const [previewing, setPreviewing] = useState<Attachment | null>(null);
-  // Screenshots preview inside Paseo; links open in its browser; the rest open in their own app.
-  const { open, openOnHost, copyPath } = useAttachmentOpener({ workspaceId, workspaceDirectory, navigation, onPreview: setPreviewing });
+  const { open, copyPath } = useAttachmentOpener({ workspaceId, workspaceDirectory, navigation, onPreview: setPreviewing });
   const paged = usePaged(deliverables);
   return (
     <View>
@@ -59,9 +59,8 @@ export function DeliverablesList({ colors, deliverables, now, workspaceId, works
         </PressableRow>
       ))}
       <ShowMoreRow colors={colors} total={deliverables.length} paged={paged} />
-      <PreviewDialog colors={colors} attachment={previewing} workspaceId={workspaceId} workspaceDirectory={workspaceDirectory}
-        onClose={() => setPreviewing(null)} onOpenOnHost={(attachment) => void openOnHost(attachment)}
-        gallery={{ items: previewable(deliverables.map(deliverableAttachment)), onSelect: setPreviewing }} />
+      <StackedDialog colors={colors} now={now} onClose={() => setPreviewing(null)} context={{ workspaceId, workspaceDirectory, navigation }}
+        root={previewing ? { kind: "preview", attachment: previewing, group: galleryFiles(deliverables.map(deliverableAttachment)) } : null} />
     </View>
   );
 }

package/client/dialog-stack.tsx

@@ -3,9 +3,8 @@ import { Icon, Modal } from "@getpaseo/plugin/client/react-native";
 import React, { useEffect, useRef, useState } from "react";
 import type { Dashboard, Question } from "../shared/dashboard";
 import { type Attachment, attachmentIcon, useAttachmentOpener } from "./attachments";
-import { useLastPresent } from "./motion";
 import { NarrowProvider } from "./narrow";
-import { BackButton, PreviewContent, previewable } from "./preview";
+import { BackButton, galleryFiles, PreviewContent } from "./preview";
 import { QuestionView, useCopy } from "./questions";
 import { TicketStoryView } from "./ticket-dialog";
 
@@ -18,35 +17,32 @@ export type Step =
   | { kind: "question"; id: string }
   | { kind: "preview"; attachment: Attachment; group: Attachment[] };
 
-// One dialog for a ticket or a question and everything opened from it. Paseo
-// gives each dialog its own backdrop, so opening a second one darkens the screen
-// while the first fades out; instead the content changes in place, and Back
-// returns to the step before.
-export function StackedDialog({ colors, root, onClose, questions, dashboard, now, live = true, context }: {
+// Paseo gives each dialog its own backdrop, so opening a second one darkens
+// the screen while the first fades out; steps swap content inside this one instead.
+export function StackedDialog({ colors, root, onClose, questions = [], dashboard, now, live = true, context }: {
   colors: Colors;
-  // The ticket or question it opens on; null closes it.
   root: Step | null;
   onClose(): void;
-  questions: Question[];
+  questions?: Question[];
   // Needed only when it opens on a ticket.
   dashboard?: Dashboard;
   now: number;
   live?: boolean;
   context: AttachmentContext;
 }) {
-  // What was opened on top of the root, oldest first. Cleared when a new root opens.
-  const [trail, setTrail] = useState<Step[]>([]);
-  const rootKey = root && root.kind !== "preview" ? `${root.kind}:${root.id}` : null;
-  const [trailFor, setTrailFor] = useState(rootKey);
-  if (trailFor !== rootKey) {
-    setTrailFor(rootKey);
-    if (rootKey) setTrail([]);
+  // Paseo's Modal keeps drawing its content while it fades out, so closing keeps the steps.
+  const [steps, setSteps] = useState<Step[]>(root ? [root] : []);
+  const rootKey = root ? stepKey(root) : null;
+  const [stepsFor, setStepsFor] = useState(rootKey);
+  if (stepsFor !== rootKey) {
+    setStepsFor(rootKey);
+    if (root) setSteps([root]);
   }
   // The list an attachment was opened from, so its preview can step through the rest.
   const group = useRef<Attachment[]>([]);
-  const push = (step: Step) => setTrail((current) => [...current, step]);
-  const replaceTop = (step: Step) => setTrail((current) => [...current.slice(0, -1), step]);
-  const opener = useAttachmentOpener({ ...context, onPreview: (attachment) => push({ kind: "preview", attachment, group: previewable(group.current) }) });
+  const push = (step: Step) => setSteps((current) => [...current, step]);
+  const replaceTop = (step: Step) => setSteps((current) => [...current.slice(0, -1), step]);
+  const opener = useAttachmentOpener({ ...context, onPreview: (attachment) => push({ kind: "preview", attachment, group: galleryFiles(group.current) }) });
   const openAttachment = (attachment: Attachment, from: Attachment[]) => {
     group.current = from;
     // A link opens elsewhere in Paseo; close first so it isn't left behind the dialog.
@@ -59,12 +55,9 @@ export function StackedDialog({ colors, root, onClose, questions, dashboard, now
     context.navigation!.openAgent({ agentId });
   } : undefined;
   const copy = useCopy();
-  const steps: Step[] = root ? [root, ...trail] : [];
-  // Keep drawing the last step while the dialog fades out.
-  const shown = useLastPresent(steps.length ? { top: steps[steps.length - 1], previous: steps[steps.length - 2] } : null);
-  const back = shown?.previous ? { label: `Back to ${stepName(shown.previous)}`, onPress: () => setTrail((current) => current.slice(0, -1)) } : null;
+  const top = steps.at(-1);
+  const back = steps.length > 1 ? () => setSteps((current) => current.slice(0, -1)) : undefined;
 
-  const top = shown?.top;
   const ticket = top?.kind === "ticket" ? dashboard?.tickets.find((candidate) => candidate.id === top.id) : undefined;
   const question = top?.kind === "question" ? questions.find((candidate) => candidate.id === top.id) : undefined;
   const preview = top?.kind === "preview" ? top : undefined;
@@ -87,8 +80,9 @@ export function StackedDialog({ colors, root, onClose, questions, dashboard, now
       <NarrowProvider value={false}>
       {preview ? (
         <PreviewContent colors={colors} attachment={preview.attachment} workspaceId={context.workspaceId} workspaceDirectory={context.workspaceDirectory}
-          onOpenOnHost={() => { onClose(); void opener.openOnHost(preview.attachment); }} backLabel={back?.label} onBack={back?.onPress}
-          gallery={{ items: preview.group, onSelect: (attachment) => replaceTop({ ...preview, attachment }) }} onLong={setPreviewLong} />
+          onOpenOnHost={() => { onClose(); void opener.openOnHost(preview.attachment); }} onBack={back}
+          gallery={{ items: preview.group, onSelect: (attachment) => replaceTop({ ...preview, attachment }) }} onLong={setPreviewLong}
+          onOpenEntry={openAttachment} />
       ) : (
         <>
           {ticket && dashboard ? (
@@ -99,7 +93,7 @@ export function StackedDialog({ colors, root, onClose, questions, dashboard, now
             <QuestionView colors={colors} question={question} now={now}
               onCopy={(letter) => { void copy(question, letter); onClose(); }}
               onOpenAttachment={openAttachment}>
-              {back ? <BackButton colors={colors} label={back.label} onPress={back.onPress} /> : null}
+              {back ? <BackButton colors={colors} onPress={back} /> : null}
             </QuestionView>
           ) : null}
         </>
@@ -110,6 +104,7 @@ export function StackedDialog({ colors, root, onClose, questions, dashboard, now
   );
 }
 
-function stepName(step: Step): string {
-  return step.kind === "preview" ? step.attachment.title : step.id;
+function stepKey(step: Step): string {
+  return step.kind === "preview" ? `preview:${step.attachment.ref}` : `${step.kind}:${step.id}`;
 }
+

package/client/errors.ts

@@ -0,0 +1,6 @@
+// Paseo wraps a handler's error as "Request failed: <message> requestType=… code=…".
+export function errorText(error: unknown, fallback: string): string {
+  const message = (error as { message?: unknown } | null)?.message;
+  if (typeof message !== "string") return fallback;
+  return message.replace(/^Request failed: /, "").replace(/ requestType=\S+(?: code=\S+)?$/, "").trim() || fallback;
+}

package/client/history.tsx

@@ -6,6 +6,7 @@ import { ActivityIndicator, ScrollView, Text, TextInput, View } from "react-nati
 import { PressScale } from "./motion";
 import { PressableRow } from "./row";
 import { listFolders, setHistoryFolder } from "../shared/rpc";
+import { errorText } from "./errors";
 
 type Colors = PluginWorkspacePanelProps["theme"]["colors"];
 
@@ -27,7 +28,7 @@ export function HistoryRow({ colors, workspaceId, directory, savedTo }: {
       queryClient.invalidateQueries({ queryKey: ["progress", "dashboard"] });
       toast.show(next ? `Each run will be saved to ${next}.` : "Runs will stay on this computer. Files already saved stay in the repo.", { variant: "success" });
     },
-    onError: (error) => toast.error(error instanceof Error ? error.message : "Could not change where runs are saved."),
+    onError: (error) => toast.error(errorText(error, "Could not change where runs are saved.")),
   });
   // While saving, the button that started it says so.
   const busy = mutation.isPending ? (mutation.variables === null ? "stop" : "pick") : null;
@@ -119,7 +120,7 @@ function FolderPicker({ colors, workspaceId, directory, open, start, onClose, on
           {listed.data && !listed.data.folders.length ? (
             <Text style={{ color: colors.foregroundMuted, fontSize: 12, lineHeight: 16, paddingHorizontal: 8, paddingVertical: 6 }}>No folders in here.</Text>
           ) : null}
-          {listed.error ? <Text accessibilityRole="alert" style={{ color: colors.statusDanger, fontSize: 12, lineHeight: 17, paddingHorizontal: 8 }}>{listed.error.message}</Text> : null}
+          {listed.error ? <Text accessibilityRole="alert" style={{ color: colors.statusDanger, fontSize: 12, lineHeight: 17, paddingHorizontal: 8 }}>{errorText(listed.error, "Could not list the folders.")}</Text> : null}
         </ScrollView>
 
         {naming === null ? (

package/client/launcher.tsx

@@ -6,6 +6,7 @@ import { Text, View } from "react-native";
 import { PressScale, Presence } from "./motion";
 import { raised } from "./surfaces";
 import { getLauncherStatus, getSkillStatus, installLauncher, installSkill, type LauncherStatus, type SkillStatus } from "../shared/rpc";
+import { errorText } from "./errors";
 
 type Colors = PluginWorkspacePanelProps["theme"]["colors"];
 
@@ -60,7 +61,7 @@ export function LauncherBanner({ colors, host }: { colors: Colors; host: PluginW
       queryClient.setQueryData(launcherQueryKey(host.id), next);
       toast.show(`Installed paseo-progress at ${next.path}`, { variant: "success" });
     },
-    onError: (error) => toast.error(error instanceof Error ? error.message : "Could not install the command."),
+    onError: (error) => toast.error(errorText(error, "Could not install the command.")),
   });
   const notice = status.data ? launcherNotice(status.data) : null;
   return <SetupBanner colors={colors} icon="Terminal" notice={notice} pending={mutation.isPending} onPress={() => mutation.mutate()} />;
@@ -78,7 +79,7 @@ export function SkillBanner({ colors, host }: { colors: Colors; host: PluginWork
       queryClient.setQueryData(skillQueryKey(host.id), next);
       toast.show("Installed the paseo-progress skill. New agent sessions will use it.", { variant: "success" });
     },
-    onError: (error) => toast.error(error instanceof Error ? error.message : "Could not install the skill."),
+    onError: (error) => toast.error(errorText(error, "Could not install the skill.")),
   });
   const notice = status.data ? skillNotice(status.data) : null;
   return <SetupBanner colors={colors} icon="Sparkles" notice={notice} pending={mutation.isPending} onPress={() => mutation.mutate()} />;

package/client/motion.tsx

@@ -1,5 +1,5 @@
 import React, { createContext, useContext, useEffect, useLayoutEffect, useRef, useState } from "react";
-import { AccessibilityInfo, Animated, Easing, Platform, Pressable, type PressableProps, type StyleProp, type ViewStyle } from "react-native";
+import { AccessibilityInfo, Animated, Easing, Platform, Pressable, type PressableProps, type StyleProp, type View, type ViewStyle } from "react-native";
 
 // Read at render time, not import time. The native driver can't run on web,
 // and web is the only place filter blur renders.
@@ -24,17 +24,11 @@ export function useReducedMotion(): boolean {
   return reduced;
 }
 
-// The last non-null value, so a dialog keeps its content while it animates
-// closed instead of collapsing mid-exit.
-export function useLastPresent<T>(value: T | null): T | null {
-  const last = useRef(value);
-  if (value !== null) last.current = value;
-  return value ?? last.current;
-}
-
 // A button that scales to 0.96 while pressed. `static` turns the scale off.
 export function PressScale({ static: isStatic, style, outerStyle, children, ...props }: Omit<PressableProps, "style" | "children"> & {
   static?: boolean;
+  // Reaches the pressable itself, e.g. to focus it.
+  ref?: React.Ref<View>;
   // Layout for the pressable itself, e.g. alignSelf; `style` is what scales.
   outerStyle?: StyleProp<ViewStyle>;
   style?: StyleProp<ViewStyle> | ((state: { pressed: boolean; hovered: boolean }) => StyleProp<ViewStyle>);

package/client/panel.tsx

@@ -23,6 +23,7 @@ import { TabStrip } from "./tabs";
 import { ShowMoreRow, usePaged } from "./show-more";
 import { notePanelOpened } from "./panel-opened";
 import { NARROW_MAX, NarrowProvider, useNarrow } from "./narrow";
+import { errorText } from "./errors";
 
 type Colors = PluginWorkspacePanelProps["theme"]["colors"];
 
@@ -52,7 +53,7 @@ function WorkspaceProgress({ theme, workspaceId, host, layout, navigation }: Plu
       {query.isPending ? <ActivityIndicator color={colors.foregroundMuted} accessibilityLabel="Loading progress" style={{ padding: 12 }} /> : null}
       {query.error ? (
         <Text accessibilityRole="alert" selectable style={{ color: colors.statusDanger, fontSize: 12, lineHeight: 18, padding: 12 }}>
-          Could not read progress: {query.error.message}
+          Could not read progress: {errorText(query.error, "something went wrong")}
         </Text>
       ) : null}
       <LauncherBanner colors={colors} host={host} />

package/client/pill-popover.tsx

@@ -7,8 +7,10 @@ import { useDashboard } from "./dashboard-query";
 import { progressPanel } from "./pills";
 import { PressScale } from "./motion";
 import { type Attachment, isPreviewable, useAttachmentOpener } from "./attachments";
-import { PreviewDialog, previewable } from "./preview";
+import { StackedDialog } from "./dialog-stack";
+import { galleryFiles } from "./preview";
 import { QuestionDetail, QuestionState, useCopy } from "./questions";
+import { errorText } from "./errors";
 import { raised } from "./surfaces";
 
 type Colors = PluginButtonContentProps["theme"]["colors"];
@@ -35,7 +37,7 @@ export function AttentionPopover({ theme, host, layout, workspaceId, close, open
   // Links and other files leave Paseo, so the popover closes for those.
   const [previewing, setPreviewing] = useState<{ attachment: Attachment; group: Attachment[] } | null>(null);
   const group = useRef<Attachment[]>([]);
-  const opener = useAttachmentOpener({ workspaceId, workspaceDirectory: root, onPreview: (attachment) => setPreviewing({ attachment, group: previewable(group.current) }) });
+  const opener = useAttachmentOpener({ workspaceId, workspaceDirectory: root, onPreview: (attachment) => setPreviewing({ attachment, group: galleryFiles(group.current) }) });
   return (
     <View style={{ width: 360, maxWidth: "100%", gap: 8 }}>
       {dashboard ? (
@@ -51,12 +53,11 @@ export function AttentionPopover({ theme, host, layout, workspaceId, close, open
         </List>
       ) : (
         <Text style={{ color: colors.foregroundMuted, fontSize: 12, lineHeight: 18 }}>
-          {query.error ? `Could not read progress: ${query.error.message}` : "Loading…"}
+          {query.error ? `Could not read progress: ${errorText(query.error, "something went wrong")}` : "Loading…"}
         </Text>
       )}
-      <PreviewDialog colors={colors} attachment={previewing?.attachment ?? null} workspaceId={workspaceId} workspaceDirectory={root}
-        onClose={() => setPreviewing(null)} onOpenOnHost={(attachment) => void opener.openOnHost(attachment)}
-        gallery={previewing ? { items: previewing.group, onSelect: (attachment) => setPreviewing({ ...previewing, attachment }) } : undefined} />
+      <StackedDialog colors={colors} now={Date.now()} onClose={() => setPreviewing(null)} context={{ workspaceId, workspaceDirectory: root }}
+        root={previewing ? { kind: "preview", ...previewing } : null} />
       <View style={{ paddingTop: touch ? 12 : 8, borderTopWidth: 1, borderTopColor: colors.border }}>
         {/* A full 44pt touch target on phones; desktop keeps the compact button. */}
         <PressScale accessibilityRole="button" onPress={() => { close(); openPanel(); }}