AgentForge

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