Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

3.4 KB
Raw Blame
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 };
}