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.jsonindex 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.jsonindex 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.tsindex 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: SessionReplayFilterscursor?: stringlimit: 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: GovernedSessionReplayRerouter.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.tsindex 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: SessionReplayFilterscursor?: stringlimit: 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) : nullif (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.limitconst 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.tsindex 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 | nulllimit: numberpromptState: '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.tsindex 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.tsxindex 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 }: GovernedEventconst [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 }: GovernedEventdefinition?.fields.filter(field => state.filters[field.key]?.length).length ?? 0return {...column,+ ...(column.key === 'occurred'+ ? {+ activeDirection: order === 'latest' ? ('desc' as const) : ('asc' as const),+ onSort: () => setOrder(current => (current === 'latest' ? 'oldest' : 'latest')),+ }+ : {}),label: definition ? (<TraceFilterHeaderLabelactiveCount={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 }: GovernedEventsetLoading(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 }: GovernedEventif (!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.tsxindex 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: (<TraceFilterHeaderLabelactiveCount={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) returnconst 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) returnsetLoadingMore(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.tsxindex 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.tsindex 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?: stringtitle?: stringwidth?: string+ activeDirection?: SortDirection | null+ onSort?: () => void}diff --git a/control-ui/package-lock.json b/control-ui/package-lock.jsonindex 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.jsonindex 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",