fix(#686): implement robust history pagination (#687)

* fix(#686): implement robust history pagination

Honor server-returned offset, degrade gracefully on older servers, and parse JSON tool results.

* fix(ci): repair unit-test compilation and pagination test mocks

- Remove trailing blank line in SessionMessagesResponse.kt (ktlint)
- Replace unresolved io.mockk.eq/coAnswers usage in ChatViewModelTest with
  an ordered-call counter inside coAnswers, which compiles and runs on
  MockK 1.14.11 (eq is a matcher-scope member, not a top-level import)
- Align HermesApiServiceMockWebServerTest with the PR's JsonElement content
  model (contentText) and the new include_compacted=true default query param

All unit tests pass locally with the ByteBuddy agent preload.

---------

Co-authored-by: M57 <hy4ri@users.noreply.github.com>
This commit is contained in:
M57andM57 authored and GitHub committed 2026-07-23 00:30:48 +03:00
1 parent 34ba93901b
commit def122ab58
5 files changed
+294 -16

No files matched your search

@@ -247,11 +247,11 @@ class HermesApiServiceMockWebServerTest {
assertEquals(3, messages.size)
assertEquals("user", messages[0].role)
assertEquals("Hello Hermes", messages[0].content)
assertEquals("Hello Hermes", messages[0].contentText)
assertEquals("1718000000", messages[0].timestampText)
assertEquals("assistant", messages[1].role)
assertEquals("Hi! How can I help?", messages[1].content)
assertEquals("Hi! How can I help?", messages[1].contentText)
assertEquals("tool", messages[2].role)
assertEquals("tool_execution", messages[2].type)
@@ -270,11 +270,68 @@ class HermesApiServiceMockWebServerTest {
assertTrue(response.isSuccessful)
assertEquals(
"/api/sessions/desktop/session/messages?limit=150&offset=300",
"/api/sessions/desktop/session/messages?limit=150&offset=300&include_compacted=true",
mockServer.takeRequest().path,
)
}
@Test
fun getSessionMessages_withJsonObjectToolResult_deserializesSuccessfully() =
runBlocking {
mockServer.enqueue(
MockResponse()
.setResponseCode(200)
.setBody(
"""
{
"messages": [
{
"role": "tool",
"content": {"status": "ok", "items": [1, 2]},
"type": "tool_result"
}
]
}
""".trimIndent(),
),
)
val response = api.getSessionMessages("test-session-id")
assertTrue(response.isSuccessful)
val body = response.body()
assertNotNull(body)
assertEquals(1, body!!.messages.size)
assertEquals("tool", body.messages[0].role)
assertEquals("{\"status\":\"ok\",\"items\":[1,2]}", body.messages[0].contentText)
}
@Test
fun getSessionMessages_withOffsetAndTotal_deserializesPaginationFields() =
runBlocking {
mockServer.enqueue(
MockResponse()
.setResponseCode(200)
.setBody(
"""
{
"messages": [],
"offset": 45,
"total": 120
}
""".trimIndent(),
),
)
val response = api.getSessionMessages("test-session-id")
assertTrue(response.isSuccessful)
val body = response.body()
assertNotNull(body)
assertEquals(45, body!!.offset)
assertEquals(120, body.total)
}
@Test
fun getSessionMessages_withNullRole_doesNotCrash() =
runBlocking {
@@ -303,7 +360,7 @@ class HermesApiServiceMockWebServerTest {
assertNotNull(body)
assertEquals(1, body!!.messages.size)
assertNull(body.messages[0].role)
assertEquals("Plain content", body.messages[0].content)
assertEquals("Plain content", body.messages[0].contentText)
assertNull(body.messages[0].timestamp)
}
@@ -383,7 +440,7 @@ class HermesApiServiceMockWebServerTest {
val request = mockServer.takeRequest()
assertEquals(
"path should contain the session ID with slashes preserved",
"/api/sessions/session/with/slashes/messages?offset=0",
"/api/sessions/session/with/slashes/messages?offset=0&include_compacted=true",
request.path,
)
}
@@ -32,6 +32,9 @@ import kotlinx.coroutines.test.advanceUntilIdle
import kotlinx.coroutines.test.resetMain
import kotlinx.coroutines.test.runTest
import kotlinx.coroutines.test.setMain
import kotlinx.serialization.json.JsonPrimitive
import kotlinx.serialization.json.buildJsonObject
import kotlinx.serialization.json.put
import org.junit.After
import org.junit.Assert.assertEquals
import org.junit.Assert.assertFalse
@@ -1677,7 +1680,7 @@ class ChatViewModelTest {
verify { HermesWsClient.disconnect() }
}
// ── History pagination guard (issue #674) ───────────────────────────────
// ── History pagination guard (issue #674 & #686) ───────────────────────────────
/**
* When the initial REST page returns empty messages, hasOlderMessages
@@ -1707,7 +1710,7 @@ class ChatViewModelTest {
),
)
coEvery {
mockApi.getSessionMessages("session-456", any(), any())
mockApi.getSessionMessages("session-456", any(), any(), any())
} returns
retrofit2.Response.success(
com.m57.hermescontrol.data.model.SessionMessagesResponse(
@@ -1725,4 +1728,201 @@ class ChatViewModelTest {
assertTrue(viewModel.uiState.value.messages.isEmpty())
assertFalse(viewModel.uiState.value.isLoading)
}
@Test
fun testLoadOlderMessages_honorsServerReturnedOffset() =
runTest {
val (viewModel, _) = createViewModelWithSession()
val mockApi = ApiClient.hermesApi
coEvery {
mockApi.getSessions(any(), any(), any())
} returns
retrofit2.Response.success(
com.m57.hermescontrol.data.model.SessionListResponse(
sessions =
listOf(
com.m57.hermescontrol.data.model.SessionInfo(
id = "session-456",
title = "Test",
message_count = 100,
),
),
total = 1,
),
)
var messagesCallCount = 0
coEvery {
mockApi.getSessionMessages("session-456", any(), any(), any())
} coAnswers {
messagesCallCount += 1
if (messagesCallCount == 1) {
retrofit2.Response.success(
com.m57.hermescontrol.data.model.SessionMessagesResponse(
messages =
listOf(
com.m57.hermescontrol.data.model.SessionMessage(
role = "assistant",
content = JsonPrimitive("Msg 50"),
),
),
offset = 50,
total = 100,
),
)
} else {
retrofit2.Response.success(
com.m57.hermescontrol.data.model.SessionMessagesResponse(
messages =
listOf(
com.m57.hermescontrol.data.model.SessionMessage(
role = "user",
content = JsonPrimitive("Older Msg 20"),
),
),
offset = 20,
total = 100,
),
)
}
}
viewModel.switchSession("session-456")
advanceUntilIdle()
assertTrue(viewModel.uiState.value.hasOlderMessages)
// Server returns effective offset 20 (different from requested offset 0)
viewModel.loadOlderMessages()
advanceUntilIdle()
assertTrue(viewModel.uiState.value.hasOlderMessages)
val messages = viewModel.uiState.value.messages
assertEquals(2, messages.size)
assertEquals("rest-session-456-20", messages[0].id)
assertEquals("Older Msg 20", messages[0].content)
}
@Test
fun testLoadOlderMessages_oldServerFallback_stopsPaginationWhenOffsetDoesNotDecrease() =
runTest {
val (viewModel, _) = createViewModelWithSession()
val mockApi = ApiClient.hermesApi
coEvery {
mockApi.getSessions(any(), any(), any())
} returns
retrofit2.Response.success(
com.m57.hermescontrol.data.model.SessionListResponse(
sessions =
listOf(
com.m57.hermescontrol.data.model.SessionInfo(
id = "session-456",
title = "Test",
message_count = 100,
),
),
total = 1,
),
)
var messagesCallCount = 0
coEvery {
mockApi.getSessionMessages("session-456", any(), any(), any())
} coAnswers {
messagesCallCount += 1
if (messagesCallCount == 1) {
retrofit2.Response.success(
com.m57.hermescontrol.data.model.SessionMessagesResponse(
messages =
listOf(
com.m57.hermescontrol.data.model.SessionMessage(
role = "assistant",
content = JsonPrimitive("Msg 50"),
),
),
offset = 50,
total = 100,
),
)
} else {
// Older server ignores query params and returns offset = 50
// (same as oldOffset, offset did not decrease)
retrofit2.Response.success(
com.m57.hermescontrol.data.model.SessionMessagesResponse(
messages =
listOf(
com.m57.hermescontrol.data.model.SessionMessage(
role = "assistant",
content = JsonPrimitive("Msg 50"),
),
),
offset = 50,
total = 100,
),
)
}
}
viewModel.switchSession("session-456")
advanceUntilIdle()
viewModel.loadOlderMessages()
advanceUntilIdle()
assertFalse(
"hasOlderMessages must be false when returned offset does not decrease",
viewModel.uiState.value.hasOlderMessages,
)
}
@Test
fun testLoadMessages_handlesJsonObjectToolResult() =
runTest {
val (viewModel, _) = createViewModelWithSession()
val mockApi = ApiClient.hermesApi
coEvery {
mockApi.getSessions(any(), any(), any())
} returns
retrofit2.Response.success(
com.m57.hermescontrol.data.model.SessionListResponse(
sessions =
listOf(
com.m57.hermescontrol.data.model.SessionInfo(
id = "session-456",
title = "Test",
message_count = 1,
),
),
total = 1,
),
)
val jsonObjectContent =
buildJsonObject {
put("status", JsonPrimitive("ok"))
}
coEvery {
mockApi.getSessionMessages("session-456", any(), any(), any())
} returns
retrofit2.Response.success(
com.m57.hermescontrol.data.model.SessionMessagesResponse(
messages =
listOf(
com.m57.hermescontrol.data.model.SessionMessage(
role = "tool",
content = jsonObjectContent,
),
),
offset = 0,
total = 1,
),
)
viewModel.switchSession("session-456")
advanceUntilIdle()
val messages = viewModel.uiState.value.messages
assertEquals(1, messages.size)
assertEquals("{\"status\":\"ok\"}", messages[0].content)
}
}