Enterprise agent platform for building, deploying, and operating AI teammates.
import { describe, expect, it } from "vitest"
import {
getFinalAnswerStreamActionPayload,
getFinalAnswerStreamMessageId,
getWebSocketEventType,
mergeTraceEventsById,
shouldBufferMessageForHistoricalReplay,
} from "@/lib/streaming-final-answer"
describe("streaming final answer events", () => {
it("reads websocket final-answer fields from nested data payloads", () => {
const payload = getFinalAnswerStreamActionPayload({
eventType: "final_answer_delta",
eventData: {
type: "final_answer_delta",
data: {
message_id: "final_answer_1",
delta: "hello",
},
},
timestamp: "2026-05-20T12:00:00.000Z",
})
expect(payload).toEqual({
messageId: "final_answer_1",
delta: "hello",
status: "running",
timestamp: "2026-05-20T12:00:00.000Z",
})
})
it("preserves streaming message trace events when final content replaces the message", () => {
const toolStart = {
event_id: "tool-start",
event_type: "tool_execution_start",
}
const toolEnd = {
event_id: "tool-end",
event_type: "tool_execution_end",
}
expect(
mergeTraceEventsById([toolStart, toolEnd], [], [toolEnd]),
).toEqual([toolStart, toolEnd])
})
it("restores an interrupted boundary without inventing partial text", () => {
expect(getFinalAnswerStreamActionPayload({
eventType: "final_answer_start", executionSequence: 10,
eventData: { message_id: "final_answer_1", status: "interrupted" },
timestamp: "2026-09-30T00:00:00Z",
})).toEqual({ messageId: "final_answer_1", status: "interrupted",
executionSequence: 10, timestamp: "2026-09-30T00:00:00Z" })
})
it("marks error events as failed terminal stream updates", () => {
const payload = getFinalAnswerStreamActionPayload({
eventType: "final_answer_error",
eventData: {
message_id: "final_answer_1",
error: "provider disconnected",
},
timestamp: "2026-05-20T12:00:01.000Z",
})
expect(payload).toEqual({
messageId: "final_answer_1",
content: "provider disconnected",
status: "failed",
timestamp: "2026-05-20T12:00:01.000Z",
})
})
it("extracts stream message id from authoritative final payloads", () => {
expect(
getFinalAnswerStreamMessageId({
result: { stream_message_id: "final_answer_1" },
}),
).toBe("final_answer_1")
expect(
getFinalAnswerStreamMessageId({
stream_message_id: "final_answer_2",
}),
).toBe("final_answer_2")
})
it("does not replay-buffer live final answer stream events", () => {
expect(
shouldBufferMessageForHistoricalReplay({
isReplaying: true,
isHistoryLoading: true,
message: { type: "final_answer_delta" },
}),
).toBe(false)
})
it("only buffers non-stream events while historical replay is loading", () => {
expect(
shouldBufferMessageForHistoricalReplay({
isReplaying: true,
isHistoryLoading: true,
message: {
type: "trace_event",
event_type: "tool_execution_start",
},
}),
).toBe(true)
expect(
shouldBufferMessageForHistoricalReplay({
isReplaying: true,
isHistoryLoading: false,
message: {
type: "trace_event",
event_type: "tool_execution_start",
},
}),
).toBe(false)
})
it("keeps historical completion as the replay flush marker", () => {
expect(getWebSocketEventType({ type: "historical_data_complete" })).toBe(
"historical_data_complete",
)
expect(
shouldBufferMessageForHistoricalReplay({
isReplaying: true,
isHistoryLoading: false,
message: { type: "historical_data_complete" },
}),
).toBe(true)
})
})