Sync agent

Use this when your agent function is synchronous — no async/await, no streaming.

TypeScript
Python

import { registerOTel, wrapAgent } from "@uselemma/tracing";

registerOTel();

const wrapped = wrapAgent("my-agent", ({ onComplete }, input: { userMessage: string }) => {
  const response = callLLMSync(input.userMessage);
  onComplete(response);
  return response;
});

const { result, runId } = await wrapped({ userMessage });

Even if the wrapped logic is synchronous, wrapAgent returns an async function in TypeScript, so the call site still uses await.

from uselemma_tracing import register_otel, TraceContext, wrap_agent

register_otel()


def run_agent(ctx: TraceContext, user_message: str) -> str:
    response = call_llm(user_message)  # synchronous LLM call
    ctx.on_complete(response)
    return response


wrapped = wrap_agent("my-agent", run_agent)

# Call synchronously — no await
result, run_id, _ = wrapped(user_message)

wrap_agent detects that run_agent is a regular function and returns a synchronous wrapper. The call site does not use await.

onComplete(response) / ctx.on_complete(response) records the output explicitly. You can also omit it and rely on the return value being captured automatically.

Metrics

Tracing