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 test from "node:test";
import assert from "node:assert/strict";
import { OVClient } from "../client.ts";
function makeClient() {
return new OVClient({
endpoint: "http://127.0.0.1:1933",
apiKey: "",
account: "",
user: "",
authMode: "trusted",
sendIdentityHeaders: false,
peerId: "",
userAgent: "test",
});
}
async function withFetch(handler, fn) {
const original = globalThis.fetch;
const calls = [];
globalThis.fetch = async (url, init) => {
calls.push({ url: String(url), init });
const value = await handler(url, init);
return new Response(JSON.stringify(value.body), {
status: value.status ?? 200,
headers: { "content-type": "application/json" },
});
};
try {
return await fn(calls);
} finally {
globalThis.fetch = original;
}
}
test("readArchiveOverview reads only the requested archive and strips OKF frontmatter", async () => {
await withFetch(async () => ({
body: { status: "ok", result: "---\ntitle: archive\n---\n\n# Working Memory\nbody\n" },
}), async (calls) => {
const uri = "viking://user/u/sessions/s/history/archive_007";
assert.equal(await makeClient().readArchiveOverview(uri), "# Working Memory\nbody\n");
assert.equal(calls.length, 1);
assert.ok(calls[0].url.includes(encodeURIComponent(`${uri}/.overview.md`)));
});
});
test("readArchiveOverview treats 404 and empty bodies as not ready", async () => {
await withFetch(async () => ({ status: 404, body: { status: "error", error: { message: "missing" } } }), async () => {
assert.equal(await makeClient().readArchiveOverview("viking://archive/1"), null);
});
await withFetch(async () => ({ body: { status: "ok", result: "---\ntitle: empty\n---\n\n" } }), async () => {
assert.equal(await makeClient().readArchiveOverview("viking://archive/1"), null);
});
});
test("readArchiveOverview surfaces non-404 read failures", async () => {
await withFetch(async () => ({ status: 500, body: { status: "error", error: { message: "storage failed" } } }), async () => {
await assert.rejects(
() => makeClient().readArchiveOverview("viking://archive/1"),
/archive overview read failed: storage failed/,
);
});
});
test("getArchiveState reads the server's terminal markers for one archive", async () => {
const archive = "viking://user/u/sessions/s/history/archive_003";
const files = new Map();
await withFetch(async (url) => {
const uri = new URL(String(url)).searchParams.get("uri");
if (uri === "viking://user/u/sessions/broken/history/archive_001/.done") {
return { status: 500, body: { status: "error", error: { code: "INTERNAL", message: "boom" } } };
}
return files.has(uri)
? { body: { status: "ok", result: files.get(uri) } }
: { status: 404, body: { status: "error", error: { code: "NOT_FOUND", message: "missing" } } };
}, async (calls) => {
const client = makeClient();
assert.equal(await client.getArchiveState(archive), "pending");
files.set(`${archive}/.failed.json`, "{\"error\":\"llm\"}");
assert.equal(await client.getArchiveState(archive), "failed");
files.set(`${archive}/.done`, "{\"enable_working_memory\":false}");
assert.equal(await client.getArchiveState(`${archive}/`), "completed");
assert.equal(await client.getArchiveState("viking://user/u/sessions/broken/history/archive_001"), null);
assert.equal(await client.getArchiveState(""), null);
assert.match(calls[0].url, /content\/read\?uri=.*archive_003%2F\.done$/);
});
});
for (const enabled of [true, false, undefined]) {
test(`commitSessionResponse sends enable_working_memory=${enabled}`, async () => {
await withFetch(async () => ({
body: { status: "ok", result: { effective_enable_working_memory: enabled ?? false } },
}), async (calls) => {
const response = await makeClient().commitSessionResponse("s", 3, 5000, enabled);
assert.equal(response.result.effective_enable_working_memory, enabled ?? false);
assert.deepEqual(JSON.parse(calls[0].init.body), {
keep_recent_count: 3,
...(enabled === undefined ? {} : { enable_working_memory: enabled }),
});
});
});
}