YeonGyu-Kim 11586445cf fix: make sessionExists() async with SDK verification on SQLite
sessionExists() previously returned unconditional true on SQLite,
preventing ralph-loop orphaned-session cleanup from triggering.
Now uses sdkClient.session.messages() to verify session actually
exists. Callers updated to await the async result.

Addresses Cubic review feedback on PR #1837.
2026-02-16 16:13:40 +09:00

492 lines
16 KiB
TypeScript

import { describe, test, expect, beforeEach, afterEach, mock } from "bun:test"
import { mkdirSync, writeFileSync, rmSync, existsSync } from "node:fs"
import { join } from "node:path"
import { tmpdir } from "node:os"
import { randomUUID } from "node:crypto"
const TEST_DIR = join(tmpdir(), `omo-test-session-manager-${randomUUID()}`)
const TEST_MESSAGE_STORAGE = join(TEST_DIR, "message")
const TEST_PART_STORAGE = join(TEST_DIR, "part")
const TEST_SESSION_STORAGE = join(TEST_DIR, "session")
const TEST_TODO_DIR = join(TEST_DIR, "todos")
const TEST_TRANSCRIPT_DIR = join(TEST_DIR, "transcripts")
mock.module("./constants", () => ({
OPENCODE_STORAGE: TEST_DIR,
MESSAGE_STORAGE: TEST_MESSAGE_STORAGE,
PART_STORAGE: TEST_PART_STORAGE,
SESSION_STORAGE: TEST_SESSION_STORAGE,
TODO_DIR: TEST_TODO_DIR,
TRANSCRIPT_DIR: TEST_TRANSCRIPT_DIR,
SESSION_LIST_DESCRIPTION: "test",
SESSION_READ_DESCRIPTION: "test",
SESSION_SEARCH_DESCRIPTION: "test",
SESSION_INFO_DESCRIPTION: "test",
SESSION_DELETE_DESCRIPTION: "test",
TOOL_NAME_PREFIX: "session_",
}))
mock.module("../../shared/opencode-storage-detection", () => ({
isSqliteBackend: () => false,
resetSqliteBackendCache: () => {},
}))
const { getAllSessions, getMessageDir, sessionExists, readSessionMessages, readSessionTodos, getSessionInfo } =
await import("./storage")
const storage = await import("./storage")
describe("session-manager storage", () => {
beforeEach(() => {
if (existsSync(TEST_DIR)) {
rmSync(TEST_DIR, { recursive: true, force: true })
}
mkdirSync(TEST_DIR, { recursive: true })
mkdirSync(TEST_MESSAGE_STORAGE, { recursive: true })
mkdirSync(TEST_PART_STORAGE, { recursive: true })
mkdirSync(TEST_SESSION_STORAGE, { recursive: true })
mkdirSync(TEST_TODO_DIR, { recursive: true })
mkdirSync(TEST_TRANSCRIPT_DIR, { recursive: true })
})
afterEach(() => {
if (existsSync(TEST_DIR)) {
rmSync(TEST_DIR, { recursive: true, force: true })
}
})
test("getAllSessions returns empty array when no sessions exist", async () => {
// when
const sessions = await getAllSessions()
// then
expect(Array.isArray(sessions)).toBe(true)
expect(sessions).toEqual([])
})
test("getMessageDir finds session in direct path", () => {
// given
const sessionID = "ses_test123"
const sessionPath = join(TEST_MESSAGE_STORAGE, sessionID)
mkdirSync(sessionPath, { recursive: true })
writeFileSync(join(sessionPath, "msg_001.json"), JSON.stringify({ id: "msg_001", role: "user" }))
// when
const result = getMessageDir(sessionID)
// then
expect(result).toBe(sessionPath)
})
test("sessionExists returns false for non-existent session", async () => {
// when
const exists = await sessionExists("ses_nonexistent")
// then
expect(exists).toBe(false)
})
test("sessionExists returns true for existing session", async () => {
// given
const sessionID = "ses_exists"
const sessionPath = join(TEST_MESSAGE_STORAGE, sessionID)
mkdirSync(sessionPath, { recursive: true })
writeFileSync(join(sessionPath, "msg_001.json"), JSON.stringify({ id: "msg_001" }))
// when
const exists = await sessionExists(sessionID)
// then
expect(exists).toBe(true)
})
test("readSessionMessages returns empty array for non-existent session", async () => {
// when
const messages = await readSessionMessages("ses_nonexistent")
// then
expect(messages).toEqual([])
})
test("readSessionMessages sorts messages by timestamp", async () => {
// given
const sessionID = "ses_test123"
const sessionPath = join(TEST_MESSAGE_STORAGE, sessionID)
mkdirSync(sessionPath, { recursive: true })
writeFileSync(
join(sessionPath, "msg_002.json"),
JSON.stringify({ id: "msg_002", role: "assistant", time: { created: 2000 } })
)
writeFileSync(
join(sessionPath, "msg_001.json"),
JSON.stringify({ id: "msg_001", role: "user", time: { created: 1000 } })
)
// when
const messages = await readSessionMessages(sessionID)
// then
expect(messages.length).toBe(2)
expect(messages[0].id).toBe("msg_001")
expect(messages[1].id).toBe("msg_002")
})
test("readSessionTodos returns empty array when no todos exist", async () => {
// when
const todos = await readSessionTodos("ses_nonexistent")
// then
expect(todos).toEqual([])
})
test("getSessionInfo returns null for non-existent session", async () => {
// when
const info = await getSessionInfo("ses_nonexistent")
// then
expect(info).toBeNull()
})
test("getSessionInfo aggregates session metadata correctly", async () => {
// given
const sessionID = "ses_test123"
const sessionPath = join(TEST_MESSAGE_STORAGE, sessionID)
mkdirSync(sessionPath, { recursive: true })
const now = Date.now()
writeFileSync(
join(sessionPath, "msg_001.json"),
JSON.stringify({
id: "msg_001",
role: "user",
agent: "build",
time: { created: now - 10000 },
})
)
writeFileSync(
join(sessionPath, "msg_002.json"),
JSON.stringify({
id: "msg_002",
role: "assistant",
agent: "oracle",
time: { created: now },
})
)
// when
const info = await getSessionInfo(sessionID)
// then
expect(info).not.toBeNull()
expect(info?.id).toBe(sessionID)
expect(info?.message_count).toBe(2)
expect(info?.agents_used).toContain("build")
expect(info?.agents_used).toContain("oracle")
})
})
describe("session-manager storage - getMainSessions", () => {
beforeEach(() => {
if (existsSync(TEST_DIR)) {
rmSync(TEST_DIR, { recursive: true, force: true })
}
mkdirSync(TEST_DIR, { recursive: true })
mkdirSync(TEST_MESSAGE_STORAGE, { recursive: true })
mkdirSync(TEST_PART_STORAGE, { recursive: true })
mkdirSync(TEST_SESSION_STORAGE, { recursive: true })
mkdirSync(TEST_TODO_DIR, { recursive: true })
mkdirSync(TEST_TRANSCRIPT_DIR, { recursive: true })
})
afterEach(() => {
if (existsSync(TEST_DIR)) {
rmSync(TEST_DIR, { recursive: true, force: true })
}
})
function createSessionMetadata(
projectID: string,
sessionID: string,
opts: { parentID?: string; directory: string; updated: number }
) {
const projectDir = join(TEST_SESSION_STORAGE, projectID)
mkdirSync(projectDir, { recursive: true })
writeFileSync(
join(projectDir, `${sessionID}.json`),
JSON.stringify({
id: sessionID,
projectID,
directory: opts.directory,
parentID: opts.parentID,
time: { created: opts.updated - 1000, updated: opts.updated },
})
)
}
function createMessageForSession(sessionID: string, msgID: string, created: number) {
const sessionPath = join(TEST_MESSAGE_STORAGE, sessionID)
mkdirSync(sessionPath, { recursive: true })
writeFileSync(
join(sessionPath, `${msgID}.json`),
JSON.stringify({ id: msgID, role: "user", time: { created } })
)
}
test("getMainSessions returns only sessions without parentID", async () => {
// given
const projectID = "proj_abc123"
const now = Date.now()
createSessionMetadata(projectID, "ses_main1", { directory: "/test/path", updated: now })
createSessionMetadata(projectID, "ses_main2", { directory: "/test/path", updated: now - 1000 })
createSessionMetadata(projectID, "ses_child1", { directory: "/test/path", updated: now, parentID: "ses_main1" })
createMessageForSession("ses_main1", "msg_001", now)
createMessageForSession("ses_main2", "msg_001", now - 1000)
createMessageForSession("ses_child1", "msg_001", now)
// when
const sessions = await storage.getMainSessions({ directory: "/test/path" })
// then
expect(sessions.length).toBe(2)
expect(sessions.map((s) => s.id)).not.toContain("ses_child1")
})
test("getMainSessions sorts by time.updated descending (most recent first)", async () => {
// given
const projectID = "proj_abc123"
const now = Date.now()
createSessionMetadata(projectID, "ses_old", { directory: "/test/path", updated: now - 5000 })
createSessionMetadata(projectID, "ses_mid", { directory: "/test/path", updated: now - 2000 })
createSessionMetadata(projectID, "ses_new", { directory: "/test/path", updated: now })
createMessageForSession("ses_old", "msg_001", now - 5000)
createMessageForSession("ses_mid", "msg_001", now - 2000)
createMessageForSession("ses_new", "msg_001", now)
// when
const sessions = await storage.getMainSessions({ directory: "/test/path" })
// then
expect(sessions.length).toBe(3)
expect(sessions[0].id).toBe("ses_new")
expect(sessions[1].id).toBe("ses_mid")
expect(sessions[2].id).toBe("ses_old")
})
test("getMainSessions filters by directory (project path)", async () => {
// given
const projectA = "proj_aaa"
const projectB = "proj_bbb"
const now = Date.now()
createSessionMetadata(projectA, "ses_projA", { directory: "/path/to/projectA", updated: now })
createSessionMetadata(projectB, "ses_projB", { directory: "/path/to/projectB", updated: now })
createMessageForSession("ses_projA", "msg_001", now)
createMessageForSession("ses_projB", "msg_001", now)
// when
const sessionsA = await storage.getMainSessions({ directory: "/path/to/projectA" })
const sessionsB = await storage.getMainSessions({ directory: "/path/to/projectB" })
// then
expect(sessionsA.length).toBe(1)
expect(sessionsA[0].id).toBe("ses_projA")
expect(sessionsB.length).toBe(1)
expect(sessionsB[0].id).toBe("ses_projB")
})
test("getMainSessions returns all main sessions when directory is not specified", async () => {
// given
const projectA = "proj_aaa"
const projectB = "proj_bbb"
const now = Date.now()
createSessionMetadata(projectA, "ses_projA", { directory: "/path/to/projectA", updated: now })
createSessionMetadata(projectB, "ses_projB", { directory: "/path/to/projectB", updated: now - 1000 })
createMessageForSession("ses_projA", "msg_001", now)
createMessageForSession("ses_projB", "msg_001", now - 1000)
// when
const sessions = await storage.getMainSessions({})
// then
expect(sessions.length).toBe(2)
})
})
describe("session-manager storage - SDK path (beta mode)", () => {
const mockClient = {
session: {
list: mock(() => Promise.resolve({ data: [] })),
messages: mock(() => Promise.resolve({ data: [] })),
todo: mock(() => Promise.resolve({ data: [] })),
},
}
beforeEach(() => {
// Reset mocks
mockClient.session.list.mockClear()
mockClient.session.messages.mockClear()
mockClient.session.todo.mockClear()
})
test("getMainSessions uses SDK when beta mode is enabled", async () => {
// given
const mockSessions = [
{ id: "ses_1", directory: "/test", parentID: null, time: { created: 1000, updated: 2000 } },
{ id: "ses_2", directory: "/test", parentID: "ses_1", time: { created: 1000, updated: 1500 } },
]
mockClient.session.list.mockImplementation(() => Promise.resolve({ data: mockSessions }))
// Mock isSqliteBackend to return true
mock.module("../../shared/opencode-storage-detection", () => ({
isSqliteBackend: () => true,
resetSqliteBackendCache: () => {},
}))
// Re-import to get fresh module with mocked isSqliteBackend
const { setStorageClient, getMainSessions } = await import("./storage")
setStorageClient(mockClient as unknown as Parameters<typeof setStorageClient>[0])
// when
const sessions = await getMainSessions({ directory: "/test" })
// then
expect(mockClient.session.list).toHaveBeenCalled()
expect(sessions.length).toBe(1)
expect(sessions[0].id).toBe("ses_1")
})
test("getAllSessions uses SDK when beta mode is enabled", async () => {
// given
const mockSessions = [
{ id: "ses_1", directory: "/test", time: { created: 1000, updated: 2000 } },
{ id: "ses_2", directory: "/test", time: { created: 1000, updated: 1500 } },
]
mockClient.session.list.mockImplementation(() => Promise.resolve({ data: mockSessions }))
mock.module("../../shared/opencode-storage-detection", () => ({
isSqliteBackend: () => true,
resetSqliteBackendCache: () => {},
}))
const { setStorageClient, getAllSessions } = await import("./storage")
setStorageClient(mockClient as unknown as Parameters<typeof setStorageClient>[0])
// when
const sessionIDs = await getAllSessions()
// then
expect(mockClient.session.list).toHaveBeenCalled()
expect(sessionIDs).toEqual(["ses_1", "ses_2"])
})
test("readSessionMessages uses SDK when beta mode is enabled", async () => {
// given
const mockMessages = [
{
info: { id: "msg_1", role: "user", agent: "test", time: { created: 1000 } },
parts: [{ id: "part_1", type: "text", text: "Hello" }],
},
{
info: { id: "msg_2", role: "assistant", agent: "oracle", time: { created: 2000 } },
parts: [{ id: "part_2", type: "text", text: "Hi there" }],
},
]
mockClient.session.messages.mockImplementation(() => Promise.resolve({ data: mockMessages }))
mock.module("../../shared/opencode-storage-detection", () => ({
isSqliteBackend: () => true,
resetSqliteBackendCache: () => {},
}))
const { setStorageClient, readSessionMessages } = await import("./storage")
setStorageClient(mockClient as unknown as Parameters<typeof setStorageClient>[0])
// when
const messages = await readSessionMessages("ses_test")
// then
expect(mockClient.session.messages).toHaveBeenCalledWith({ path: { id: "ses_test" } })
expect(messages.length).toBe(2)
expect(messages[0].id).toBe("msg_1")
expect(messages[1].id).toBe("msg_2")
expect(messages[0].role).toBe("user")
expect(messages[1].role).toBe("assistant")
})
test("readSessionTodos uses SDK when beta mode is enabled", async () => {
// given
const mockTodos = [
{ id: "todo_1", content: "Task 1", status: "pending", priority: "high" },
{ id: "todo_2", content: "Task 2", status: "completed", priority: "medium" },
]
mockClient.session.todo.mockImplementation(() => Promise.resolve({ data: mockTodos }))
mock.module("../../shared/opencode-storage-detection", () => ({
isSqliteBackend: () => true,
resetSqliteBackendCache: () => {},
}))
const { setStorageClient, readSessionTodos } = await import("./storage")
setStorageClient(mockClient as unknown as Parameters<typeof setStorageClient>[0])
// when
const todos = await readSessionTodos("ses_test")
// then
expect(mockClient.session.todo).toHaveBeenCalledWith({ path: { id: "ses_test" } })
expect(todos.length).toBe(2)
expect(todos[0].content).toBe("Task 1")
expect(todos[1].content).toBe("Task 2")
expect(todos[0].status).toBe("pending")
expect(todos[1].status).toBe("completed")
})
test("SDK path returns empty array on error", async () => {
// given
mockClient.session.messages.mockImplementation(() => Promise.reject(new Error("API error")))
mock.module("../../shared/opencode-storage-detection", () => ({
isSqliteBackend: () => true,
resetSqliteBackendCache: () => {},
}))
const { setStorageClient, readSessionMessages } = await import("./storage")
setStorageClient(mockClient as unknown as Parameters<typeof setStorageClient>[0])
// when
const messages = await readSessionMessages("ses_test")
// then
expect(messages).toEqual([])
})
test("SDK path returns empty array when client is not set", async () => {
// given - beta mode enabled but no client set
mock.module("../../shared/opencode-storage-detection", () => ({
isSqliteBackend: () => true,
resetSqliteBackendCache: () => {},
}))
// Reset SDK client to ensure "client not set" case is exercised
const { setStorageClient } = await import("./storage")
setStorageClient(null as any)
// Re-import without setting client
const { readSessionMessages } = await import("./storage")
// when - calling readSessionMessages without client set
const messages = await readSessionMessages("ses_test")
// then - should return empty array since no client and no JSON fallback
expect(messages).toEqual([])
})
})