openclaw/extensions/migrate-hermes/provider.ts

// Migrate Hermes provider module implements model/runtime integration.
import type {
  MigrationPlan,
  MigrationProviderContext,
  MigrationProviderPlugin,
} from "openclaw/plugin-sdk/plugin-entry";
import { applyHermesPlan } from "./apply.js";
import { isMemoryOnlyMigration } from "./memory.js";
import { buildHermesPlan } from "./plan.js";
import { discoverHermesSource, hasHermesSource } from "./source.js";

export function buildHermesMigrationProvider(
  params: {
    runtime?: MigrationProviderContext["runtime"];
  } = {},
): MigrationProviderPlugin {
  return {
    id: "hermes",
    label: "Hermes",
    description: "Import Hermes config, memories, skills, and supported credentials.",
    supportedItemKinds: ["memory"],
    async detect(ctx) {
      const source = await discoverHermesSource(ctx.source);
      const found = isMemoryOnlyMigration(ctx)
        ? Boolean(source.memoryPath || source.userPath)
        : hasHermesSource(source);
      return {
        found,
        source: source.root,
        label: "Hermes",
        confidence: found ? "high" : "low",
        message: found ? "Hermes state found." : "Hermes state not found.",
      };
    },
    plan: buildHermesPlan,
    async apply(ctx, plan?: MigrationPlan) {
      return await applyHermesPlan({ ctx, plan, runtime: params.runtime });
    },
  };
}