@swarmvaultai/viewer
v3.20.0
Published
Graph viewer package for SwarmVault graph artifacts.
Maintainers
Readme
@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, entities, agent tasks, and decisions.
What It Does
The viewer loads graph data from /api/graph and renders:
- source nodes
- concept nodes
- entity nodes
- agent task and decision nodes
- extracted, inferred, conflicted, and stale edge states
- the workflow rail for approvals, candidates, refresh state, lint findings, activity, and the Memory dashboard
- the vault workbench for prioritized doctor recommendations, full doctor checks, copyable suggested commands, safe repair, title/tag capture mode selection, budgeted context-pack creation, and task starts
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 testLinks
- Website: https://www.swarmvault.ai
- Docs: https://www.swarmvault.ai/docs
- GitHub: https://github.com/swarmclawai/swarmvault
