@factlayer/adapter-zep

A FactLayer adapter for Zep: pulls a user's graph facts, maps them to FactLayer facts, persists them locally (keyed by Zep's own edge uuid), and checks each one for freshness.

Install

bun add @factlayer/adapter-zep

Usage

import { createZepClient, scanZep } from "@factlayer/adapter-zep";

const client = createZepClient(process.env.ZEP_API_KEY!);
const results = await scanZep(client, "alice");
// each result: { fact, result: { status: "fresh" | "needs-verification", ... } }

Zep's bi-temporal fact model can flag an edge as no longer current via invalidAt or expiredAt. When either is present, this adapter maps it straight to the fact's expiresAt, so check() reports needs-verification immediately -- it never runs the category half-life math on a fact Zep has already flagged as outdated itself.

See the main repo for the full architecture, the freshness model, and how this adapter fits alongside @factlayer/core, @factlayer/cli, and @factlayer/mcp-server.