From c5bbe134e8a19ac864ccbffcd3d912d8f1a02e73 Mon Sep 17 00:00:00 2001
From: "jared-outpost[bot]" <jared-outpost[bot]@users.noreply.github.com>
Date: Sat, 19 Sep 2026 15:05:03 +0000
Subject: [PATCH] align agent runs route path with sidebar label

rename the /containers UI routes to /runs so the address bar matches the
"Agent runs" sidebar label. legacy /containers/* URLs redirect to
/runs/* so existing bookmarks and shared links keep working. backend
/api/containers endpoints and @/lib/containers imports are unchanged.

Fixes #207
---
 apps/server/src/client/App.tsx                   | 16 ++++++++++++----
 .../src/client/pages/container-detail.test.ts    |  2 +-
 .../server/src/client/pages/container-detail.tsx | 10 +++++-----
 apps/server/src/client/pages/event-detail.tsx    |  2 +-
 apps/server/src/client/pages/sessions.tsx        |  4 ++--
 .../components/clear-sessions-feedback.test.ts   |  2 +-
 .../src/components/clear-sessions-feedback.tsx   |  2 +-
 apps/server/src/components/layout.tsx            |  2 +-
 apps/server/src/components/new-chat-dialog.tsx   |  2 +-
 9 files changed, 25 insertions(+), 17 deletions(-)

diff --git a/apps/server/src/client/App.tsx b/apps/server/src/client/App.tsx
index 85c027f6..cbf31c11 100644
--- a/apps/server/src/client/App.tsx
+++ b/apps/server/src/client/App.tsx
@@ -1,4 +1,4 @@
-import { BrowserRouter, Route, Routes } from "react-router-dom"
+import { BrowserRouter, Navigate, Route, Routes, useLocation } from "react-router-dom"
 import ContainerDetailPage from "@/client/pages/container-detail"
 import DashboardPage from "@/client/pages/dashboard"
 import EventDetailPage from "@/client/pages/event-detail"
@@ -26,9 +26,10 @@ function App() {
             <Route index element={<DashboardPage />} />
             <Route path="events" element={<EventsPage />} />
             <Route path="events/:id" element={<EventDetailPage />} />
-            <Route path="containers" element={<SessionsPage />} />
-            <Route path="containers/detail" element={<ContainerDetailPage />} />
-            <Route path="containers/:entityKey" element={<ContainerDetailPage />} />
+            <Route path="runs" element={<SessionsPage />} />
+            <Route path="runs/detail" element={<ContainerDetailPage />} />
+            <Route path="runs/:entityKey" element={<ContainerDetailPage />} />
+            <Route path="containers/*" element={<ContainersRedirect />} />
             <Route path="*" element={<NotFoundPage />} />
           </Route>
         </Routes>
@@ -37,4 +38,11 @@ function App() {
   )
 }
 
+// Redirect legacy /containers/* URLs (bookmarks, shared links) to /runs/*.
+function ContainersRedirect() {
+  const location = useLocation()
+  const target = location.pathname.replace(/^\/containers/, "/runs")
+  return <Navigate to={`${target}${location.search}${location.hash}`} replace />
+}
+
 export default App
diff --git a/apps/server/src/client/pages/container-detail.test.ts b/apps/server/src/client/pages/container-detail.test.ts
index eca7ebf8..69490208 100644
--- a/apps/server/src/client/pages/container-detail.test.ts
+++ b/apps/server/src/client/pages/container-detail.test.ts
@@ -28,7 +28,7 @@ function renderRun(messages: SessionMessage[], extra: Partial<SessionDetailRespo
         { client },
         createElement(
           MemoryRouter,
-          { initialEntries: ["/containers/detail?key=acme%2Fapp%2342"] },
+          { initialEntries: ["/runs/detail?key=acme%2Fapp%2342"] },
           createElement(ContainerDetailPage),
         ),
       ),
diff --git a/apps/server/src/client/pages/container-detail.tsx b/apps/server/src/client/pages/container-detail.tsx
index 6d834c62..8a17c0bb 100644
--- a/apps/server/src/client/pages/container-detail.tsx
+++ b/apps/server/src/client/pages/container-detail.tsx
@@ -803,8 +803,8 @@ function SessionSidebarItem({
 export default function ContainerDetailPage() {
   const { entityKey: rawKey } = useParams<{ entityKey: string }>()
   const [searchParams] = useSearchParams()
-  // Prefer the query-param form (/containers/detail?key=...) which is refresh-safe;
-  // the path-param form (/containers/:entityKey) breaks on reload because the
+  // Prefer the query-param form (/runs/detail?key=...) which is refresh-safe;
+  // the path-param form (/runs/:entityKey) breaks on reload because the
   // encoded slash (%2F) in the entity key isn't matched by SPA asset fallback.
   const entityKey = searchParams.get("key") ?? (rawKey ? decodeURIComponent(rawKey) : "")
   const navigate = useNavigate()
@@ -909,7 +909,7 @@ export default function ContainerDetailPage() {
       onSuccess: () => {
         toast.success("Container destroyed")
         setDestroyOpen(false)
-        navigate("/containers")
+        navigate("/runs")
       },
       onError: () => toast.error("Failed to destroy container"),
     })
@@ -1032,7 +1032,7 @@ export default function ContainerDetailPage() {
     return (
       <div className="space-y-4">
         <div className="flex items-center justify-between gap-2">
-          <Button variant="ghost" size="sm" onClick={() => navigate("/containers")}>
+          <Button variant="ghost" size="sm" onClick={() => navigate("/runs")}>
             <ArrowLeft className="size-3.5" />
             Back to agent runs
           </Button>
@@ -1105,7 +1105,7 @@ export default function ContainerDetailPage() {
       <div className="shrink-0 border-b px-4 py-3">
         <div className="flex flex-col gap-2 sm:flex-row sm:items-center sm:gap-3">
           <div className="flex min-w-0 flex-1 items-center gap-2 sm:gap-3">
-            <Button variant="ghost" size="sm" className="shrink-0 px-2" onClick={() => navigate("/containers")}>
+            <Button variant="ghost" size="sm" className="shrink-0 px-2" onClick={() => navigate("/runs")}>
               <ArrowLeft className="size-3.5" />
               <span className="hidden sm:inline">Back</span>
             </Button>
diff --git a/apps/server/src/client/pages/event-detail.tsx b/apps/server/src/client/pages/event-detail.tsx
index 265af000..94ab680f 100644
--- a/apps/server/src/client/pages/event-detail.tsx
+++ b/apps/server/src/client/pages/event-detail.tsx
@@ -116,7 +116,7 @@ export default function EventDetailPage() {
             <Button
               variant="outline"
               size="sm"
-              onClick={() => navigate(`/containers/detail?key=${encodeURIComponent(event.entityKey)}`)}
+              onClick={() => navigate(`/runs/detail?key=${encodeURIComponent(event.entityKey)}`)}
             >
               <Cube className="size-3.5" />
               Open run
diff --git a/apps/server/src/client/pages/sessions.tsx b/apps/server/src/client/pages/sessions.tsx
index 5b650d4f..9716fec6 100644
--- a/apps/server/src/client/pages/sessions.tsx
+++ b/apps/server/src/client/pages/sessions.tsx
@@ -379,7 +379,7 @@ export default function SessionsPage() {
                   const parsed = parseEntityKey(session.entityKey)
                   const chatRepo = chatEntityRepo(session.entityKey)
                   const repoName = parsed ? `${parsed.owner}/${parsed.repo}` : chatRepo
-                  const detailHref = `/containers/detail?key=${encodeURIComponent(session.entityKey)}`
+                  const detailHref = `/runs/detail?key=${encodeURIComponent(session.entityKey)}`
                   const openDetail = () => navigate(detailHref)
 
                   return (
@@ -482,7 +482,7 @@ export default function SessionsPage() {
                       const chatRepo = chatEntityRepo(session.entityKey)
                       const repoName = parsed ? `${parsed.owner}/${parsed.repo}` : chatRepo
                       const openDetail = () =>
-                        navigate(`/containers/detail?key=${encodeURIComponent(session.entityKey)}`)
+                        navigate(`/runs/detail?key=${encodeURIComponent(session.entityKey)}`)
 
                       return (
                         <TableRow
diff --git a/apps/server/src/components/clear-sessions-feedback.test.ts b/apps/server/src/components/clear-sessions-feedback.test.ts
index 4952dfbc..1be3a1f1 100644
--- a/apps/server/src/components/clear-sessions-feedback.test.ts
+++ b/apps/server/src/components/clear-sessions-feedback.test.ts
@@ -23,7 +23,7 @@ it("shows partial counts and links only failed runs for deliberate per-run retry
     ),
   )
   expect(html).toContain("2 deleted; 1 could not be fully deleted")
-  expect(html).toContain("/containers/detail?key=acme%2Fapp%2342")
+  expect(html).toContain("/runs/detail?key=acme%2Fapp%2342")
   expect(html).not.toContain("deleted1")
   expect(html).toContain("Review each remaining run before retrying Destroy")
 })
diff --git a/apps/server/src/components/clear-sessions-feedback.tsx b/apps/server/src/components/clear-sessions-feedback.tsx
index f8e772c4..1fd5d5c7 100644
--- a/apps/server/src/components/clear-sessions-feedback.tsx
+++ b/apps/server/src/components/clear-sessions-feedback.tsx
@@ -25,7 +25,7 @@ export function ClearSessionsFeedback({ result, error }: { result?: ClearSession
         <ul className="flex max-h-40 flex-col gap-1 overflow-y-auto">
           {result.failed.map((entityKey) => (
             <li key={entityKey}>
-              <Link className="break-all underline" to={`/containers/detail?key=${encodeURIComponent(entityKey)}`}>
+              <Link className="break-all underline" to={`/runs/detail?key=${encodeURIComponent(entityKey)}`}>
                 {entityKey}
               </Link>
             </li>
diff --git a/apps/server/src/components/layout.tsx b/apps/server/src/components/layout.tsx
index 8198c5bf..94e4860d 100644
--- a/apps/server/src/components/layout.tsx
+++ b/apps/server/src/components/layout.tsx
@@ -39,7 +39,7 @@ import { authClient } from "@/lib/endpoint"
 const NAV_ITEMS = [
   { to: "/", label: "Dashboard", icon: House },
   { to: "/events", label: "Webhook Events", icon: Lightning },
-  { to: "/containers", label: "Agent runs", icon: Robot },
+  { to: "/runs", label: "Agent runs", icon: Robot },
 ]
 
 const THEME_OPTIONS = [
diff --git a/apps/server/src/components/new-chat-dialog.tsx b/apps/server/src/components/new-chat-dialog.tsx
index 591e38ff..75778f32 100644
--- a/apps/server/src/components/new-chat-dialog.tsx
+++ b/apps/server/src/components/new-chat-dialog.tsx
@@ -61,7 +61,7 @@ export function NewChatDialog({ trigger }: { trigger?: ReactElement }) {
           setRepo("")
           setCustomRepo(false)
           setOpen(false)
-          navigate(`/containers/detail?key=${encodeURIComponent(entityKey)}`)
+          navigate(`/runs/detail?key=${encodeURIComponent(entityKey)}`)
         },
       },
     )