npm install @volcano.dev/agent

import { agent, llmOpenAI, mcp } from "@volcano.dev/agent";

const llm = llmOpenAI({ 
  apiKey: process.env.OPENAI_API_KEY!, 
  model: "gpt-4o-mini" 
});

const weather = mcp("http://localhost:8001/mcp");
const tasks = mcp("http://localhost:8002/mcp");

// Agent automatically picks the right tools
const results = await agent({ llm })
  .then({ 
    prompt: "What's the weather in Seattle? If it will rain, create a task to bring an umbrella",
    mcps: [weather, tasks]  // LLM chooses which tools to call
  })
  .run();

// Ask questions about what happened
const summary = await results.summary(llm);
console.log(summary);

import { agent, llmOpenAI } from "@volcano.dev/agent";

const llm = llmOpenAI({ apiKey: process.env.OPENAI_API_KEY! });

// Define specialized agents
const researcher = agent({ llm, name: 'researcher', description: 'Finds facts and data' })
  .then({ prompt: "Research the topic." })
  .then({ prompt: "Summarize the research." });

const writer = agent({ llm, name: 'writer', description: 'Creates content' })
  .then({ prompt: "Write content." });

// Coordinator autonomously delegates to specialists
const results = await agent({ llm })
  .then({
    prompt: "Write a blog post about quantum computing",
    agents: [researcher, writer]  // Coordinator decides when done
  })
  .run();

// Ask what happened
const post = await results.ask(llm, "Show me the final blog post");
console.log(post);