Multi-agent setup

Share one database across agents with authority weights and cross-agent search.

Overview

Create all tables (claims, agent_authority, disputes)
Seed authority for entities that need domain trust
Set entityStrategies per entity
Share one vectorStore per process; rebuild when other processes write

Seed authority

import {
  Memory,
  seedAuthority,
  EXAMPLE_AUTHORITY_SEED,
  resolveVectorStore,
  search,
  resolveEmbed,
} from "vault-memory";

await seedAuthority(db, EXAMPLE_AUTHORITY_SEED);

EXAMPLE_AUTHORITY_SEED encodes scheduling vs chat weights on user.timezone and user.mood.

Two agents, one database

const vectorStore = resolveVectorStore({ db });
const embed = resolveEmbed({ apiKey: process.env.OPENAI_API_KEY });

const memoryA = new Memory("agent-a", {
  db,
  vectorStore,
  apiKey: process.env.OPENAI_API_KEY,
  entityStrategies: { "user.timezone": "authority" },
});

await memoryA.add([{ role: "user", content: "I'm in PST" }], "conv1");

// Another process or script:
await vectorStore.rebuild(db);

const memoryB = new Memory("agent-b", {
  db,
  vectorStore,
  apiKey: process.env.OPENAI_API_KEY,
  entityStrategies: { "user.timezone": "authority" },
});

const { added } = await memoryB.add(
  [{ role: "user", content: "I'm in EST" }],
  "conv1",
);
console.log(added[0]?.status); // "disputed" when agent-b has lower authority

Cross-agent search

await vectorStore.rebuild(db);

const results = await search(
  db,
  vectorStore,
  embed,
  "what timezone is the user in?",
  { status: "active", limit: 5 },
);
console.log(results[0]?.sourceAgent);

CLI demo

The monorepo includes a two-terminal demo. Full walkthrough: CLI demo.

cd apps/cli-agent
bun run start:agent-a   # terminal 1
bun run start:agent-b   # terminal 2

Try /search what timezone is the user in? after each agent stores a conflicting timezone.