@escouade/graph-trace-file-exporter

Node.js file exporter for @escouade/graph-trace. Writes a TraceDocument as JSON to a resolved path, merging with any existing file so conversation runs accumulate in one place.

Filesystem coupling is assumed here (node:fs/promises / node:path) — the core stays runtime-agnostic. For another runtime (browser, OPFS, HTTP), implement the core TraceExporter<TraceDocument> port in a sibling package.

Install

npm install @escouade/graph-trace-file-exporter @escouade/graph-trace

Usage

import { TraceCollector } from '@escouade/graph-trace';
import { FileExporter } from '@escouade/graph-trace-file-exporter';

const collector = new TraceCollector({
  exporters: [
    new FileExporter({
      resolvePath: (doc) => `./traces/${doc.meta.traceId}.trace.json`,
    }),
  ],
});

Each run is merged into the existing file via mergeTraceDocuments. If the file is absent or corrupt, the run is written as-is. Files are written with mode 0o600.

API

FileExporterOptions

| Field | Type | Required | Description | | ------------- | ---------------------------------- | -------- | ------------------------------------------------- | | resolvePath | (trace: TraceDocument) => string | yes | Resolves the output path from the projected trace |

FileExporter

Implements TraceExporter<TraceDocument> from @escouade/graph-trace. Passed to TraceCollector as an exporter.

Resources

• @escouade/graph-trace core
• @escouade/graph-trace-langchain

License

MIT