Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
import { beforeEach, describe, expect, it, vi } from 'vitest'
import {
fetchAgentEvolutionStatus,
fetchExperiences,
searchExperiences,
setAgentEvolutionEnabled,
} from './api'
const { get, patch, post } = vi.hoisted(() => ({
get: vi.fn(),
patch: vi.fn(),
post: vi.fn(),
}))
vi.mock('#/lib/ov-client', () => ({
ovClient: { client: { get, patch, post } },
getOvResult: (result: unknown) => result,
isOvClientError: () => false,
}))
const experiencesUri = 'viking://user/default/memories/experiences'
const file = (name: string) => ({ name, uri: `${experiencesUri}/${name}` })
describe('experience listing server pagination', () => {
beforeEach(() => get.mockReset())
it('requests a page beyond the old 1000 limit with one lookahead entry', async () => {
get.mockResolvedValue([file('a.md'), file('b.md'), file('c.md')])
const result = await fetchExperiences({
experiencesUri,
page: 502,
pageSize: 2,
})
expect(get).toHaveBeenCalledWith(
expect.objectContaining({
url: '/api/v1/fs/ls',
query: expect.objectContaining({
offset: 1002,
limit: 3,
uri: experiencesUri,
}),
}),
)
expect(result.items.map((item) => item.name)).toEqual(['a.md', 'b.md'])
expect(result.hasMore).toBe(true)
expect(result).not.toHaveProperty('total')
})
it('does not skip lookahead records between pages', async () => {
get.mockResolvedValueOnce([file('a.md'), file('b.md'), file('c.md')])
get.mockResolvedValueOnce([file('c.md'), file('d.md')])
await fetchExperiences({ experiencesUri, page: 1, pageSize: 2 })
const last = await fetchExperiences({
experiencesUri,
page: 2,
pageSize: 2,
})
expect(get.mock.calls[1][0].query.offset).toBe(2)
expect(last.items.map((item) => item.name)).toEqual(['c.md', 'd.md'])
expect(last.hasMore).toBe(false)
})
it('applies pagination to raw entries before filtering out directories', async () => {
get.mockResolvedValue([
{ ...file('folder'), isDir: true },
file('a.md'),
file('b.md'),
])
const result = await fetchExperiences({
experiencesUri,
page: 1,
pageSize: 2,
})
expect(result.items.map((item) => item.name)).toEqual(['a.md'])
expect(result.hasMore).toBe(true)
})
it('allows an empty later page without inventing a total', async () => {
get.mockResolvedValue([])
const result = await fetchExperiences({
experiencesUri,
page: 3,
pageSize: 50,
})
expect(result).toEqual({ items: [], hasMore: false, page: 3, pageSize: 50 })
})
})
describe('experience search', () => {
beforeEach(() => post.mockReset())
it('searches the experience directory with find and returns direct files without pagination', async () => {
post.mockResolvedValue({
memories: [
{ uri: `${experiencesUri}/matching.md` },
{ uri: `${experiencesUri}/nested/other.md` },
{ uri: 'viking://user/other/memories/experiences/leak.md' },
],
})
const signal = new AbortController().signal
const result = await searchExperiences({
experiencesUri,
keyword: 'matching',
signal,
})
expect(post).toHaveBeenCalledWith({
url: '/api/v1/search/find',
body: {
query: 'matching',
target_uri: experiencesUri,
context_type: 'memory',
level: 2,
limit: 100,
},
signal,
})
expect(result).toEqual({
items: [file('matching.md')],
hasMore: false,
page: 1,
pageSize: 1,
})
})
})
describe('account-scoped evolution settings', () => {
beforeEach(() => {
get.mockReset()
patch.mockReset()
})
it('reads the selected account effective value instead of its override', async () => {
get.mockResolvedValue({
account_id: 'acme',
settings: { agent_evolution: { enabled: true } },
overrides: {},
})
const signal = new AbortController().signal
expect(await fetchAgentEvolutionStatus('acme', signal)).toEqual({
accountId: 'acme',
enabled: true,
})
expect(get).toHaveBeenCalledWith({
url: '/api/v1/admin/accounts/acme/settings',
signal,
})
await fetchAgentEvolutionStatus('other')
expect(get).toHaveBeenLastCalledWith({
url: '/api/v1/admin/accounts/other/settings',
signal: undefined,
})
})
it('patches only evolution for the selected account and reads the effective response', async () => {
patch.mockResolvedValue({
account_id: 'acme',
settings: { agent_evolution: { enabled: false }, acl: { enabled: true } },
})
expect(await setAgentEvolutionEnabled('acme', false)).toEqual({
accountId: 'acme',
enabled: false,
})
expect(patch).toHaveBeenCalledWith({
url: '/api/v1/admin/accounts/acme/settings',
body: { agent_evolution: { enabled: false } },
})
})
it('preserves the returned account so the UI can reject a scope mismatch', async () => {
get.mockResolvedValue({
account_id: 'default',
settings: { agent_evolution: { enabled: true } },
})
expect((await fetchAgentEvolutionStatus('acme')).accountId).toBe('default')
get.mockResolvedValue({ settings: { agent_evolution: { enabled: true } } })
expect((await fetchAgentEvolutionStatus('acme')).accountId).toBeUndefined()
})
})