The open-source agent harness - the runtime layer that turns an LLM into a working agent.
import type { TrueForgeApi } from '@truefoundry/trueforge-sdk';
import type { SessionEventItem, TurnDoneMetrics, TurnState, TurnStreamingEvent } from '../../server/types.js';
/** SDK token fields are optional; the UI contract requires numbers. Keep cost for session tiles. */
export function toUiTurnDoneMetrics(metrics: TrueForgeApi.TurnMetrics): TurnDoneMetrics {
return {
totalInputTokens: metrics.totalInputTokens ?? 0,
totalOutputTokens: metrics.totalOutputTokens ?? 0,
totalTokens: metrics.totalTokens ?? 0,
totalCacheReadTokens: metrics.totalCacheReadTokens ?? 0,
totalCacheWriteTokens: metrics.totalCacheWriteTokens ?? 0,
totalReasoningTokens: metrics.totalReasoningTokens ?? 0,
...(metrics.totalCostInUsd == null ? {} : { totalCostInUsd: metrics.totalCostInUsd }),
};
}
export function toUiTurnState(state: TrueForgeApi.TurnState | TrueForgeApi.TurnDoneEventState): TurnState {
if (state.status === 'running' || state.status === 'paused') {
return { status: 'running' };
}
return toUiTerminalTurnState(state);
}
function toUiTerminalTurnState(state: TrueForgeApi.TurnDoneEventState): Exclude<TurnState, { status: 'running' }> {
switch (state.status) {
case 'cancelled':
return {
status: 'cancelled',
reason: state.reason,
completedAt: state.completedAt,
...(state.metrics == null ? {} : { metrics: toUiTurnDoneMetrics(state.metrics) }),
};
case 'error':
return {
status: 'error',
message: state.message,
completedAt: state.completedAt,
...(state.metrics == null ? {} : { metrics: toUiTurnDoneMetrics(state.metrics) }),
};
case 'done':
return {
status: 'done',
completedAt: state.completedAt,
requiredActions: state.requiredActions,
...(state.output == null ? {} : { output: state.output }),
...(state.metrics == null ? {} : { metrics: toUiTurnDoneMetrics(state.metrics) }),
};
}
}
/** SDK stream types the assistant-ui-runtime union does not include yet. */
// TODO: Remove this after we have migrated to the new schema.
function isUnmappedSdkEvent(event: TrueForgeApi.SessionEvent | TrueForgeApi.TurnStreamingEvent): event is Extract<
TrueForgeApi.SessionEvent | TrueForgeApi.TurnStreamingEvent,
{
type:
| 'turn.update'
| 'user.tool_approval'
| 'user.tool_response'
| 'user.tool_approval_policy'
| 'user.mcp_auth_continue';
}
> {
return (
event.type === 'turn.update' ||
event.type === 'user.tool_approval' ||
event.type === 'user.tool_response' ||
event.type === 'user.tool_approval_policy' ||
event.type === 'user.mcp_auth_continue'
);
}
export function toUiSessionEvent(event: TrueForgeApi.SessionEvent): SessionEventItem['event'] | undefined {
if (isUnmappedSdkEvent(event)) return undefined;
if (event.type !== 'turn.done') return { ...event };
return { ...event, state: toUiTerminalTurnState(event.state) };
}
export function toUiStreamingEvent(event: TrueForgeApi.TurnStreamingEvent): TurnStreamingEvent | undefined {
if (isUnmappedSdkEvent(event)) return undefined;
if (event.type !== 'turn.done') return { ...event };
return { ...event, state: toUiTerminalTurnState(event.state) };
}
export function toUiEventItem(item: TrueForgeApi.SessionEventItem): SessionEventItem | undefined {
const event = toUiSessionEvent(item.event);
return event === undefined ? undefined : { turnId: item.turnId, event };
}