Step usage

s.prompt("Hello").response("World").model("gpt-4o").end();

const s = r.step();

import { run } from "@contextcompany/custom";

const r = run();
const s = r.step();
// or with custom ID
const s2 = r.step("custom-step-id");

s.prompt(text);

s.prompt("You are a weather agent. The user asked: What is the weather in London?");

s.response(text);

s.response("The weather in London is 15°C and cloudy.");

const s = r.step();
s.prompt("You are a weather agent. The user asked: What is the weather in London?");

// --- Your LLM call ---
// ...
// --- End of LLM call ---

s.response("The weather in London is 15°C and cloudy.");
s.end();

s.model(name);
// or
s.model({ requested, used });

// Shorthand
s.model("gpt-4o");

// With requested and used
s.model({ requested: "gpt-4o", used: "gpt-4o-2024-08-06" });

s.tokens({ uncached, cached, completion });

s.tokens({
  uncached: 150,
  cached: 50,
  completion: 25,
});

s.cost(amount);

s.cost(0.0035);

s.finishReason(reason);

s.finishReason("stop");

s.toolDefinitions(definitions);

s.toolDefinitions('[{"name": "get_weather", "description": "Get the weather for a location"}]');

// Or as an array
s.toolDefinitions([
  { name: "get_weather", description: "Get the weather for a location" },
]);

s.error(statusMessage?);

import { run } from "@contextcompany/custom";

const r = run();
r.prompt("What is the weather in London?");

const s = r.step();
s.prompt("Calling weather API...");

try {
  const result = await callWeatherApi();
  s.response(result);
  s.end();
} catch (e) {
  s.error(String(e));
}

// Run still ends successfully even if a step fails
await r.end();

import { sendStep } from "@contextcompany/custom";

await sendStep({
  runId: "run_abc",
  prompt: JSON.stringify(messages),
  response: assistantContent,
  model: { requested: "gpt-4o", used: "gpt-4o-2024-08-06" },
  tokens: { uncached: 120, cached: 30, completion: 45 },
  cost: 0.0042,
  startTime: new Date(),
  endTime: new Date(),
});