Completions & Streaming

const res = await theo.complete({
  prompt: "Explain microservices architecture",
  mode: "auto",           // or "fast", "think", "code", "research", etc.
  skills: ["deep-research"],
  conversation_id: "conv_abc123",  // optional — continue a conversation
  persona: { system_prompt: "You are a senior architect..." },
  tools: [/* inline tool definitions */],
  temperature: 0.7,
  max_iterations: 8,
  metadata: { source: "my-app" },
});

console.log(res.content);          // Generated text
console.log(res.model.label);      // "Theo Reason"
console.log(res.resolved_mode);    // "think"
console.log(res.tools_used);       // [{ name: "...", status: "success" }]
console.log(res.usage.cost_cents); // 0.15

for await (const event of theo.stream({ prompt: "Write a poem" })) {
  switch (event.type) {
    case "meta":  console.log("Mode:", (event.data as any).resolved_mode); break;
    case "token": process.stdout.write(event.token!); break;
    case "tool":  console.log("Tool:", (event.data as any).name); break;
    case "done":  console.log("\nDone"); break;
  }
}