@verydia/devtools

Utilities and helpers for running Verydia agents and flows with telemetry, tone, guardrails, and traces.

Telemetry & traces

Use CollectingTelemetry in tests or scripts:

import { CollectingTelemetry } from "@verydia/devtools";

const telemetry = new CollectingTelemetry();

// Wire into FlowRuntimeDeps, then run a flow:
const { output } = await myFlow.run(input, { telemetry });

// Get all telemetry records:
const records = telemetry.getRecords();

Write a trace file:

import { writeTelemetryTraceJsonl } from "@verydia/devtools";

await writeTelemetryTraceJsonl(records, "trace.jsonl", { flowId: myFlow.id });

Summarize a trace:

import { summarizeFlowTrace } from "@verydia/devtools";

const summary = summarizeFlowTrace(records, myFlow.id);
// summary.nodeCount, summary.checkpoints, summary.routes, etc.

Traces are written as one JSON object per line (JSONL) and can be ingested by future UIs or external tools.