Function span

span(options: SpanOptions): void

Manually capture a span for non-LLM operations (retrieval, embedding, tool, etc.) Must be called within a trace() block.

Parameters

options: SpanOptions

Returns void

Example: Tool with toolCallId (links to parent LLM)

span({
  type: 'tool',
  name: 'query_database',
  toolCallId: 'tooluse_abc123',  // Links to LLM that requested this
  input: { sql: 'SELECT ...' },
  output: { rows: [...] },
  durationMs: 15,
});

Example: Retrieval without toolCallId

span({
  type: 'retrieval',
  name: 'pinecone-search',
  input: { topK: 5 },
  output: { count: 10 },
  durationMs: 50,
});