Traces
Build and inspect run traces — complete records of agent execution.
buildTrace
Convert a run result into a structured trace:
import { buildTrace } from '@ahzan-agentforge/core';
const result = await agent.run({ task: 'Do something' });
const trace = buildTrace(result);RunTrace
interface RunTrace {
runId: string;
agentName: string;
status: RunStatus;
steps: StepRecord[];
summary: TraceSummary;
}TraceSummary
interface TraceSummary {
totalSteps: number;
totalTokens: number;
totalDuration: number;
inputTokens: number;
outputTokens: number;
toolCalls: number;
estimatedCostUsd: number;
}Accessing Traces
Traces are included in every RunResult:
const result = await agent.run({ task: 'Process data' });
console.log(result.trace.summary.totalTokens);
console.log(result.trace.summary.estimatedCostUsd);
console.log(result.trace.steps.length);Next Steps
- Formatting — human-readable trace output
- Replay — diff and replay runs