Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

5.7 KB
Raw Blame
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" },
  );
}