feat(frontend): Project- and agent-scoped sessions pages with a filters rail by ardaerzin · Pull Request #5775 · Agenta-AI/agenta

ardaerzin · 2026-08-06T07:58:39Z

Context

Fourth app lane. Sessions had no page of their own: they lived in the playground's session bar. This adds a project-wide /sessions page and a per-agent sessions page, both render-only over the packages below.

Changes

SessionsPage renders @agenta/sessions' groups with @agenta/sessions-ui's rows: pinned and recent groups, sticky group headers, per-group paging, and automations as a mode (they replace the set) rather than a second list.
The filters render as a 280px rail: status, automations mode, archived, search, with the agent picker injected as a slot (it is still antd).
Pinned and recent sessions surface in the sidebar; session actions (pin, archive, rename, open on the agent's playground) work from the list and from the playground's session bar.
Routes land in OSS and EE, project-wide and per-agent.

Tests / notes

@agenta/oss tsc adds nothing on this lane. The page derives nothing: groups, labels and row view-models come from @agenta/sessions.

What to QA

Open the project /sessions page: pinned group leads when present, recent below, automations hidden until the mode is switched.
Switch to automations mode: the list is replaced (not appended), and the group label changes to Automation runs.
Open an agent's sessions page from its sidebar: the same page scoped to that agent.
Regression: pinning from the row menu moves the row in place; right-click still shows the app-side context menu.

vercel · 2026-08-06T07:58:45Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agenta-documentation	Ready	Preview	Aug 6, 2026 8:59pm

coderabbitai · 2026-08-06T07:58:47Z

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: ead033d5-0bde-4b3c-8c7a-a8424e635472

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

📝 Walkthrough

Summary by CodeRabbit

New Features
- Added dedicated Sessions pages for projects and agent applications.
- Added session browsing with search, status, agent, mode, and archive filters, pagination, and loading or empty states.
- Added project and app navigation entries for Sessions.
- Added recent and pinned sessions to the sidebar, with active-session indicators.
- Added context menus for opening, renaming, pinning, archiving, and deleting sessions.
Bug Fixes
- Redirected evaluator workflows away from unsupported Sessions routes.

Walkthrough

The PR adds project and agent sessions pages, session filters and actions, dynamic sidebar session entries, workflow routing guards, and per-session context menus in SessionTagBar.

Changes

Sessions UI and navigation

Layer / File(s)	Summary
Sessions page and routes `web/oss/src/components/pages/sessions/...`, `web/oss/src/pages/.../sessions/index.tsx`, `web/ee/src/pages/.../sessions/index.tsx`	Adds the shared sessions page, filters, menu conversion, session actions, and project and agent route exports.
Dynamic sidebar sessions `web/oss/src/components/Sidebar/dynamic/*`	Loads project sessions, orders pinned entries, and supports row-specific icons, groups, and click handlers.
Sessions navigation and workflow guards `web/oss/src/components/Sidebar/hooks/useSidebarConfig/index.tsx`, `web/oss/src/components/Sidebar/scopes/constants.ts`, `web/oss/src/state/workflow/destinations.ts`	Adds project and agent Sessions navigation entries and redirects evaluator workflows away from the sessions route.
Session-chip context actions `web/oss/src/components/AgentChatSlice/components/SessionTagBar.tsx`	Wraps session chips in right-click dropdowns and supplies session-specific action targets.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  actor User
  participant Sidebar
  participant SessionsPage
  participant SessionList
  participant SessionActions
  User->>Sidebar: Select Sessions
  Sidebar->>SessionsPage: Navigate to sessions route
  SessionsPage->>SessionList: Load filtered sessions
  SessionList-->>SessionsPage: Return grouped sessions
  User->>SessionsPage: Select session menu action
  SessionsPage->>SessionActions: Dispatch session target

Possibly related PRs

Agenta-AI/agenta#4983: Introduced the SessionTagBar that this PR extends with context-menu actions.
Agenta-AI/agenta#4987: Introduced sidebar dynamic registry behavior that this PR extends for session entities.
Agenta-AI/agenta#5479: Adds related session APIs and state used by the sessions UI.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main changes: project- and agent-scoped sessions pages with a filters rail.
Description check	✅ Passed	The description directly explains the new sessions pages, filters rail, sidebar integration, actions, routes, and QA expectations.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches 💡 1

🛠️ Fix failing CI checks 💡

Create stacked PR
Commit on current branch

📝 Generate docstrings

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch oss/sessions-page

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

ardaerzin · 2026-08-06T08:43:27Z

@coderabbitai review

coderabbitai · 2026-08-06T08:43:33Z

⚠️ Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

ardaerzin · 2026-08-06T09:10:06Z

@coderabbitai review

coderabbitai · 2026-08-06T09:10:15Z

⚠️ Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

ardaerzin · 2026-08-06T10:21:40Z

@coderabbitai review

coderabbitai · 2026-08-06T10:25:20Z

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

coderabbitai

Actionable comments posted: 2

🧹 Nitpick comments (3)

web/oss/src/components/AgentChatSlice/components/SessionTagBar.tsx (3)

223-225: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Use a supported theme color token.

Line 224 uses var(--ag-surface-accent). Replace it with an Ant Design semantic token or a Tailwind color utility. As per coding guidelines, “Consume theme colors through Ant Design semantic tokens, Tailwind color utilities, or supported var(--ag-color*) variables.”

Source: Coding guidelines

307-308: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Reduce this comment to one short line.

This ownership mapping does not require a multi-line comment. As per coding guidelines, “Keep in-code comments to at most one short line.”

Source: Coding guidelines

311-322: 🚀 Performance & Scalability | 🔵 Trivial | ⚡ Quick win

Preserve stable menu props for memoized session tags.

menuFor(session) creates a new MenuProps object on every SessionTagBar render. This rerenders every memoized SessionTag, including when scroll fade state changes.

web/oss/src/components/AgentChatSlice/components/SessionTagBar.tsx#L311-L322: memoize menu objects by session ID and relevant session fields.

web/oss/src/components/AgentChatSlice/components/SessionTagBar.tsx#L409-L409: pass the memoized menu object to SessionTag.

As per coding guidelines, avoid unstable inline objects when passing props to list items.

Source: Coding guidelines

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 04b91382-6201-4005-bba9-2fe7a2fa8b5f

📥 Commits

Reviewing files that changed from the base of the PR and between f753428 and 5e5c376.

📒 Files selected for processing (15)

web/ee/src/pages/w/[workspace_id]/p/[project_id]/apps/[app_id]/sessions/index.tsx
web/ee/src/pages/w/[workspace_id]/p/[project_id]/sessions/index.tsx
web/oss/src/components/AgentChatSlice/components/SessionTagBar.tsx
web/oss/src/components/Sidebar/dynamic/registry.ts
web/oss/src/components/Sidebar/dynamic/sessionsSource.ts
web/oss/src/components/Sidebar/dynamic/types.ts
web/oss/src/components/Sidebar/dynamic/useSidebarDynamicChildren.ts
web/oss/src/components/Sidebar/hooks/useSidebarConfig/index.tsx
web/oss/src/components/Sidebar/scopes/constants.ts
web/oss/src/components/pages/sessions/SessionsPage.tsx
web/oss/src/components/pages/sessions/assets/menuEntries.ts
web/oss/src/components/pages/sessions/components/SessionFiltersRail.tsx
web/oss/src/pages/w/[workspace_id]/p/[project_id]/apps/[app_id]/sessions/index.tsx
web/oss/src/pages/w/[workspace_id]/p/[project_id]/sessions/index.tsx
web/oss/src/state/workflow/destinations.ts

ardaerzin · 2026-08-06T10:37:56Z

@coderabbitai review

coderabbitai · 2026-08-06T10:38:02Z

⚠️ Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

ardaerzin · 2026-08-06T11:11:46Z

@coderabbitai review

coderabbitai · 2026-08-06T11:11:55Z

⚠️ Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

ardaerzin · 2026-08-06T13:30:10Z

@coderabbitai review

coderabbitai · 2026-08-06T13:30:18Z

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

coderabbitai · 2026-08-06T13:30:23Z

Note

GitHub couldn't provide a complete incremental comparison for this pull request, so CodeRabbit is performing a full review instead. This review may take a little longer.

coderabbitai

Actionable comments posted: 2

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: d2e8ebc5-66a7-4b1a-aa69-de5e2fb784ae

📥 Commits

Reviewing files that changed from the base of the PR and between d1e4ec9 and d2bfe99.

📒 Files selected for processing (15)

web/ee/src/pages/w/[workspace_id]/p/[project_id]/apps/[app_id]/sessions/index.tsx
web/ee/src/pages/w/[workspace_id]/p/[project_id]/sessions/index.tsx
web/oss/src/components/AgentChatSlice/components/SessionTagBar.tsx
web/oss/src/components/Sidebar/dynamic/registry.ts
web/oss/src/components/Sidebar/dynamic/sessionsSource.ts
web/oss/src/components/Sidebar/dynamic/types.ts
web/oss/src/components/Sidebar/dynamic/useSidebarDynamicChildren.ts
web/oss/src/components/Sidebar/hooks/useSidebarConfig/index.tsx
web/oss/src/components/Sidebar/scopes/constants.ts
web/oss/src/components/pages/sessions/SessionsPage.tsx
web/oss/src/components/pages/sessions/assets/menuEntries.ts
web/oss/src/components/pages/sessions/components/SessionFiltersRail.tsx
web/oss/src/pages/w/[workspace_id]/p/[project_id]/apps/[app_id]/sessions/index.tsx
web/oss/src/pages/w/[workspace_id]/p/[project_id]/sessions/index.tsx
web/oss/src/state/workflow/destinations.ts

🚧 Files skipped from review as they are similar to previous changes (13)

web/oss/src/components/Sidebar/dynamic/useSidebarDynamicChildren.ts
web/oss/src/components/Sidebar/dynamic/types.ts
web/oss/src/components/Sidebar/hooks/useSidebarConfig/index.tsx
web/oss/src/pages/w/[workspace_id]/p/[project_id]/apps/[app_id]/sessions/index.tsx
web/oss/src/state/workflow/destinations.ts
web/oss/src/components/Sidebar/dynamic/registry.ts
web/oss/src/components/pages/sessions/components/SessionFiltersRail.tsx
web/oss/src/components/Sidebar/scopes/constants.ts
web/oss/src/pages/w/[workspace_id]/p/[project_id]/sessions/index.tsx
web/ee/src/pages/w/[workspace_id]/p/[project_id]/sessions/index.tsx
web/oss/src/components/pages/sessions/assets/menuEntries.ts
web/oss/src/components/AgentChatSlice/components/SessionTagBar.tsx
web/ee/src/pages/w/[workspace_id]/p/[project_id]/apps/[app_id]/sessions/index.tsx

…rs rail A render-only SessionsPage over @agenta/sessions' groups and @agenta/sessions-ui's rows, with the filters as a 280px rail (status, mode, archived, search; the agent picker injected as a slot). Pinned and recent sessions surface in the sidebar, session actions work from the list and the session bar, and the routes land in OSS and EE.

mmabrouk · 2026-08-09T16:56:32Z

Landed in release/v0.112.0 as part of the 0.112.0 release. The release branch now contains this work at commit ae71a92. Closing here since there is nothing left to merge.

dosubot Bot added the size:XL This PR changes 500-999 lines, ignoring generated files. label Aug 6, 2026

dosubot Bot added feature request New feature or request frontend labels Aug 6, 2026

ardaerzin force-pushed the oss/templates branch from 5efd846 to ac36eb7 Compare August 6, 2026 09:52

ardaerzin force-pushed the oss/sessions-page branch from 05d0be4 to 0c24ace Compare August 6, 2026 09:52

vercel Bot deployed to Preview August 6, 2026 09:54 View deployment

ardaerzin force-pushed the oss/templates branch from ac36eb7 to f753428 Compare August 6, 2026 10:01

ardaerzin force-pushed the oss/sessions-page branch from 0c24ace to 5e5c376 Compare August 6, 2026 10:01

vercel Bot deployed to Preview August 6, 2026 10:02 View deployment

coderabbitai Bot reviewed Aug 6, 2026

View reviewed changes

Comment thread web/oss/src/components/Sidebar/dynamic/registry.ts

Comment thread web/oss/src/components/Sidebar/dynamic/sessionsSource.ts

ardaerzin force-pushed the oss/sessions-page branch from 5e5c376 to e4b0164 Compare August 6, 2026 10:37

vercel Bot deployed to Preview August 6, 2026 10:38 View deployment

ardaerzin force-pushed the oss/templates branch from f753428 to ab3c042 Compare August 6, 2026 10:45

ardaerzin force-pushed the oss/sessions-page branch from e4b0164 to 0c324d5 Compare August 6, 2026 10:45

vercel Bot deployed to Preview August 6, 2026 10:47 View deployment

ardaerzin force-pushed the oss/templates branch from ab3c042 to d1e4ec9 Compare August 6, 2026 13:23

ardaerzin force-pushed the oss/sessions-page branch from 0c324d5 to d2bfe99 Compare August 6, 2026 13:23

vercel Bot deployed to Preview August 6, 2026 13:25 View deployment

coderabbitai Bot reviewed Aug 6, 2026

View reviewed changes

Comment thread web/oss/src/components/pages/sessions/SessionsPage.tsx

Comment thread web/oss/src/components/Sidebar/dynamic/sessionsSource.ts

ardaerzin force-pushed the oss/templates branch from d1e4ec9 to e6967e5 Compare August 6, 2026 13:40

ardaerzin force-pushed the oss/sessions-page branch from d2bfe99 to bdb94db Compare August 6, 2026 13:40

vercel Bot deployed to Preview August 6, 2026 13:41 View deployment

ardaerzin force-pushed the oss/templates branch from e6967e5 to f915825 Compare August 6, 2026 20:58

ardaerzin force-pushed the oss/sessions-page branch from bdb94db to 90bb383 Compare August 6, 2026 20:58

vercel Bot deployed to Preview August 6, 2026 20:59 View deployment

mmabrouk approved these changes Aug 9, 2026

View reviewed changes

dosubot Bot added the lgtm This PR has been approved by a maintainer label Aug 9, 2026

mmabrouk closed this Aug 9, 2026

Uh oh!

Conversation

ardaerzin commented Aug 6, 2026

Context

Changes

Tests / notes

What to QA

Uh oh!

vercel Bot commented Aug 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented Aug 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Summary by CodeRabbit

Walkthrough

Changes

Sequence Diagram(s)

Uh oh!

ardaerzin commented Aug 6, 2026

Uh oh!

coderabbitai Bot commented Aug 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ardaerzin commented Aug 6, 2026

Uh oh!

coderabbitai Bot commented Aug 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ardaerzin commented Aug 6, 2026

Uh oh!

coderabbitai Bot commented Aug 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

ardaerzin commented Aug 6, 2026

Uh oh!

coderabbitai Bot commented Aug 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ardaerzin commented Aug 6, 2026

Uh oh!

coderabbitai Bot commented Aug 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ardaerzin commented Aug 6, 2026

Uh oh!

coderabbitai Bot commented Aug 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented Aug 6, 2026

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

mmabrouk commented Aug 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

vercel Bot commented Aug 6, 2026 •

edited

Loading

coderabbitai Bot commented Aug 6, 2026 •

edited

Loading

coderabbitai Bot commented Aug 6, 2026 •

edited

Loading

coderabbitai Bot commented Aug 6, 2026 •

edited

Loading

coderabbitai Bot commented Aug 6, 2026 •

edited

Loading

coderabbitai Bot commented Aug 6, 2026 •

edited

Loading

coderabbitai Bot commented Aug 6, 2026 •

edited

Loading

coderabbitai Bot commented Aug 6, 2026 •

edited

Loading