feat(ui): persistent 'Reset filters' control in the Agent Runs filter bar (#6818)

The Agent Runs filter bar (Status/Kind chips + search) had no reset
affordance while filters were active — a 'Clear filters' button existed ONLY
inside the `filtered.length === 0` empty state, which is unreachable whenever
the active filters still match at least one run. An operator narrowing to
e.g. status=ready then had no way back to all runs short of editing the URL.

Add a persistent 'Reset filters' control in the bar itself, always rendered
and enabled only once some filter is away from its default — mirroring the
always-present Reset in AuditFilters (components/site/audit-feed.tsx). Both it
and the empty-state 'Clear filters' button now call one shared `resetFilters`
handler (clears status/kind/search in a single navigation + toasts), so the
two paths can't drift.

The filter bar is extracted into an exported, prop-driven `RunsFilterBar`
(like the existing `DrawerSurface`) so the reset behavior is unit-testable
without mounting the routed page. Adds regression tests: the reset renders in
the bar (not only the empty state), is disabled at defaults, enables on any
non-default filter, and clears through the shared handler.

Closes #6818

Author: jaytbarimbao-collab

apps/loopover-ui/src/routes/app.runs.test.tsx

@@ -5,7 +5,7 @@ import { beforeEach, describe, expect, it, vi } from "vitest";
 const { success, error } = vi.hoisted(() => ({ success: vi.fn(), error: vi.fn() }));
 vi.mock("sonner", () => ({ toast: { success, error } }));
 
-import { DrawerSurface } from "./app.runs";
+import { DrawerSurface, RunsFilterBar } from "./app.runs";
 
 const run = {
   id: "run_1",
@@ -113,3 +113,57 @@ describe("run drawer Inputs copy button", () => {
     expect(success).toHaveBeenCalledWith("Permalink copied", expect.anything());
   });
 });
+
+// #6818: the filter bar previously had NO reset affordance — a "Clear filters" button existed only inside the
+// `filtered.length === 0` empty state, so an operator whose filters still matched at least one run had no way to
+// clear them without hand-editing the URL. These lock in the persistent control in the bar itself.
+describe("Agent Runs filter bar persistent reset (#6818)", () => {
+  const noop = () => undefined;
+  const renderBar = (over: Partial<Parameters<typeof RunsFilterBar>[0]> = {}) =>
+    render(
+      <RunsFilterBar
+        status="all"
+        kind="all"
+        q=""
+        hasActiveFilters={false}
+        onStatusChange={noop}
+        onKindChange={noop}
+        onQChange={noop}
+        onReset={noop}
+        {...over}
+      />,
+    );
+
+  it("renders the reset control in the bar itself, not only in the zero-results empty state", () => {
+    renderBar();
+    expect(screen.getByRole("button", { name: "Reset filters" })).toBeTruthy();
+  });
+
+  it("disables the reset while every filter is still at its default", () => {
+    renderBar();
+    expect(
+      (screen.getByRole("button", { name: "Reset filters" }) as HTMLButtonElement).disabled,
+    ).toBe(true);
+  });
+
+  it("enables the reset as soon as any filter is non-default", () => {
+    for (const active of [
+      { status: "ready" as const },
+      { kind: "plan-next-work" as const },
+      { q: "acme" },
+    ]) {
+      const { unmount } = renderBar({ hasActiveFilters: true, ...active });
+      expect(
+        (screen.getByRole("button", { name: "Reset filters" }) as HTMLButtonElement).disabled,
+      ).toBe(false);
+      unmount();
+    }
+  });
+
+  it("clears every filter through one shared handler when clicked", () => {
+    const onReset = vi.fn();
+    renderBar({ hasActiveFilters: true, status: "ready", onReset });
+    fireEvent.click(screen.getByRole("button", { name: "Reset filters" }));
+    expect(onReset).toHaveBeenCalledTimes(1);
+  });
+});

apps/loopover-ui/src/routes/app.runs.tsx

@@ -25,7 +25,7 @@ import {
 } from "@/components/site/control-primitives";
 import { useApiResource } from "@/lib/api/use-api-resource";
 import { useSession } from "@/lib/api/session";
-import { EmptyState, StateBoundary } from "@/components/site/state-views";
+import { EmptyState, StateActionButton, StateBoundary } from "@/components/site/state-views";
 import { RefreshMeta } from "@/components/site/refresh-meta";
 import { Skeleton } from "@/components/ui/skeleton";
 import { useLocalStorage } from "@/lib/use-local-storage";
@@ -112,6 +112,77 @@ export const Route = createFileRoute("/app/runs")({
   component: AgentRuns,
 });
 
+/**
+ * The Agent Runs filter bar: Status/Kind chips, the search box, and the persistent "Reset filters" control
+ * (#6818). Before that control existed, the ONLY way to clear filters was the button inside the zero-results
+ * empty state — unreachable while the active filters still matched at least one run. The reset is always
+ * rendered here (mirroring `AuditFilters`' always-present Reset in components/site/audit-feed.tsx) and enabled
+ * only once some filter is away from its default.
+ *
+ * Exported and fully prop-driven — like `DrawerSurface` — so the filter/reset behavior is unit-testable without
+ * mounting the routed page (and its router/session/API context).
+ */
+export function RunsFilterBar({
+  status,
+  kind,
+  q,
+  hasActiveFilters,
+  onStatusChange,
+  onKindChange,
+  onQChange,
+  onReset,
+}: {
+  status: StatusFilter;
+  kind: KindFilter;
+  q: string;
+  hasActiveFilters: boolean;
+  onStatusChange: (value: StatusFilter) => void;
+  onKindChange: (value: KindFilter) => void;
+  onQChange: (value: string) => void;
+  onReset: () => void;
+}) {
+  return (
+    <div className="rounded-token border border-border bg-transparent p-3">
+      <div className="flex flex-wrap items-center gap-2">
+        <div className="inline-flex items-center gap-1.5 font-mono text-token-2xs uppercase tracking-wider text-muted-foreground">
+          <Filter className="size-3.5" />
+          Status
+        </div>
+        <div className="flex flex-wrap gap-1">
+          {STATUS_FILTERS.map((s) => (
+            <Chip key={s} active={status === s} onClick={() => onStatusChange(s)}>
+              {s}
+            </Chip>
+          ))}
+        </div>
+        <span aria-hidden className="ml-2 hidden accent-divider-v-tall sm:inline-block" />
+        <div className="inline-flex items-center gap-1.5 font-mono text-token-2xs uppercase tracking-wider text-muted-foreground">
+          Kind
+        </div>
+        <div className="flex flex-wrap gap-1">
+          {KIND_FILTERS.map((k) => (
+            <Chip key={k} active={kind === k} onClick={() => onKindChange(k)}>
+              {k}
+            </Chip>
+          ))}
+        </div>
+        <div className="ml-auto inline-flex items-center gap-2 rounded-token border border-border bg-background/40 px-2">
+          <Search className="size-3.5 text-muted-foreground" />
+          <input
+            value={q}
+            onChange={(e) => onQChange(e.target.value)}
+            placeholder="Search runs…"
+            className="w-40 border-0 bg-transparent py-1 text-token-sm outline-none placeholder:text-muted-foreground"
+          />
+        </div>
+        <StateActionButton onClick={onReset} disabled={!hasActiveFilters}>
+          Reset filters
+        </StateActionButton>
+      </div>
+    </div>
+  );
+}
+
 function AgentRuns() {
   const search = Route.useSearch();
   const navigate = useNavigate({ from: Route.fullPath });
@@ -174,6 +245,27 @@ function AgentRuns() {
       replace: true,
     });
 
+  /** Any filter away from its default ("all"/"all"/empty search) — drives the filter bar's persistent Reset. */
+  const hasActiveFilters = status !== "all" || kind !== "all" || q !== "";
+
+  /** Clear every filter in a single navigation (#6818). Shared by the filter bar's persistent Reset control and
+   *  the zero-results empty state's "Clear filters" button, so the two can never drift apart — mirroring
+   *  AuditFilters' `resetFilters` in components/site/audit-feed.tsx. */
+  const resetFilters = () => {
+    navigate({
+      search: (p: z.infer<typeof searchSchema>) => ({
+        ...p,
+        status: undefined,
+        kind: undefined,
+        q: undefined,
+      }),
+      replace: true,
+    });
+    toast("Filters cleared", {
+      description: "Showing all available agent runs again.",
+    });
+  };
+
   const filtered = useMemo(() => {
     const term = q.trim().toLowerCase();
     return runs.filter((r) => {
@@ -253,41 +345,16 @@ function AgentRuns() {
         loadingSkeleton={<RunsListSkeleton />}
       >
         <div className="space-y-5">
-          <div className="rounded-token border border-border bg-transparent p-3">
-            <div className="flex flex-wrap items-center gap-2">
-              <div className="inline-flex items-center gap-1.5 font-mono text-token-2xs uppercase tracking-wider text-muted-foreground">
-                <Filter className="size-3.5" />
-                Status
-              </div>
-              <div className="flex flex-wrap gap-1">
-                {STATUS_FILTERS.map((s) => (
-                  <Chip key={s} active={status === s} onClick={() => setStatus(s)}>
-                    {s}
-                  </Chip>
-                ))}
-              </div>
-              <span aria-hidden className="ml-2 hidden accent-divider-v-tall sm:inline-block" />
-              <div className="inline-flex items-center gap-1.5 font-mono text-token-2xs uppercase tracking-wider text-muted-foreground">
-                Kind
-              </div>
-              <div className="flex flex-wrap gap-1">
-                {KIND_FILTERS.map((k) => (
-                  <Chip key={k} active={kind === k} onClick={() => setKind(k)}>
-                    {k}
-                  </Chip>
-                ))}
-              </div>
-              <div className="ml-auto inline-flex items-center gap-2 rounded-token border border-border bg-background/40 px-2">
-                <Search className="size-3.5 text-muted-foreground" />
-                <input
-                  value={q}
-                  onChange={(e) => setQ(e.target.value)}
-                  placeholder="Search runs…"
-                  className="w-40 border-0 bg-transparent py-1 text-token-sm outline-none placeholder:text-muted-foreground"
-                />
-              </div>
-            </div>
-          </div>
+          <RunsFilterBar
+            status={status}
+            kind={kind}
+            q={q}
+            hasActiveFilters={hasActiveFilters}
+            onStatusChange={setStatus}
+            onKindChange={setKind}
+            onQChange={setQ}
+            onReset={resetFilters}
+          />
 
           <SavedViews
             current={{ status, kind, q }}
@@ -316,14 +383,7 @@ function AgentRuns() {
                   action={
                     <button
                       type="button"
-                      onClick={() => {
-                        setStatus("all");
-                        setKind("all");
-                        setQ("");
-                        toast("Filters cleared", {
-                          description: "Showing all available agent runs again.",
-                        });
-                      }}
+                      onClick={resetFilters}
                       className="inline-flex min-w-0 items-center justify-center rounded-token border border-border bg-transparent px-3 py-1.5 text-center text-token-xs font-medium text-foreground transition-all duration-150 hover:bg-accent focus-ring motion-reduce:transition-none motion-reduce:active:scale-100 active:scale-[0.98]"
                     >
                       Clear filters