TypeScript SDK quickstart

npm install @sovara/runner @openai/agents zod
npm install --save-dev tsx

import { SovaraClient, trace } from "@sovara/runner"; 
import { Agent, run, tool } from "@openai/agents";
import { z } from "zod";

const sovara_client = new SovaraClient({ projectName: "weather-agent" }); 
const temperature = z.object({ celsius: z.number() });

const getZurichTemperature = tool({
  name: "get_zurich_temperature",
  description: "Return the demo temperature in Zurich in Celsius.",
  parameters: z.object({}),
  execute: async () => 22,
});

const getBostonTemperature = tool({
  name: "get_boston_temperature",
  description: "Return the demo temperature in Boston in Celsius.",
  parameters: z.object({}),
  execute: async () => 27,
});

const zurichAgent = new Agent({
  name: "Zurich weather agent",
  instructions: "Call the weather tool and return the temperature.",
  model: "gpt-5.4-mini",
  tools: [getZurichTemperature],
  outputType: temperature,
});

const bostonAgent = new Agent({
  name: "Boston weather agent",
  instructions: "Call the weather tool and return the temperature.",
  model: "gpt-5.4-mini",
  tools: [getBostonTemperature],
  outputType: temperature,
});

const chooseWarmerCity = trace( 
  async function chooseWarmerCity(zurich: number, boston: number): Promise<string> {
    if (zurich === boston) return `Boston and Zurich are equally warm at ${zurich} C.`;
    const city = zurich > boston ? "Zurich" : "Boston";
    return `${city} is warmer (${boston} C in Boston, ${zurich} C in Zurich).`;
  }, 
  { name: "choose warmer city" }, 
); 

async function main(): Promise<void> {
  const question = "Which city is warmer, Boston or Zurich?";
  await sovara_client.trace("compare city weather", async () => { 
    // Attach the user-visible request to the top-level trace.
    await sovara_client.logInput(question); 

    // Each subtrace groups one delegated agent's work into an expandable child trace.
    const zurich = await sovara_client.subtrace("Zurich weather agent", async () => { 
      const result = await run(zurichAgent, question);
      return result.finalOutput!.celsius;
    }); 

    const boston = await sovara_client.subtrace("Boston weather agent", async () => { 
      const result = await run(bostonAgent, question);
      return result.finalOutput!.celsius;
    }); 

    const answer = await chooseWarmerCity(zurich, boston);
    // Attach the final user-visible result to the top-level trace.
    await sovara_client.logOutput(answer); 
    console.log(answer);
  }); 
}

void main();

npx tsx weather_agent.ts