import { Engine } from "@shiro-sdk/core";

const engine = new Engine({ events: traces /* optional services */ });
engine.use(plugin);
engine.registerAgent(agent);
engine.start(); // usually implicit on first execute
const result = await engine.execute(agent, input, options);
engine.stop();

import { Agent } from "@shiro-sdk/core";

new Agent({
  name: "support",
  instructions: "...",
  provider: "openai", // required: id or Provider instance
  tools: [...],
  output: schema, // optional .parse()
  handoff: strategy, // optional HandoffStrategy
});

Agent.builder().name("support").provider("openai").build();

import { tool } from "@shiro-sdk/core";

tool({
  name: "lookupInvoice",
  description: "...",
  parameters: schema, // required, must implement .parse()
  requiresApproval: true, // optional
  execute: async (input, context) => result,
});

import { OpenAIPlugin } from "@shiro-sdk/openai";

engine.use(
  new OpenAIPlugin({
    apiKey: process.env.OPENAI_API_KEY!,
    model: "gpt-5",
  })
);

import { JsonTraceExporter, TraceManager } from "@shiro-sdk/core";

const traces = new TraceManager();
const engine = new Engine({ events: traces });
await engine.execute(agent, input);
await traces.export(new JsonTraceExporter());

result.runId;
result.output;
result.messages;
result.finishReason;
result.context;