Skip to content

High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.

feat(dashboard): agent sessions sidebar with labels and auto-selection

Bosch043c7cb187be
diff --git a/dashboard/src/activities/ActiveFilterBar.tsx b/dashboard/src/activities/ActiveFilterBar.tsx
index b0ae845c..14a02607 100644
--- a/dashboard/src/activities/ActiveFilterBar.tsx
+++ b/dashboard/src/activities/ActiveFilterBar.tsx
@@ -3,12 +3,14 @@ import type { ActivityFilters } from "./types";
interface ActiveFilterBarProps {
filters: ActivityFilters;
hideAgentFilter?: boolean;
+ hideSessionFilter?: boolean;
onClear: () => void;
}
export default function ActiveFilterBar({
filters,
hideAgentFilter = false,
+ hideSessionFilter = false,
onClear,
}: ActiveFilterBarProps) {
const activeFilters = [
@@ -17,7 +19,7 @@ export default function ActiveFilterBar({
filters.instanceId ? `instance:${filters.instanceId}` : "",
filters.tabId ? `tab:${filters.tabId}` : "",
filters.action ? `action:${filters.action}` : "",
- filters.sessionId ? `session:${filters.sessionId}` : "",
+ !hideSessionFilter && filters.sessionId ? `session:${filters.sessionId}` : "",
filters.pathPrefix ? `path:${filters.pathPrefix}` : "",
].filter(Boolean);
diff --git a/dashboard/src/activities/ActivityPage.test.tsx b/dashboard/src/activities/ActivityPage.test.tsx
index fd4899ea..09f49085 100644
--- a/dashboard/src/activities/ActivityPage.test.tsx
+++ b/dashboard/src/activities/ActivityPage.test.tsx
@@ -11,10 +11,11 @@ vi.mock("./api", () => ({
vi.mock("../services/api", () => ({
fetchAllTabs: vi.fn(),
+ fetchAgentSessions: vi.fn(),
}));
import { fetchActivity } from "./api";
-import { fetchAllTabs } from "../services/api";
+import { fetchAgentSessions, fetchAllTabs } from "../services/api";
describe("ActivityPage", () => {
beforeEach(() => {
@@ -64,6 +65,7 @@ describe("ActivityPage", () => {
],
},
});
+ vi.mocked(fetchAgentSessions).mockResolvedValue([]);
vi.mocked(fetchAllTabs).mockResolvedValue([
{
id: "tab_123",
diff --git a/dashboard/src/activities/AgentActivityWorkspace.tsx b/dashboard/src/activities/AgentActivityWorkspace.tsx
index 362e9980..17e76420 100644
--- a/dashboard/src/activities/AgentActivityWorkspace.tsx
+++ b/dashboard/src/activities/AgentActivityWorkspace.tsx
@@ -346,6 +346,89 @@ export default function AgentActivityWorkspace({
? agentThreadEvents
: visibleEvents;
+ const derivedSessions = useMemo<api.AgentSession[]>(() => {
+ const bySession = new Map<string, {
+ agentId: string;
+ label?: string;
+ earliest: string;
+ latest: string;
+ }>();
+
+ for (const s of agentSessions) {
+ bySession.set(s.id, {
+ agentId: s.agentId,
+ label: s.label,
+ earliest: s.createdAt,
+ latest: s.lastSeenAt || s.createdAt,
+ });
+ }
+
+ const sourceEvents = usesAgentThreadView && filters.agentId
+ ? (agentEventsById[filters.agentId] ?? []).map(toDashboardActivityEvent)
+ : visibleEvents;
+
+ for (const event of sourceEvents) {
+ const sid = event.sessionId?.trim();
+ if (!sid) continue;
+
+ const existing = bySession.get(sid);
+ if (!existing) {
+ bySession.set(sid, {
+ agentId: event.agentId || "",
+ earliest: event.timestamp,
+ latest: event.timestamp,
+ });
+ continue;
+ }
+
+ const ts = new Date(event.timestamp).getTime();
+ if (ts < new Date(existing.earliest).getTime()) existing.earliest = event.timestamp;
+ if (ts > new Date(existing.latest).getTime()) existing.latest = event.timestamp;
+ }
+
+ return [...bySession.entries()]
+ .map(([id, info]) => ({
+ id,
+ agentId: info.agentId,
+ label: info.label,
+ createdAt: info.earliest,
+ lastSeenAt: info.latest,
+ expiresAt: "",
+ status: "active",
+ }))
+ .sort(
+ (a, b) =>
+ new Date(b.lastSeenAt).getTime() - new Date(a.lastSeenAt).getTime(),
+ );
+ }, [usesAgentThreadView, filters.agentId, agentEventsById, visibleEvents, agentSessions]);
+
+ const unlabeledPtsKey = useMemo(() => {
+ const apiIds = new Set(agentSessions.map((s) => s.id));
+ return derivedSessions
+ .filter((s) => s.id.startsWith("pts_") && !apiIds.has(s.id))
+ .map((s) => s.id)
+ .sort()
+ .join(",");
+ }, [derivedSessions, agentSessions]);
+
+ useEffect(() => {
+ if (!unlabeledPtsKey) return;
+
+ let cancelled = false;
+ const timer = setTimeout(() => {
+ void api
+ .fetchAgentSessions()
+ .then((sessions) => {
+ if (!cancelled) setAgentSessions(sessions);
+ })
+ .catch(() => {});
+ }, 500);
+ return () => {
+ cancelled = true;
+ clearTimeout(timer);
+ };
+ }, [unlabeledPtsKey]);
+
const derivedAgents = useMemo<Agent[]>(() => {
const byId = new Map<string, Agent>();
@@ -423,14 +506,23 @@ export default function AgentActivityWorkspace({
if (!requireSelectedAgent || visibleAgents.length === 0) {
return;
}
- if (visibleAgents.some((agent) => agent.id === filters.agentId)) {
- return;
+
+ const hasAgent = visibleAgents.some((agent) => agent.id === filters.agentId);
+ const targetAgent = hasAgent
+ ? filters.agentId
+ : visibleAgents[0].id;
+ const agentSessionList = derivedSessions
+ .filter((s) => s.agentId === targetAgent);
+ const latestSession = agentSessionList.length > 0 ? agentSessionList[0].id : "";
+
+ if (!hasAgent || (!filters.sessionId && latestSession)) {
+ setFilters((current) => ({
+ ...current,
+ agentId: targetAgent,
+ sessionId: latestSession,
+ }));
}
- setFilters((current) => ({
- ...current,
- agentId: visibleAgents[0].id,
- }));
- }, [filters.agentId, requireSelectedAgent, visibleAgents]);
+ }, [filters.agentId, filters.sessionId, requireSelectedAgent, visibleAgents, derivedSessions]);
const updateFilter = (key: keyof ActivityFilters, value: string) => {
setFilters((current) => ({ ...current, [key]: value }));
@@ -478,25 +570,12 @@ export default function AgentActivityWorkspace({
return (
<div className="flex h-full min-h-0 flex-col overflow-hidden xl:flex-row">
- <AgentStreamPanel
- filters={filters}
- events={displayedEvents}
- sessions={agentSessions}
- summary={summary}
- error={error}
- loading={usesAgentThreadView ? agentLoading : activityLoading}
- copyTabId={copyTabId}
- hideAgentFilter={requireSelectedAgent}
- simplifyMeta={simplifyEventRows}
- onClearFilters={clearFilters}
- onFilterChange={updateFilter}
- />
-
<AgentWorkspaceSidebar
sidebarTab={sidebarTab}
visibleAgents={visibleAgents}
activeAgentId={filters.agentId}
filters={filters}
+ sessions={derivedSessions}
showAllAgentsOption={showAllAgentsOption}
showAgentFilter={showAgentFilter}
profiles={profiles}
@@ -504,13 +583,40 @@ export default function AgentActivityWorkspace({
visibleTabs={visibleTabs}
loading={sidebarLoading}
onSidebarTabChange={setSidebarTab}
- onSelectAgent={(agentId) => updateFilter("agentId", agentId)}
+ onSelectAgent={(agentId, autoSessionId) => {
+ setFilters((current) => ({
+ ...current,
+ agentId,
+ sessionId: autoSessionId || "",
+ }));
+ }}
+ onSelectSession={(sessionId) => {
+ setFilters((current) => ({
+ ...current,
+ sessionId,
+ }));
+ }}
onClearFilters={clearFilters}
onRefresh={() => setRefreshNonce((current) => current + 1)}
onFilterChange={updateFilter}
onProfileChange={handleProfileChange}
onInstanceChange={handleInstanceChange}
/>
+
+ <AgentStreamPanel
+ filters={filters}
+ events={displayedEvents}
+ sessions={derivedSessions}
+ summary={summary}
+ error={error}
+ loading={usesAgentThreadView ? agentLoading : activityLoading}
+ copyTabId={copyTabId}
+ hideAgentFilter={requireSelectedAgent}
+ hideSessionFilter={requireSelectedAgent}
+ simplifyMeta={simplifyEventRows}
+ onClearFilters={clearFilters}
+ onFilterChange={updateFilter}
+ />
</div>
);
}
diff --git a/dashboard/src/activities/AgentStreamPanel.tsx b/dashboard/src/activities/AgentStreamPanel.tsx
index 769369de..fd186392 100644
--- a/dashboard/src/activities/AgentStreamPanel.tsx
+++ b/dashboard/src/activities/AgentStreamPanel.tsx
@@ -15,6 +15,7 @@ interface AgentStreamPanelProps {
loading: boolean;
copyTabId?: boolean;
hideAgentFilter?: boolean;
+ hideSessionFilter?: boolean;
simplifyMeta?: boolean;
onClearFilters: () => void;
onFilterChange: (key: keyof ActivityFilters, value: string) => void;
@@ -29,6 +30,7 @@ export default function AgentStreamPanel({
loading,
copyTabId = false,
hideAgentFilter = false,
+ hideSessionFilter = false,
simplifyMeta = false,
onClearFilters,
onFilterChange,
@@ -83,6 +85,7 @@ export default function AgentStreamPanel({
<ActiveFilterBar
filters={filters}
hideAgentFilter={hideAgentFilter}
+ hideSessionFilter={hideSessionFilter}
onClear={onClearFilters}
/>
diff --git a/dashboard/src/activities/AgentWorkspaceSidebar.tsx b/dashboard/src/activities/AgentWorkspaceSidebar.tsx
index e604c76e..98287d42 100644
--- a/dashboard/src/activities/AgentWorkspaceSidebar.tsx
+++ b/dashboard/src/activities/AgentWorkspaceSidebar.tsx
@@ -1,5 +1,7 @@
+import { useMemo } from "react";
import { AgentItem } from "../components/molecules";
import type { Agent, Instance, InstanceTab, Profile } from "../types";
+import type { AgentSession } from "../services/api";
import ActivityFilterMenu from "./ActivityFilterMenu";
import type { ActivityFilters } from "./types";
@@ -10,6 +12,7 @@ interface AgentWorkspaceSidebarProps {
visibleAgents: Agent[];
activeAgentId: string;
filters: ActivityFilters;
+ sessions: AgentSession[];
showAllAgentsOption?: boolean;
showAgentFilter?: boolean;
profiles: Profile[];
@@ -17,7 +20,8 @@ interface AgentWorkspaceSidebarProps {
visibleTabs: InstanceTab[];
loading: boolean;
onSidebarTabChange: (tab: WorkspaceTab) => void;
- onSelectAgent: (agentId: string) => void;
+ onSelectAgent: (agentId: string, autoSessionId?: string) => void;
+ onSelectSession: (sessionId: string) => void;
onClearFilters: () => void;
onRefresh: () => void;
onFilterChange: (key: keyof ActivityFilters, value: string) => void;
@@ -30,6 +34,7 @@ export default function AgentWorkspaceSidebar({
visibleAgents,
activeAgentId,
filters,
+ sessions,
showAllAgentsOption = true,
showAgentFilter = true,
profiles,
@@ -38,14 +43,34 @@ export default function AgentWorkspaceSidebar({
loading,
onSidebarTabChange,
onSelectAgent,
+ onSelectSession,
onClearFilters,
onRefresh,
onFilterChange,
onProfileChange,
onInstanceChange,
}: AgentWorkspaceSidebarProps) {
+ const sessionsByAgent = useMemo(() => {
+ const map = new Map<string, AgentSession[]>();
+ for (const session of sessions) {
+ const agentId = session.agentId || "";
+ if (!agentId) continue;
+ const list = map.get(agentId) || [];
+ list.push(session);
+ map.set(agentId, list);
+ }
+ for (const list of map.values()) {
+ list.sort(
+ (a, b) =>
+ new Date(b.lastSeenAt || b.createdAt).getTime() -
+ new Date(a.lastSeenAt || a.createdAt).getTime(),
+ );
+ }
+ return map;
+ }, [sessions]);
+
return (
- <aside className="order-2 flex w-full shrink-0 flex-col overflow-hidden border-t border-border-subtle bg-bg-surface xl:order-0 xl:w-80 xl:border-t-0 xl:border-l">
+ <aside className="flex w-full shrink-0 flex-col overflow-hidden border-b border-border-subtle bg-bg-surface xl:w-80 xl:border-b-0 xl:border-r">
<div className="flex border-b border-border-subtle">
{[
{ id: "agents" as const, label: "Agents" },
@@ -67,21 +92,21 @@ export default function AgentWorkspaceSidebar({
</div>
{sidebarTab === "agents" ? (
- <div className="min-h-0 flex-1 overflow-auto p-2">
+ <div className="min-h-0 flex-1 overflow-auto">
{visibleAgents.length === 0 ? (
<div className="py-8 text-center text-sm text-text-muted">
<div className="mb-2 text-2xl">🦀</div>
No agent activity observed yet
</div>
) : (
- <div className="flex flex-col gap-1">
+ <div className="flex flex-col">
{showAllAgentsOption && (
<button
type="button"
- className={`rounded-sm px-3 py-2 text-left text-sm transition-all ${
+ className={`px-3 py-2.5 text-left text-sm transition-colors ${
activeAgentId === ""
- ? "border border-primary/30 bg-primary/10 text-primary"
- : "border border-transparent text-text-muted hover:bg-bg-elevated"
+ ? "bg-primary/8 text-primary"
+ : "text-text-muted hover:bg-bg-elevated"
}`}
onClick={() => onSelectAgent("")}
>
@@ -93,7 +118,10 @@ export default function AgentWorkspaceSidebar({
key={agent.id}
agent={agent}
selected={activeAgentId === agent.id}
- onClick={() => onSelectAgent(agent.id)}
+ sessions={sessionsByAgent.get(agent.id) || []}
+ activeSessionId={filters.sessionId}
+ onClick={(autoSessionId) => onSelectAgent(agent.id, autoSessionId)}
+ onSelectSession={onSelectSession}
/>
))}
</div>
diff --git a/dashboard/src/activities/AgentsPage.test.tsx b/dashboard/src/activities/AgentsPage.test.tsx
index ed218f1a..50c11def 100644
--- a/dashboard/src/activities/AgentsPage.test.tsx
+++ b/dashboard/src/activities/AgentsPage.test.tsx
@@ -12,10 +12,11 @@ vi.mock("./api", () => ({
vi.mock("../services/api", () => ({
fetchAllTabs: vi.fn(),
fetchAgent: vi.fn(),
+ fetchAgentSessions: vi.fn(),
}));
import { fetchActivity } from "./api";
-import { fetchAgent, fetchAllTabs } from "../services/api";
+import { fetchAgent, fetchAgentSessions, fetchAllTabs } from "../services/api";
describe("AgentsPage", () => {
beforeEach(() => {
@@ -36,6 +37,7 @@ describe("AgentsPage", () => {
currentTabs: {},
});
vi.mocked(fetchAllTabs).mockResolvedValue([]);
+ vi.mocked(fetchAgentSessions).mockResolvedValue([]);
vi.mocked(fetchAgent).mockResolvedValue({
agent: {
id: "cli",
@@ -224,7 +226,7 @@ describe("AgentsPage", () => {
channel: "progress",
type: "progress",
method: "POST",
- path: "/api/agents/worker-2/events",
+ path: "/navigate",
message: "Planning next step",
timestamp: "2026-03-16T09:00:04Z",
} as any);
@@ -234,7 +236,7 @@ describe("AgentsPage", () => {
channel: "progress",
type: "progress",
method: "POST",
- path: "/api/agents/cli/events",
+ path: "/action",
message: "Planning next step",
timestamp: "2026-03-16T09:00:05Z",
details: {
diff --git a/dashboard/src/components/molecules/AgentItem.tsx b/dashboard/src/components/molecules/AgentItem.tsx
index d2668045..0b886a1a 100644
--- a/dashboard/src/components/molecules/AgentItem.tsx
+++ b/dashboard/src/components/molecules/AgentItem.tsx
@@ -1,10 +1,13 @@
-import { Badge } from "../atoms";
import type { Agent } from "../../types";
+import type { AgentSession } from "../../services/api";
interface Props {
agent: Agent;
selected: boolean;
- onClick: () => void;
+ sessions: AgentSession[];
+ activeSessionId?: string;
+ onClick: (autoSessionId?: string) => void;
+ onSelectSession: (sessionId: string) => void;
}
function timeAgo(date: string): string {
@@ -13,31 +16,83 @@ function timeAgo(date: string): string {
if (secs < 5) return "just now";
if (secs < 60) return `${secs}s ago`;
if (secs < 3600) return `${Math.floor(secs / 60)}m ago`;
- return `${Math.floor(secs / 3600)}h ago`;
+ if (secs < 86400) return `${Math.floor(secs / 3600)}h ago`;
+ return `${Math.floor(secs / 86400)}d`;
}
-export default function AgentItem({ agent, selected, onClick }: Props) {
+function formatSessionTime(ts: string): string {
+ return new Date(ts).toLocaleTimeString("en-GB", {
+ hour: "2-digit",
+ minute: "2-digit",
+ });
+}
+
+function sessionDisplayName(session: AgentSession): string {
+ if (session.label) return session.label;
+ const start = formatSessionTime(session.createdAt);
+ const end = formatSessionTime(session.lastSeenAt || session.createdAt);
+ return start === end ? `Session ${start}` : `Session ${start}–${end}`;
+}
+
+export default function AgentItem({
+ agent,
+ selected,
+ sessions,
+ activeSessionId,
+ onClick,
+ onSelectSession,
+}: Props) {
+ const handleAgentClick = () => {
+ const latestSession = sessions.length > 0 ? sessions[0].id : undefined;
+ onClick(latestSession);
+ };
+
return (
- <button
- className={`flex w-full items-center gap-3 px-3 py-3 text-left ${
- selected
- ? "dashboard-panel dashboard-panel-selected border-primary"
- : "dashboard-panel dashboard-panel-hover"
- }`}
- onClick={onClick}
- >
- <div className="flex h-10 w-10 items-center justify-center rounded-full border border-border-subtle bg-primary/10 text-lg shadow-[0_0_20px_rgb(var(--brand-accent-rgb)/0.08)]">
- 🤖
- </div>
- <div className="min-w-0 flex-1">
- <div className="truncate font-medium text-text-primary">
- {agent.name || agent.id}
+ <div>
+ <button
+ className={`flex w-full items-center gap-3 px-3 py-2.5 text-left transition-colors ${
+ selected
+ ? "bg-primary/8 text-text-primary"
+ : "text-text-secondary hover:bg-bg-elevated hover:text-text-primary"
+ }`}
+ onClick={handleAgentClick}
+ >
+ <div className="flex h-7 w-7 shrink-0 items-center justify-center rounded-md text-base">
+ 🤖
+ </div>
+ <div className="min-w-0 flex-1">
+ <span className="truncate text-sm font-medium">
+ {agent.name || agent.id}
+ </span>
</div>
- <div className="dashboard-mono text-xs text-text-muted">
+ <span className="dashboard-mono text-[0.65rem] text-text-muted">
{timeAgo(agent.lastActivity || agent.connectedAt)}
+ </span>
+ </button>
+
+ {selected && sessions.length > 0 && (
+ <div className="ml-5 border-l border-border-subtle">
+ {sessions.map((session) => {
+ const isActive = activeSessionId === session.id;
+ return (
+ <button
+ key={session.id}
+ className={`flex w-full items-center gap-2 py-1.5 pl-4 pr-3 text-left transition-colors ${
+ isActive
+ ? "bg-primary/6 text-primary"
+ : "text-text-muted hover:bg-bg-elevated hover:text-text-secondary"
+ }`}
+ onClick={() => onSelectSession(session.id)}
+ >
+ <span className="text-xs">🔑</span>
+ <span className="min-w-0 flex-1 truncate text-xs font-medium">
+ {sessionDisplayName(session)}
+ </span>
+ </button>
+ );
+ })}
</div>
- </div>
- <Badge>{agent.requestCount}</Badge>
- </button>
+ )}
+ </div>
);
}
diff --git a/internal/agentsession/store.go b/internal/agentsession/store.go
index 902a4cc9..22a59d05 100644
--- a/internal/agentsession/store.go
+++ b/internal/agentsession/store.go
@@ -50,7 +50,7 @@ type Store struct {
}
const (
- DefaultIdleTimeout = 30 * time.Minute
+ DefaultIdleTimeout = 12 * time.Hour
DefaultMaxLifetime = 24 * time.Hour
StatusActive = "active"
diff --git a/internal/handlers/middleware.go b/internal/handlers/middleware.go
index bcd43d79..e3b333f5 100644
--- a/internal/handlers/middleware.go
+++ b/internal/handlers/middleware.go
@@ -120,6 +120,10 @@ func AuthMiddlewareWithSessions(cfg *config.RuntimeConfig, sessions *authn.Sessi
// Inject agent identity into request headers for activity tracking
r.Header.Set(activity.HeaderAgentID, sess.AgentID)
r.Header.Set(activity.HeaderPTSessionID, sess.ID)
+ activity.EnrichRequest(r, activity.Update{
+ AgentID: sess.AgentID,
+ SessionID: sess.ID,
+ })
case authn.MethodHeader:
if subtle.ConstantTimeCompare([]byte(creds.Value), []byte(token)) != 1 {
authn.ClearSessionCookie(w, r, cfg != nil && cfg.TrustProxyHeaders, cookieSecureSetting(cfg))
@@ -397,7 +401,7 @@ var (
const (
rateLimitWindow = 10 * time.Second
- rateLimitMaxReq = 120
+ rateLimitMaxReq = 300
evictionInterval = 30 * time.Second
)