Skip to content

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

bugfix: show token and cost metrics for failed and cancelled turns (#963)

harshil-2096e452b06337bb
diff --git a/.changeset/preserve-terminal-turn-metrics.md b/.changeset/preserve-terminal-turn-metrics.md
new file mode 100644
index 000000000..67b8db4c0
--- /dev/null
+++ b/.changeset/preserve-terminal-turn-metrics.md
@@ -0,0 +1,6 @@
+---
+'@truefoundry/trueforge-assistant-ui-runtime': patch
+'@truefoundry/trueforge-ui': patch
+---
+
+Preserve token and cost metrics on failed and cancelled turns in the UI adapter and types so turn headers and session totals include billable usage from non-done terminal turns.
diff --git a/packages/assistant-ui-runtime/src/server/types.ts b/packages/assistant-ui-runtime/src/server/types.ts
index 376aa4a20..46f35621e 100644
--- a/packages/assistant-ui-runtime/src/server/types.ts
+++ b/packages/assistant-ui-runtime/src/server/types.ts
@@ -299,12 +299,16 @@ export interface TurnStateCancelled {
status: 'cancelled';
reason: string;
completedAt: string;
+ /** Present when the host reports per-turn token totals before cancel. */
+ metrics?: TurnDoneMetrics;
}
export interface TurnStateError {
status: 'error';
message: string;
completedAt: string;
+ /** Present when the host reports per-turn token totals before error. */
+ metrics?: TurnDoneMetrics;
}
export type TurnState = TurnStateRunning | TurnStateDone | TurnStateCancelled | TurnStateError;
diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/toUiTurnState.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/toUiTurnState.ts
index 82e493e3e..fc3fa58d7 100644
--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/toUiTurnState.ts
+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/toUiTurnState.ts
@@ -24,9 +24,19 @@ export function toUiTurnState(state: TrueForgeApi.TurnState | TrueForgeApi.TurnD
function toUiTerminalTurnState(state: TrueForgeApi.TurnDoneEventState): Exclude<TurnState, { status: 'running' }> {
switch (state.status) {
case 'cancelled':
- return { status: 'cancelled', reason: state.reason, completedAt: state.completedAt };
+ 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 };
+ return {
+ status: 'error',
+ message: state.message,
+ completedAt: state.completedAt,
+ ...(state.metrics == null ? {} : { metrics: toUiTurnDoneMetrics(state.metrics) }),
+ };
case 'done':
return {
status: 'done',
diff --git a/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/toUiTurnState.test.ts b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/toUiTurnState.test.ts
index 02d1e471e..f205fd68b 100644
--- a/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/toUiTurnState.test.ts
+++ b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/toUiTurnState.test.ts
@@ -40,4 +40,53 @@ describe('toUiTurnState', () => {
},
);
});
+
+ it('maps an error state with metrics', () => {
+ assert.deepEqual(
+ toUiTurnState({
+ status: 'error',
+ message: 'Something went wrong',
+ completedAt: '2026-01-01T00:00:00.000Z',
+ metrics: { totalTokens: 15, totalCostInUsd: 0.05 },
+ }),
+ {
+ status: 'error',
+ message: 'Something went wrong',
+ completedAt: '2026-01-01T00:00:00.000Z',
+ metrics: {
+ totalInputTokens: 0,
+ totalOutputTokens: 0,
+ totalTokens: 15,
+ totalCacheReadTokens: 0,
+ totalCacheWriteTokens: 0,
+ totalReasoningTokens: 0,
+ totalCostInUsd: 0.05,
+ },
+ },
+ );
+ });
+
+ it('maps a cancelled state with metrics', () => {
+ assert.deepEqual(
+ toUiTurnState({
+ status: 'cancelled',
+ reason: 'client-cancelled',
+ completedAt: '2026-01-01T00:00:00.000Z',
+ metrics: { totalInputTokens: 20, totalOutputTokens: 5, totalTokens: 25 },
+ }),
+ {
+ status: 'cancelled',
+ reason: 'client-cancelled',
+ completedAt: '2026-01-01T00:00:00.000Z',
+ metrics: {
+ totalInputTokens: 20,
+ totalOutputTokens: 5,
+ totalTokens: 25,
+ totalCacheReadTokens: 0,
+ totalCacheWriteTokens: 0,
+ totalReasoningTokens: 0,
+ },
+ },
+ );
+ });
});
diff --git a/packages/trueforge-ui/test/utils/sessionAgentDetails.test.ts b/packages/trueforge-ui/test/utils/sessionAgentDetails.test.ts
index d8c332c17..b5b426d8c 100644
--- a/packages/trueforge-ui/test/utils/sessionAgentDetails.test.ts
+++ b/packages/trueforge-ui/test/utils/sessionAgentDetails.test.ts
@@ -240,10 +240,16 @@ describe('buildSessionTurnViews', () => {
status: 'error',
message: 'model failed',
completedAt: '2026-01-01T00:00:03.000Z',
- metrics: { totalTokens: 7, totalCostInUsd: 0.25 },
- } satisfies TurnDoneEvent['state'] & {
- metrics: { totalTokens: number; totalCostInUsd: number };
- };
+ metrics: {
+ totalTokens: 7,
+ totalCostInUsd: 0.25,
+ totalInputTokens: 0,
+ totalOutputTokens: 0,
+ totalCacheReadTokens: 0,
+ totalCacheWriteTokens: 0,
+ totalReasoningTokens: 0,
+ },
+ } satisfies TurnDoneEvent['state'];
const views = buildSessionTurnViews([
createdItem({