Skip to content

Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure

TypeScript

feat(control-ui): add connector detail navigation

Josué79b6d9aaa3ed
diff --git a/control-ui/app/constants/routes.ts b/control-ui/app/constants/routes.ts
index c7ff329aa..260fe451e 100644
--- a/control-ui/app/constants/routes.ts
+++ b/control-ui/app/constants/routes.ts
@@ -35,6 +35,7 @@ export const CONTROL_ROUTES = {
connectors: {
root: '/connectors',
new: '/connectors/new',
+ detail: (name: string) => `/connectors/${segment(name)}`,
edit: (name: string) => `/connectors/${segment(name)}/edit`,
editTab: (name: string, tab: string) => `/connectors/${segment(name)}/edit/${segment(tab)}`,
},
diff --git a/control-ui/app/mcp-servers/[name]/page.tsx b/control-ui/app/mcp-servers/[name]/page.tsx
new file mode 100644
index 000000000..4434c7d41
--- /dev/null
+++ b/control-ui/app/mcp-servers/[name]/page.tsx
@@ -0,0 +1,147 @@
+'use client'
+
+import { useCallback, useEffect, useState } from 'react'
+import { useParams, useRouter } from 'next/navigation'
+import { AuthGate } from '@components/AuthGate'
+import { DetailPageShell } from '@components/DetailPageShell'
+import { IconCable } from '@components/Sidebar/icons'
+import { IconRefresh } from '@components/icons'
+import { CONTROL_ROUTES } from '@constants/routes'
+import { type McpServerResource, getMcpServer, isSilentApiError } from '@lib/api'
+
+function text(value: unknown, fallback = '—'): string {
+ return typeof value === 'string' && value.trim() ? value : fallback
+}
+
+export default function McpServerDetailPage() {
+ const router = useRouter()
+ const params = useParams<{ name: string }>()
+ const name = decodeURIComponent(params?.name ?? '')
+ const [server, setServer] = useState<McpServerResource | null>(null)
+ const [loading, setLoading] = useState(true)
+ const [error, setError] = useState('')
+
+ const load = useCallback(async () => {
+ setLoading(true)
+ setError('')
+ try {
+ setServer(await getMcpServer(name))
+ } catch (caught) {
+ if (isSilentApiError(caught)) return
+ setServer(null)
+ setError(caught instanceof Error ? caught.message : `Connector ${name} was not found.`)
+ } finally {
+ setLoading(false)
+ }
+ }, [name])
+
+ useEffect(() => {
+ if (name) void load()
+ }, [load, name])
+
+ const spec = server?.spec ?? {}
+ const conditions = server?.status?.conditions ?? []
+ const transport =
+ spec.transport && typeof spec.transport === 'object'
+ ? (spec.transport as Record<string, unknown>)
+ : {}
+
+ return (
+ <AuthGate>
+ <DetailPageShell
+ icon={<IconCable />}
+ title={loading ? 'Connector details' : name}
+ subtitle="Review connector configuration and runtime status before making changes."
+ backLabel="Back to connectors"
+ onBack={() => router.push(CONTROL_ROUTES.connectors.root)}
+ actions={
+ <>
+ <button
+ type="button"
+ className="cu-btn cu-btn--icon cu-btn--toolbar"
+ aria-label={loading ? 'Refreshing connector' : 'Refresh connector'}
+ disabled={loading}
+ onClick={() => void load()}
+ >
+ <IconRefresh className={loading ? 'cu-spin' : undefined} width={18} height={18} />
+ </button>
+ <button
+ type="button"
+ className="cu-btn cu-btn--primary cu-btn--sm"
+ disabled={loading || !server}
+ onClick={() => router.push(CONTROL_ROUTES.connectors.edit(name))}
+ >
+ Edit connector
+ </button>
+ </>
+ }
+ error={error || undefined}
+ >
+ {loading ? (
+ <div className="cu-body-loading-skeleton" aria-label="Loading connector details">
+ Loading connector details…
+ </div>
+ ) : server ? (
+ <div className="cu-form-stack">
+ <section className="cu-form-section" aria-labelledby="connector-summary-title">
+ <h2 id="connector-summary-title" className="cu-form-section__title">
+ Configuration
+ </h2>
+ <dl className="cu-detail-grid">
+ <div>
+ <dt>Name</dt>
+ <dd>{name}</dd>
+ </div>
+ <div>
+ <dt>Namespace</dt>
+ <dd>{text(server.metadata?.namespace, 'default')}</dd>
+ </div>
+ <div>
+ <dt>Description</dt>
+ <dd>{text(spec.description)}</dd>
+ </div>
+ <div>
+ <dt>Image</dt>
+ <dd>{text(spec.image)}</dd>
+ </div>
+ <div>
+ <dt>Managed</dt>
+ <dd>{spec.managed === false ? 'No' : 'Yes'}</dd>
+ </div>
+ <div>
+ <dt>Enabled</dt>
+ <dd>{spec.enabled === false ? 'No' : 'Yes'}</dd>
+ </div>
+ <div>
+ <dt>Transport</dt>
+ <dd>{text(transport.type)}</dd>
+ </div>
+ <div>
+ <dt>Endpoint</dt>
+ <dd>{text(transport.url)}</dd>
+ </div>
+ </dl>
+ </section>
+ <section className="cu-form-section" aria-labelledby="connector-status-title">
+ <h2 id="connector-status-title" className="cu-form-section__title">
+ Runtime status
+ </h2>
+ {conditions.length ? (
+ <ul className="cu-detail-list">
+ {conditions.map(condition => (
+ <li key={condition.type}>
+ <strong>{condition.type}</strong>: {condition.status}
+ {condition.message ? ` — ${condition.message}` : ''}
+ </li>
+ ))}
+ </ul>
+ ) : (
+ <p className="cu-muted">No runtime conditions have been reported.</p>
+ )}
+ </section>
+ </div>
+ ) : null}
+ </DetailPageShell>
+ </AuthGate>
+ )
+}
diff --git a/control-ui/app/mcp-servers/page.tsx b/control-ui/app/mcp-servers/page.tsx
index 1e6eab8a7..e353bd1f8 100644
--- a/control-ui/app/mcp-servers/page.tsx
+++ b/control-ui/app/mcp-servers/page.tsx
@@ -414,7 +414,7 @@ export default function McpServersPage() {
onRemoveFromAgents={removeConnectorFromAgents}
updatingAgentAccessKey={updatingAgentAccessKey}
onDelete={handleDelete}
- onEdit={server => router.push(CONTROL_ROUTES.connectors.edit(server.name))}
+ onEdit={server => router.push(CONTROL_ROUTES.connectors.detail(server.name))}
deletingKey={deletingKey}
onRefresh={loadAll}
onCreate={() => router.push(CONTROL_ROUTES.connectors.new)}
diff --git a/control-ui/components/DetailPageShell/index.tsx b/control-ui/components/DetailPageShell/index.tsx
index 3be713006..b9bded6fe 100644
--- a/control-ui/components/DetailPageShell/index.tsx
+++ b/control-ui/components/DetailPageShell/index.tsx
@@ -51,17 +51,21 @@ export function DetailPageShell<T extends string>({
>
{tabs ? (
<TabBar<T>
- ariaLabel={tabAriaLabel}
- activeValue={activeTab}
+ ariaLabel={tabAriaLabel ?? 'Detail sections'}
+ activeValue={activeTab as T}
className={tabClassName}
- onChange={onTabChange}
+ onChange={onTabChange as (value: T) => void}
options={tabs}
/>
) : null}
</CreateFlowPanel>
{notice}
- {error ? <div className="cu-banner cu-banner--error">{error}</div> : null}
+ {error ? (
+ <div className="cu-banner cu-banner--error" role="alert">
+ {error}
+ </div>
+ ) : null}
{contentMode === 'plain' ? (
<div className={cn('cu-detail-content-stack', contentClassName)}>{children}</div>
diff --git a/control-ui/components/DetailPageShell/types.ts b/control-ui/components/DetailPageShell/types.ts
index c608bbe5c..fc21e55c8 100644
--- a/control-ui/components/DetailPageShell/types.ts
+++ b/control-ui/components/DetailPageShell/types.ts
@@ -3,7 +3,7 @@ import type { TabBarOption } from '@components/TabBar/types'
export type DetailPageShellProps<T extends string> = {
actions?: ReactNode
- activeTab: T
+ activeTab?: T
backDisabled?: boolean
backLabel: string
children: ReactNode
@@ -16,9 +16,9 @@ export type DetailPageShellProps<T extends string> = {
notice?: ReactNode
onBack: () => void
overlays?: ReactNode
- onTabChange: (value: T) => void
+ onTabChange?: (value: T) => void
subtitle: ReactNode
- tabAriaLabel: string
+ tabAriaLabel?: string
tabClassName?: string
tabs?: TabBarOption<T>[]
// ReactNode (not just string) so detail pages can render a loading
diff --git a/control-ui/components/__tests__/McpServerDetailPage.test.tsx b/control-ui/components/__tests__/McpServerDetailPage.test.tsx
new file mode 100644
index 000000000..018debed5
--- /dev/null
+++ b/control-ui/components/__tests__/McpServerDetailPage.test.tsx
@@ -0,0 +1,73 @@
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react'
+import McpServerDetailPage from '../../app/mcp-servers/[name]/page'
+import * as api from '../../lib/api'
+
+const navigation = vi.hoisted(() => ({ push: vi.fn(), params: { name: 'search' } }))
+
+vi.mock('next/navigation', () => ({
+ useParams: () => navigation.params,
+ useRouter: () => ({ push: navigation.push }),
+}))
+vi.mock('@components/AuthGate', () => ({
+ AuthGate: ({ children }: { children: React.ReactNode }) => <>{children}</>,
+}))
+vi.mock('@components/DashboardLayout', () => ({
+ DashboardLayout: ({ children }: { children: React.ReactNode }) => <>{children}</>,
+}))
+vi.mock('../../lib/api', async importOriginal => ({
+ ...(await importOriginal<typeof import('../../lib/api')>()),
+ getMcpServer: vi.fn(),
+}))
+
+afterEach(() => {
+ cleanup()
+ vi.clearAllMocks()
+})
+
+describe('McpServerDetailPage', () => {
+ it('renders non-secret configuration and links to the existing edit route', async () => {
+ vi.mocked(api.getMcpServer).mockResolvedValue({
+ metadata: { name: 'search', namespace: 'mcp-server' },
+ spec: {
+ description: 'Search the public web',
+ image: 'registry.example/search:1',
+ managed: true,
+ enabled: true,
+ transport: { type: 'streamable-http', url: 'https://search.example/mcp' },
+ envSecret: { name: 'search-credentials', keys: [{ secretKey: 'token' }] },
+ },
+ status: {
+ conditions: [
+ {
+ type: 'Ready',
+ status: 'True',
+ reason: 'Available',
+ message: 'Connector is ready.',
+ lastTransitionTime: '2026-09-23T00:00:00Z',
+ },
+ ],
+ },
+ })
+ render(<McpServerDetailPage />)
+
+ expect(await screen.findByRole('heading', { name: 'search' })).toBeVisible()
+ expect(screen.getByText('Search the public web')).toBeVisible()
+ expect(screen.getByText('https://search.example/mcp')).toBeVisible()
+ expect(screen.queryByText('search-credentials')).not.toBeInTheDocument()
+ expect(screen.queryByText('token')).not.toBeInTheDocument()
+ fireEvent.click(screen.getByRole('button', { name: 'Edit connector' }))
+ expect(navigation.push).toHaveBeenCalledWith('/connectors/search/edit')
+ })
+
+ it('refreshes in place and keeps failures on the detail page', async () => {
+ vi.mocked(api.getMcpServer)
+ .mockResolvedValueOnce({ metadata: { name: 'search' }, spec: {} })
+ .mockRejectedValueOnce(new Error('Connector search was not found.'))
+ render(<McpServerDetailPage />)
+ await screen.findByRole('heading', { name: 'search' })
+ fireEvent.click(screen.getByRole('button', { name: 'Refresh connector' }))
+ await waitFor(() => expect(screen.getByRole('alert')).toHaveTextContent('was not found'))
+ expect(navigation.push).not.toHaveBeenCalled()
+ })
+})
diff --git a/control-ui/package-lock.json b/control-ui/package-lock.json
index fe326d8aa..5e9f27ea0 100644
--- a/control-ui/package-lock.json
+++ b/control-ui/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-control-ui",
- "version": "0.1.617",
+ "version": "0.1.618",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-control-ui",
- "version": "0.1.617",
+ "version": "0.1.618",
"dependencies": {
"@clerum/display-field": "file:../packages/display-field",
"@clerum/frontend-components": "file:../packages/frontend-components",
diff --git a/control-ui/package.json b/control-ui/package.json
index bef45a63c..8bfc970f4 100644
--- a/control-ui/package.json
+++ b/control-ui/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-control-ui",
- "version": "0.1.617",
+ "version": "0.1.618",
"private": true,
"scripts": {
"dev": "NEXT_IGNORE_INCORRECT_LOCKFILE=1 next dev",