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 { boundContextSummary } from "@deepseek-ai/dsh-llm";
import { pluginMessage } from "./capture.mjs";
import { MCP_SERVER_NAME } from "./config.mjs";
import { addSkillExample, evaluateUriGuard, evaluateUriNotice, isSkillUri } from "./shared/uri-guard.mjs";
/** Model-facing name of a bridged OpenViking MCP tool. */
const mcp = rawName => `mcp__${MCP_SERVER_NAME}__${rawName}`;
const GUARDED_TOOLS = {
read: {
tool: mcp("read"),
example: uri => `${mcp("read")}(uris="${uri}")`,
},
glob: {
tool: mcp("list"),
example: uri => `${mcp("list")}(uri="${uri}")`,
},
grep: {
tool: mcp("grep"),
example: (uri, args) =>
`${mcp("grep")}(pattern="${escapeText(args?.pattern)}", uri="${uri}")`,
},
bash: {
tool: `${mcp("read")} or ${mcp("search")}`,
example: uri => `${mcp("read")}(uris="${uri}")`,
},
// On Windows DSH mounts `pwsh` in place of `bash`; its command line is also `command`.
pwsh: {
tool: `${mcp("read")} or ${mcp("search")}`,
example: uri => `${mcp("read")}(uris="${uri}")`,
},
edit: {
tool: uri => (isSkillUri(uri) ? mcp("add_skill") : mcp("edit")),
example: uri =>
isSkillUri(uri)
? addSkillExample(uri, { call: mcp("add_skill"), edited: true })
: `${mcp("edit")}(uri="${uri}", old_string="...", new_string="...")`,
},
write: {
tool: uri => (isSkillUri(uri) ? mcp("add_skill") : mcp("write")),
example: uri =>
isSkillUri(uri)
? addSkillExample(uri, { call: mcp("add_skill") })
: `${mcp("write")}(uri="${uri}", content="...")`,
},
str_replace_editor: {
tool: "the OpenViking MCP tools",
example: uri => `${mcp("read")}(uris="${uri}")`,
},
};
export async function guardVikingUri(exec, next) {
const decision = evaluateUriGuard(exec.name, exec.arguments, { hints: GUARDED_TOOLS });
if (!decision) return next();
return { kind: "deny", reason: decision.reason };
}
// Delegates first so a later listener's block or content replacement survives;
// the notice only rides along as one more context.
export async function noticeVikingUri(exec, _result, next) {
const notice = evaluateUriNotice(exec.name, exec.arguments, { hints: GUARDED_TOOLS });
if (!notice) return next();
const decision = await next();
const context = pluginMessage(notice.reason, {
form: "notice",
summary: boundContextSummary(`OpenViking URI guard: shell command contains ${notice.uri}`),
});
return {
...decision,
additionalContexts: [...(decision.additionalContexts ?? []), context],
};
}
function escapeText(value) {
return String(value || "").replaceAll('"', '\\"');
}