TypeScript SDK

Create, interpret, query, and export user-owned memory graphs without binding the graph model to the dashboard UI.

package

@modifiervault/sdk-ts

project

modifiervault_beaconsmith_ethns_2026

schema

Local graph API

import { ModifierVault } from "@modifiervault/sdk-ts";

const vault = ModifierVault.local({ owner: "0xowner" });

const memory = await vault.createMemory({
  title: "Tradeoff delay",
  domain: "personal-cognition",
  contentMode: "plaintext",
  content: "I avoid decisions until I can model tradeoffs.",
});

const stack = await vault.attachModifierStack({
  memoryKey: memory.key,
  modifiers: ["route:strategy", "expand", "remember"],
  interpreter: "beaconsmith:v1",
  authority: "user",
  context: "Reuse this as a decision strategy.",
});

await vault.createReflection({
  memoryKey: memory.key,
  modifierStackKey: stack.key,
  lineageDepth: 0,
  model: "local-reflector",
  interpreter: "beaconsmith:v1",
  contentMode: "plaintext",
  reflection: "Delay preserves optionality until tradeoffs are visible.",
});

const graph = await vault.exportGraph(memory.key);

Arkiv live mode

// Live mode uses the same payload and attribute builders.
// Set NEXT_PUBLIC_MODIFIERVAULT_STORAGE=arkiv in the dashboard app.
// The app writes entities with:
// - project=modifiervault_beaconsmith_ethns_2026
// - schemaVersion=3
// - entityType
// - createdAt
// plus entity-specific query attributes.