@swarmvaultai/viewer

@swarmvaultai/viewer is the graph UI package for SwarmVault.

It powers swarmvault graph serve and renders state/graph.json as an interactive graph of sources, concepts, and entities.

What It Does

The viewer loads graph data from /api/graph and renders:

• source nodes
• concept nodes
• entity nodes
• extracted, inferred, conflicted, and stale edge states

Its main purpose is to support the SwarmVault runtime, but the package also exports lightweight types and helpers for custom integrations.

Package Use

import { fetchGraphArtifact } from "@swarmvaultai/viewer";

const graph = await fetchGraphArtifact("/api/graph");
console.log(graph.nodes.length);

Notes

• End users do not need to install this package separately to use swarmvault graph serve
• The CLI and engine bundle the built viewer assets for the normal install path

Development

pnpm build
pnpm lint
pnpm test

Links

• Website: https://www.swarmvault.ai
• Docs: https://www.swarmvault.ai/docs
• GitHub: https://github.com/swarmclawai/swarmvault