Skip to content

feat(frontend): Agent surfaces in @agenta/entity-ui/agent, antd-free - #5771

Closed
ardaerzin wants to merge 1 commit into
pkg/sessions-uifrom
pkg/entity-ui-agent
Closed

feat(frontend): Agent surfaces in @agenta/entity-ui/agent, antd-free#5771
ardaerzin wants to merge 1 commit into
pkg/sessions-uifrom
pkg/entity-ui-agent

Conversation

@ardaerzin

Copy link
Copy Markdown
Contributor

Context

Fourth lane of the sessions/agents UX stack. The agent card and next-triggers surfaces were built in the oss app for Home, the agents page and the overview. Only the components that survive a headless contract port here; UsageSummary and NewAgentButton stay app-side deliberately (a port would leave an empty shell over app state).

Changes

New @agenta/entity-ui/agent subpath (the package already exports per-module subpaths, so mobile can import it without touching the antd modules):

  • AgentCard takes a neutral AgentCardData plus callbacks. The data-connected cells arrive as activity / owner slots. The avatar colour hashes the workflow id, not the name: two agents named "New agent" kept getting the same avatar.
  • NextTriggersSection reads trigger data via @agenta/entities/gatewayTrigger and takes display names as an agentNames map, because the classified agents list is app state.

The antd ban is eslint-scoped to src/agent/**; the rest of the package still uses antd. DrillInView exports the accordion primitives the overview lane composes.

Tests / notes

  • 301 package unit tests pass; grep 'from "antd"' src/agent is empty.
  • Depends on entities/trigger-helpers (targets main): NextTriggersSection imports triggerBoundAgentId, so the package build goes green once that PR reaches this stack's base. Everything else on this lane is clean.

@dosubot dosubot Bot added size:L This PR changes 100-499 lines, ignoring generated files. frontend labels Aug 6, 2026
@coderabbitai

coderabbitai Bot commented Aug 6, 2026

Copy link
Copy Markdown

Review Change Stack

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: af00b0b5-bdf0-4004-9c18-401516047bcb

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 reusable agent cards with avatars, descriptions, activity details, multiple layouts, and action menus.
    • Added a “Next Triggers” section displaying scheduled and event-based triggers, including next-run times, statuses, loading, error, and empty states.
    • Added optional tooltip support for interface elements.
    • Added public access to agent UI components and instruction file rows.

Walkthrough

The package adds reusable agent cards, upcoming trigger displays, tooltip handling, agent-specific lint rules, and public exports for agent UI components and InstructionsFileRow.

Changes

Agent UI package

Layer / File(s) Summary
Agent card rendering
web/packages/agenta-entity-ui/src/agent/AgentCard.tsx
Adds grid and rail card layouts with deterministic avatars, metadata, descriptions, timestamps, action menus, and keyboard-accessible interactions.
Upcoming trigger aggregation and display
web/packages/agenta-entity-ui/src/agent/NextTriggersSection.tsx, web/packages/agenta-entity-ui/src/agent/Tip.tsx
Loads active schedules and subscriptions, filters and sorts triggers, limits results to five, and renders loading, error, empty, and populated states with tooltip details.
Package exports and lint boundaries
web/packages/agenta-entity-ui/eslint.config.mjs, web/packages/agenta-entity-ui/package.json, web/packages/agenta-entity-ui/src/agent/index.ts, web/packages/agenta-entity-ui/src/DrillInView/index.ts, web/packages/agenta-entity-ui/src/index.ts
Adds agent-specific import restrictions, publishes the ./agent entry point, re-exports agent components, and exposes InstructionsFileRow.

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

Sequence Diagram(s)

sequenceDiagram
  participant NextTriggersSection
  participant ScheduleQuery
  participant SubscriptionQuery
  participant TriggerList
  NextTriggersSection->>ScheduleQuery: load active schedules
  NextTriggersSection->>SubscriptionQuery: load active subscriptions
  ScheduleQuery-->>NextTriggersSection: return schedules
  SubscriptionQuery-->>NextTriggersSection: return subscriptions
  NextTriggersSection->>TriggerList: render filtered and sorted triggers
Loading

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies the new antd-free Agent surfaces in the @agenta/entity-ui/agent subpath.
Description check ✅ Passed The description explains the new agent UI subpath, its components, antd scope, tests, and dependency.
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 pkg/entity-ui-agent

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.

@vercel

vercel Bot commented Aug 6, 2026

Copy link
Copy Markdown

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

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

Request Review

@ardaerzin

Copy link
Copy Markdown
Contributor Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Aug 6, 2026

Copy link
Copy Markdown
✅ 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 coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 6

🧹 Nitpick comments (1)
web/packages/agenta-entity-ui/src/agent/AgentCard.tsx (1)

16-17: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Reduce new narrative comments to short constraint comments.

  • web/packages/agenta-entity-ui/src/agent/AgentCard.tsx#L16-L17: Replace explanatory UI rationale with a short constraint comment. Apply the same change to related new narrative blocks in this component.
  • web/packages/agenta-entity-ui/src/agent/NextTriggersSection.tsx#L29-L36: Replace product rationale with a short constraint comment. Keep only details needed to prevent an implementation error.
  • web/packages/agenta-entity-ui/src/agent/Tip.tsx#L5-L5: Shorten the wrapper description to one line.

As per coding guidelines, “Keep in-code comments to at most one short line; use longer comments only for genuinely surprising constraints such as bugs, races, or ordering requirements.”

Source: Coding guidelines


ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 11ec04d1-c8f4-4198-9ac3-98037028452e

📥 Commits

Reviewing files that changed from the base of the PR and between 76522bf and 468dfc5.

📒 Files selected for processing (8)
  • web/packages/agenta-entity-ui/eslint.config.mjs
  • web/packages/agenta-entity-ui/package.json
  • web/packages/agenta-entity-ui/src/DrillInView/index.ts
  • web/packages/agenta-entity-ui/src/agent/AgentCard.tsx
  • web/packages/agenta-entity-ui/src/agent/NextTriggersSection.tsx
  • web/packages/agenta-entity-ui/src/agent/Tip.tsx
  • web/packages/agenta-entity-ui/src/agent/index.ts
  • web/packages/agenta-entity-ui/src/index.ts

Comment thread web/packages/agenta-entity-ui/src/agent/AgentCard.tsx
Comment thread web/packages/agenta-entity-ui/src/agent/AgentCard.tsx Outdated
Comment thread web/packages/agenta-entity-ui/src/agent/AgentCard.tsx
Comment thread web/packages/agenta-entity-ui/src/agent/NextTriggersSection.tsx Outdated
Comment thread web/packages/agenta-entity-ui/src/agent/NextTriggersSection.tsx Outdated
Comment thread web/packages/agenta-entity-ui/src/agent/Tip.tsx
@ardaerzin
ardaerzin force-pushed the pkg/entity-ui-agent branch from 468dfc5 to 0d2d3cd Compare August 6, 2026 09:52
@dosubot dosubot Bot added size:XL This PR changes 500-999 lines, ignoring generated files. and removed size:L This PR changes 100-499 lines, ignoring generated files. labels Aug 6, 2026
@ardaerzin

Copy link
Copy Markdown
Contributor Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Aug 6, 2026

Copy link
Copy Markdown
✅ 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

coderabbitai Bot commented Aug 6, 2026

Copy link
Copy Markdown

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.

AgentCard takes a neutral AgentCardData plus callbacks, with the data-connected cells arriving as activity/owner slots; the avatar colour hashes the workflow id, not the name. NextTriggersSection reads trigger data via @agenta/entities/gatewayTrigger and takes display names as an agentNames map. The antd ban is eslint-scoped to src/agent/**. UsageSummary and NewAgentButton stay app-side deliberately: a port would leave an empty shell.
@dosubot dosubot Bot added the lgtm This PR has been approved by a maintainer label Aug 9, 2026
@mmabrouk

mmabrouk commented Aug 9, 2026

Copy link
Copy Markdown
Member

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.

@mmabrouk mmabrouk closed this Aug 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

frontend lgtm This PR has been approved by a maintainer size:XL This PR changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants