Skip to content

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

TypeScript

feat(tracing): add authoritative table ordering

Josué62f862daa2b8
diff --git a/control-api/package-lock.json b/control-api/package-lock.json
index 5af411a25..bfc68805f 100644
--- a/control-api/package-lock.json
+++ b/control-api/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-control-api",
- "version": "0.1.520",
+ "version": "0.1.521",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-control-api",
- "version": "0.1.520",
+ "version": "0.1.521",
"dependencies": {
"@clerum/display-field": "file:../packages/display-field",
"@clerum/image-policy": "file:../packages/image-policy",
diff --git a/control-api/package.json b/control-api/package.json
index 9c3a25f81..9b045fb78 100644
--- a/control-api/package.json
+++ b/control-api/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-control-api",
- "version": "0.1.520",
+ "version": "0.1.521",
"description": "Internal Clerum control plane REST API + UI for managing CRDs and secrets",
"main": "dist/main.js",
"engines": {
diff --git a/control-api/src/routes/admin/tracing/sessions.routes.ts b/control-api/src/routes/admin/tracing/sessions.routes.ts
index 7bd84ca66..fc965a71e 100644
--- a/control-api/src/routes/admin/tracing/sessions.routes.ts
+++ b/control-api/src/routes/admin/tracing/sessions.routes.ts
@@ -30,6 +30,7 @@ export interface GovernedSessionReplayReader {
filters: SessionReplayFilters
cursor?: string
limit: number
+ order?: 'oldest' | 'latest'
}): Promise<GovernedTraceSessionPageV1>
detail(input: {
hostRef: string
@@ -84,6 +85,7 @@ function parseFilters(req: Request): SessionReplayFilters {
'origin',
'toolName',
'approvalState',
+ 'order',
])
const unexpected = Object.keys(req.query).find(key => !allowed.has(key))
if (unexpected) throw new Error(`unsupported query parameter: ${unexpected}`)
@@ -141,7 +143,17 @@ export function createAdminTracingSessionsRouter(reader: GovernedSessionReplayRe
router.get('/admin/tracing/sessions', async (req, res, next) => {
try {
const page = paging(req)
- res.status(200).json(await reader.list({ ...page, filters: parseFilters(req) }))
+ const order = one(req, 'order')
+ if (order !== undefined && order !== 'oldest' && order !== 'latest') {
+ throw new Error('order must be oldest or latest')
+ }
+ res.status(200).json(
+ await reader.list({
+ ...page,
+ filters: parseFilters(req),
+ ...(order ? { order } : {}),
+ })
+ )
} catch (error) {
if (error instanceof Error && !('status' in error)) {
res.status(400).json({ error: 'invalid_query', detail: error.message })
diff --git a/control-api/src/services/tracing/governedSessionReplayService.ts b/control-api/src/services/tracing/governedSessionReplayService.ts
index 01c2d5449..8c535b29d 100644
--- a/control-api/src/services/tracing/governedSessionReplayService.ts
+++ b/control-api/src/services/tracing/governedSessionReplayService.ts
@@ -56,8 +56,10 @@ export class GovernedSessionReplayService {
filters: SessionReplayFilters
cursor?: string
limit: number
+ order?: 'oldest' | 'latest'
}): Promise<GovernedTraceSessionPageV1> {
- const queryHash = canonicalPayloadSha256({ filters: input.filters })
+ const order = input.order ?? 'latest'
+ const queryHash = canonicalPayloadSha256({ filters: input.filters, order })
const cursor = input.cursor ? decodeCursor(input.cursor) : null
if (
cursor &&
@@ -76,6 +78,7 @@ export class GovernedSessionReplayService {
after: cursor?.after as SessionPageAnchor | null,
limit: input.limit + 1,
promptState: promptState(),
+ order,
})
const hasMore = page.summaries.length > input.limit
const sessions = page.summaries.slice(0, input.limit)
@@ -138,6 +141,7 @@ export class GovernedSessionReplayService {
after: null,
limit: 1,
promptState: promptState(),
+ order: 'latest',
}),
this.repository.readRuns(input.hostRef, input.sessionId, highWatermark),
this.repository.readTools(input.hostRef, input.sessionId, highWatermark),
diff --git a/control-api/src/services/tracing/postgresGovernedSessionListRepository.ts b/control-api/src/services/tracing/postgresGovernedSessionListRepository.ts
index eab2d2735..f3e56327c 100644
--- a/control-api/src/services/tracing/postgresGovernedSessionListRepository.ts
+++ b/control-api/src/services/tracing/postgresGovernedSessionListRepository.ts
@@ -65,6 +65,7 @@ export class PostgresGovernedSessionListRepository {
after: SessionPageAnchor | null
limit: number
promptState: 'enabled' | 'disabled' | 'unavailable'
+ order: 'oldest' | 'latest'
}): Promise<SessionRepositoryPage> {
const values: unknown[] = [
params.highWatermark,
@@ -112,8 +113,10 @@ export class PostgresGovernedSessionListRepository {
)
}
let pagePredicate = ''
+ const pageOperator = params.order === 'latest' ? '<' : '>'
+ const orderDirection = params.order === 'latest' ? 'DESC' : 'ASC'
if (params.after) {
- pagePredicate = `WHERE (last_occurred_at, host_ref, session_id) <
+ pagePredicate = `WHERE (last_occurred_at, host_ref, session_id) ${pageOperator}
(${bind(params.after.occurredAt)}::timestamptz, ${bind(params.after.hostRef)}, ${bind(params.after.sessionId)})`
}
values.push(params.limit)
@@ -195,7 +198,7 @@ export class PostgresGovernedSessionListRepository {
GROUP BY a.host_ref, a.session_id
)
SELECT * FROM grouped ${pagePredicate}
- ORDER BY last_occurred_at DESC, host_ref DESC, session_id DESC
+ ORDER BY last_occurred_at ${orderDirection}, host_ref ${orderDirection}, session_id ${orderDirection}
LIMIT $${values.length}`,
values
)
diff --git a/control-api/test/services.governedSessionReplay.test.ts b/control-api/test/services.governedSessionReplay.test.ts
index 5c876a283..fb8c1bb04 100644
--- a/control-api/test/services.governedSessionReplay.test.ts
+++ b/control-api/test/services.governedSessionReplay.test.ts
@@ -73,8 +73,13 @@ describe('GovernedSessionReplayService', () => {
expect(list.mock.calls[1][0]).toMatchObject({
highWatermark: '42',
after: { occurredAt: '2026-07-01T02:00:00.000Z', hostRef: 'host-a', sessionId: 'session-2' },
+ order: 'latest',
})
+ await expect(
+ service.list({ filters: FILTERS, limit: 1, order: 'oldest', cursor: first.nextCursor! })
+ ).rejects.toBeInstanceOf(GovernedSessionReplayInvalidQueryError)
+
await expect(
service.list({
filters: { ...FILTERS, hostRef: ['different-host'] },
diff --git a/control-ui/components/GovernedTraceSurface/GovernedEventExplorer/index.tsx b/control-ui/components/GovernedTraceSurface/GovernedEventExplorer/index.tsx
index eda95b21c..1ebd424b0 100644
--- a/control-ui/components/GovernedTraceSurface/GovernedEventExplorer/index.tsx
+++ b/control-ui/components/GovernedTraceSurface/GovernedEventExplorer/index.tsx
@@ -40,6 +40,7 @@ export function GovernedEventExplorer({ family, subtitle, title }: GovernedEvent
const [loading, setLoading] = useState(false)
const [loadingMore, setLoadingMore] = useState(false)
const [openFilterId, setOpenFilterId] = useState<string | null>(null)
+ const [order, setOrder] = useState<'oldest' | 'latest'>('latest')
const columns = useMemo<TableHeaderColumn[]>(
() =>
@@ -49,6 +50,12 @@ export function GovernedEventExplorer({ family, subtitle, title }: GovernedEvent
definition?.fields.filter(field => state.filters[field.key]?.length).length ?? 0
return {
...column,
+ ...(column.key === 'occurred'
+ ? {
+ activeDirection: order === 'latest' ? ('desc' as const) : ('asc' as const),
+ onSort: () => setOrder(current => (current === 'latest' ? 'oldest' : 'latest')),
+ }
+ : {}),
label: definition ? (
<TraceFilterHeaderLabel
activeCount={activeCount}
@@ -60,7 +67,7 @@ export function GovernedEventExplorer({ family, subtitle, title }: GovernedEvent
),
}
}),
- [columnLayout, definitions, state.filters]
+ [columnLayout, definitions, order, state.filters]
)
useEffect(() => {
@@ -72,7 +79,7 @@ export function GovernedEventExplorer({ family, subtitle, title }: GovernedEvent
setLoading(true)
void getGovernedTraceEvents(
'/api/v1/admin/tracing/events',
- { ...apiQuery, families: [family], order: 'latest' },
+ { ...apiQuery, families: [family], order },
controller.signal
)
.then(next => {
@@ -90,7 +97,7 @@ export function GovernedEventExplorer({ family, subtitle, title }: GovernedEvent
if (!controller.signal.aborted) setLoading(false)
})
return () => controller.abort()
- }, [apiQuery, boundaryEpoch, family, stateKey])
+ }, [apiQuery, boundaryEpoch, family, order, stateKey])
async function loadMore() {
if (!apiQuery || !page?.nextCursor) return
@@ -101,7 +108,7 @@ export function GovernedEventExplorer({ family, subtitle, title }: GovernedEvent
...apiQuery,
cursor: page.nextCursor,
families: [family],
- order: 'latest',
+ order,
})
setPage(next)
setEvents(current => [...current, ...next.events])
diff --git a/control-ui/components/GovernedTraceSurface/SessionReplay/index.tsx b/control-ui/components/GovernedTraceSurface/SessionReplay/index.tsx
index 74e8239fd..c0ae00cd0 100644
--- a/control-ui/components/GovernedTraceSurface/SessionReplay/index.tsx
+++ b/control-ui/components/GovernedTraceSurface/SessionReplay/index.tsx
@@ -46,11 +46,18 @@ export function SessionReplay({
const [loadingMore, setLoadingMore] = useState(false)
const [openFilterId, setOpenFilterId] = useState<string | null>(null)
const [copiedSessionKey, setCopiedSessionKey] = useState<string | null>(null)
+ const [order, setOrder] = useState<'oldest' | 'latest'>('latest')
const columns = useMemo<TableHeaderColumn[]>(
() =>
SESSION_COLUMN_LAYOUT.map(column => ({
...column,
+ ...(column.key === 'activity'
+ ? {
+ activeDirection: order === 'latest' ? ('desc' as const) : ('asc' as const),
+ onSort: () => setOrder(current => (current === 'latest' ? 'oldest' : 'latest')),
+ }
+ : {}),
label: (
<TraceFilterHeaderLabel
activeCount={filterCountForColumn(column.key, state.filters)}
@@ -59,7 +66,7 @@ export function SessionReplay({
/>
),
})),
- [state.filters]
+ [order, state.filters]
)
useEffect(() => {
@@ -69,7 +76,7 @@ export function SessionReplay({
if (!apiQuery) return
const controller = new AbortController()
setLoading(true)
- void getGovernedTraceSessions(apiQuery, controller.signal)
+ void getGovernedTraceSessions({ ...apiQuery, order }, controller.signal)
.then(next => {
setPage(next)
setSessions(next.sessions)
@@ -83,14 +90,18 @@ export function SessionReplay({
if (!controller.signal.aborted) setLoading(false)
})
return () => controller.abort()
- }, [apiQuery, boundaryEpoch, stateKey])
+ }, [apiQuery, boundaryEpoch, order, stateKey])
async function loadMore() {
if (!apiQuery || !page?.nextCursor) return
setLoadingMore(true)
setError(null)
try {
- const next = await getGovernedTraceSessions({ ...apiQuery, cursor: page.nextCursor })
+ const next = await getGovernedTraceSessions({
+ ...apiQuery,
+ cursor: page.nextCursor,
+ order,
+ })
setPage(next)
setSessions(current => [...current, ...next.sessions])
} catch (readError) {
diff --git a/control-ui/components/TableHeaderRow/index.tsx b/control-ui/components/TableHeaderRow/index.tsx
index 0cd285129..38651e14f 100644
--- a/control-ui/components/TableHeaderRow/index.tsx
+++ b/control-ui/components/TableHeaderRow/index.tsx
@@ -12,6 +12,8 @@ export function TableHeaderRow({ columns }: { columns: TableHeaderColumn[] }) {
aria-label={column.ariaLabel}
title={column.title}
label={column.label}
+ activeDirection={column.activeDirection}
+ onSort={column.onSort}
style={{
...(column.width ? { width: column.width } : {}),
...(column.minWidth ? { minWidth: column.minWidth } : {}),
diff --git a/control-ui/components/TableHeaderRow/types.ts b/control-ui/components/TableHeaderRow/types.ts
index 5c25cd7f4..8b0c35806 100644
--- a/control-ui/components/TableHeaderRow/types.ts
+++ b/control-ui/components/TableHeaderRow/types.ts
@@ -1,4 +1,5 @@
import type { ReactNode } from 'react'
+import type { SortDirection } from '@clerum/frontend-table-system'
export type TableHeaderColumn = {
align?: 'left' | 'right' | 'center'
@@ -8,4 +9,6 @@ export type TableHeaderColumn = {
minWidth?: string
title?: string
width?: string
+ activeDirection?: SortDirection | null
+ onSort?: () => void
}
diff --git a/control-ui/package-lock.json b/control-ui/package-lock.json
index a0f9e875b..b8ff6885d 100644
--- a/control-ui/package-lock.json
+++ b/control-ui/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-control-ui",
- "version": "0.1.477",
+ "version": "0.1.478",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-control-ui",
- "version": "0.1.477",
+ "version": "0.1.478",
"dependencies": {
"@clerum/display-field": "file:../packages/display-field",
"@clerum/frontend-table-system": "file:../packages/frontend-table-system",
diff --git a/control-ui/package.json b/control-ui/package.json
index 5992095af..a649e2177 100644
--- a/control-ui/package.json
+++ b/control-ui/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-control-ui",
- "version": "0.1.477",
+ "version": "0.1.478",
"private": true,
"scripts": {
"dev": "NEXT_IGNORE_INCORRECT_LOCKFILE=1 next dev",