ElizaOS Agent Memory Integration

pnpm install @sovseal/sdk

import type { Plugin, IAgentRuntime, Memory, State } from "@elizaos/core";
import { AgentStateClient, EngineUnavailableError } from "@sovseal/sdk";

// store/recall need no endpoint/apiKey — they talk to the local native host.
const client = new AgentStateClient();

export const sovsealMemoryPlugin: Plugin = {
  name: "sovseal-memory",
  description: "Local-first, zero-knowledge persistent memory via sovseal.",

  // Provider: injects recalled context into the agent's state before it responds
  providers: [
    {
      name: "SOVSEAL_RECALL",
      get: async (runtime: IAgentRuntime, message: Memory, state?: State) => {
        try {
          const hits = await client.recall(String(message.content?.text ?? ""), { topK: 5 });
          return { text: hits.map((h) => h.text).join("\n"), values: {}, data: {} };
        } catch (err) {
          if (err instanceof EngineUnavailableError) {
            return { text: "", values: {}, data: {} }; // fail open
          }
          throw err;
        }
      },
    },
  ],

  // Action: lets the agent explicitly persist a fact
  actions: [
    {
      name: "STORE_MEMORY",
      description: "Persist a fact or user preference to local sovseal memory.",
      validate: async () => true,
      handler: async (runtime: IAgentRuntime, message: Memory) => {
        const content = String(message.content?.text ?? "");
        try {
          const result = await client.store(content);
          return { text: result.reinforced ? "Reinforced existing memory." : "Stored." };
        } catch (err) {
          if (err instanceof EngineUnavailableError) {
            return { text: `Memory engine unavailable (${err.reason}).` };
          }
          throw err;
        }
      },
    },
  ],
};

{
  "name": "SovereignAgent",
  "plugins": ["./src/plugins/sovseal-memory"]
}

import { AgentRuntime } from "@elizaos/core";
import { sovsealMemoryPlugin } from "./plugins/sovseal-memory";

export async function startAgent(runtime: AgentRuntime) {
  await runtime.registerPlugin(sovsealMemoryPlugin);
  console.log("sovseal memory plugin registered.");
}