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 { Type } from "@sinclair/typebox";
import type {
AddResourceInput,
AddResourceResult,
AddSkillInput,
AddSkillResult,
} from "../client.js";
export type OpenVikingImportToolContext = {
sessionKey?: string;
sessionId?: string;
agentId?: string;
senderId?: string;
requesterSenderId?: string;
};
export type OpenVikingImportSession = {
sessionId?: string;
sessionKey?: string;
ovSessionId?: string;
agentId: string;
actorPeerId?: string;
};
export type OpenVikingImportClient = {
addResource: (input: AddResourceInput, agentId?: string) => Promise<AddResourceResult>;
addSkill: (input: AddSkillInput, agentId?: string) => Promise<AddSkillResult>;
};
export type OpenVikingImportToolsDeps = {
registerTool: (toolOrFactory: unknown, opts: { name: string }) => void;
getClient: () => Promise<OpenVikingImportClient>;
resolvePluginSessionRouting: (ctx?: OpenVikingImportToolContext) => OpenVikingImportSession;
isBypassedSession: (ctx?: OpenVikingImportToolContext) => boolean;
makeBypassedToolResult: (toolName: string) => unknown;
enableAddResourceTool: boolean;
};
function formatResourceImportText(result: AddResourceResult): string {
const root = result.root_uri ? ` ${result.root_uri}` : "";
const warnings = result.warnings?.length ? ` Warnings: ${result.warnings.join("; ")}` : "";
return `Imported OpenViking resource.${root}${warnings}`.trim();
}
function formatSkillImportText(result: AddSkillResult): string {
const uri = result.uri ? ` ${result.uri}` : "";
const name = result.name ? ` (${result.name})` : "";
return `Imported OpenViking skill${name}.${uri}`.trim();
}
export function registerOpenVikingImportTools(deps: OpenVikingImportToolsDeps): void {
if (deps.enableAddResourceTool) {
deps.registerTool(
(ctx: OpenVikingImportToolContext) => ({
name: "add_resource",
label: "Add Resource (OpenViking)",
description:
"Use only when the user explicitly asks to import, add, upload, save, or index a document, directory, URL, Git repository, or OpenClaw media attachment into OpenViking resources. " +
"Never use this during search, retrieval, URI reading, or search-result optimization; use ov_search and ov_read for those flows. " +
"For a '[media attached: /path ...]' document, set source to that exact local media path. Do not invent OpenViking upload REST endpoints.",
parameters: Type.Object({
source: Type.String({ description: "Local path, OpenClaw media attachment path, directory path, public URL, or Git URL" }),
to: Type.Optional(Type.String({ description: "Exact target URI, e.g. viking://resources/project-docs" })),
parent: Type.Optional(Type.String({ description: "Parent URI under viking://resources" })),
reason: Type.Optional(Type.String({ description: "Reason or note for adding this resource" })),
instruction: Type.Optional(Type.String({ description: "Processing instruction for semantic extraction" })),
wait: Type.Optional(Type.Boolean({ description: "Wait for processing to complete" })),
}),
async execute(_toolCallId: string, params: Record<string, unknown>) {
if (deps.isBypassedSession(ctx)) {
return deps.makeBypassedToolResult("add_resource");
}
const session = deps.resolvePluginSessionRouting(ctx);
const client = await deps.getClient();
const result = await client.addResource({
pathOrUrl: typeof params.source === "string" ? params.source : "",
to: typeof params.to === "string" ? params.to : undefined,
parent: typeof params.parent === "string" ? params.parent : undefined,
reason: typeof params.reason === "string" ? params.reason : undefined,
instruction: typeof params.instruction === "string" ? params.instruction : undefined,
wait: typeof params.wait === "boolean" ? params.wait : undefined,
}, session.actorPeerId);
return {
content: [{ type: "text" as const, text: formatResourceImportText(result) }],
details: {
action: "resource_imported",
...result,
},
};
},
}),
{ name: "add_resource" },
);
}
deps.registerTool(
(ctx: OpenVikingImportToolContext) => ({
name: "add_skill",
label: "Add Skill (OpenViking)",
description:
"Use only when the user explicitly asks to import, add, install, or register a skill into OpenViking. " +
"Set source to a local SKILL.md file or skill directory, or data to raw SKILL.md content or an MCP tool dict.",
parameters: Type.Object({
source: Type.Optional(Type.String({ description: "Local SKILL.md path or skill directory path" })),
data: Type.Optional(Type.Any({ description: "Raw SKILL.md content or MCP tool dict" })),
wait: Type.Optional(Type.Boolean({ description: "Wait for processing to complete" })),
}),
async execute(_toolCallId: string, params: Record<string, unknown>) {
if (deps.isBypassedSession(ctx)) {
return deps.makeBypassedToolResult("add_skill");
}
const session = deps.resolvePluginSessionRouting(ctx);
const client = await deps.getClient();
const result = await client.addSkill({
path: typeof params.source === "string" ? params.source : undefined,
data: params.data,
wait: typeof params.wait === "boolean" ? params.wait : undefined,
}, session.actorPeerId);
return {
content: [{ type: "text" as const, text: formatSkillImportText(result) }],
details: {
action: "skill_imported",
...result,
},
};
},
}),
{ name: "add_skill" },
);
}