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 { RecallResourceType } from "../registries/recall-resource-types.js";
import type {
RecallTraceEntry,
RecallTraceSource,
} from "../recall-trace.js";
export type OpenVikingRecallTraceToolContext = {
sessionKey?: string;
sessionId?: string;
agentId?: string;
senderId?: string;
requesterSenderId?: string;
};
export type OpenVikingRecallTraceSession = {
sessionId?: string;
sessionKey?: string;
ovSessionId?: string;
agentId: string;
actorPeerId?: string;
};
export type RecallTraceToolInput = {
turn?: "latest" | "all";
traceId?: string;
sessionId?: string;
sessionKey?: string;
ovSessionId?: string;
source?: RecallTraceSource;
resourceTypes?: RecallResourceType[] | string;
since?: number;
until?: number;
includeContent?: boolean;
limit?: number;
};
export type RecallTraceToolResult = {
entries: RecallTraceEntry[];
lookupLayer: string;
warnings: string[];
};
export type OpenVikingRecallTraceToolsDeps = {
registerTool: (toolOrFactory: unknown, opts: { name: string }) => void;
queryRecallTraces: (
input: RecallTraceToolInput,
session: OpenVikingRecallTraceSession,
) => Promise<RecallTraceToolResult>;
formatRecallTraceText: (result: RecallTraceToolResult) => string;
resolvePluginSessionRouting: (
ctx?: OpenVikingRecallTraceToolContext,
) => OpenVikingRecallTraceSession;
isBypassedSession: (ctx?: OpenVikingRecallTraceToolContext) => boolean;
makeBypassedToolResult: (toolName: string) => unknown;
};
export function registerOpenVikingRecallTraceTools(
deps: OpenVikingRecallTraceToolsDeps,
): void {
deps.registerTool(
(ctx: OpenVikingRecallTraceToolContext) => ({
name: "ov_recall_trace",
label: "Recall Trace (OpenViking)",
description:
"Query OpenViking recall trace records captured by auto-recall and explicit recall/search tools.",
parameters: Type.Object({
turn: Type.Optional(Type.String({ description: "latest or all (default: latest)" })),
traceId: Type.Optional(Type.String({ description: "Exact trace id" })),
sessionId: Type.Optional(Type.String({ description: "OpenClaw session id" })),
sessionKey: Type.Optional(Type.String({ description: "OpenClaw session key" })),
ovSessionId: Type.Optional(Type.String({ description: "OpenViking session id" })),
source: Type.Optional(Type.String({ description: "auto_recall, memory_recall, ov_search, or ov_archive_search" })),
resourceTypes: Type.Optional(Type.Array(Type.String({ description: "resource, user, or agent" }))),
since: Type.Optional(Type.Number({ description: "Unix timestamp lower bound in milliseconds" })),
until: Type.Optional(Type.Number({ description: "Unix timestamp upper bound in milliseconds" })),
includeContent: Type.Optional(Type.Boolean({ description: "Read selected/displayed URI content previews on demand" })),
limit: Type.Optional(Type.Number({ description: "Maximum traces to return (default: 20)" })),
}),
async execute(_toolCallId: string, params: Record<string, unknown>) {
if (deps.isBypassedSession(ctx)) {
return deps.makeBypassedToolResult("ov_recall_trace");
}
const session = deps.resolvePluginSessionRouting(ctx);
const result = await deps.queryRecallTraces(params as RecallTraceToolInput, session);
return {
content: [{ type: "text" as const, text: deps.formatRecallTraceText(result) }],
details: {
action: "queried",
count: result.entries.length,
lookupLayer: result.lookupLayer,
warnings: result.warnings,
entries: result.entries,
},
};
},
}),
{ name: "ov_recall_trace" },
);
}