Traces & spans

const result = await ff.withTrace(
  async () => {
    const topic = await ai.messages.create({
      model: "claude-haiku-4-5",
      messages: [{ role: "user", content: "Suggest a haiku topic." }],
      firstflow: { userId, metadata: { step: "brainstorm" } },
    } as any);

    const poem = await ai.messages.create({
      model: "claude-haiku-4-5",
      messages: [{ role: "user", content: `Haiku about: ${topicText}` }],
      firstflow: { userId, metadata: { step: "write" } },
    } as any);

    return poem;
  },
  { name: "haiku_two_step", userId, metadata: { route: "/api/haiku" } },
);
// → one row in firstflow_traces, two in firstflow_llm_calls sharing its trace_id

select t.id, t.name, t.latency_ms, count(c.id) as calls,
       sum(c.total_cost_usd) as cost
from firstflow_traces t
left join firstflow_llm_calls c on c.trace_id = t.id
group by t.id;