npm install @getfoil/foil-js

const { Foil } = require('@getfoil/foil-js');
const OpenAI = require('openai');

const foil = new Foil({
  apiKey: process.env.FOIL_API_KEY,
  agentName: 'my-agent',
});
const openai = new OpenAI();

const toolMap = {
  search: async (args) => searchAPI(args.query),
};

await foil.trace(async (ctx) => {
  const messages = [{ role: 'user', content: 'Search for recent AI news' }];

  // LLM call with function calling
  let response = await ctx.llmCall('gpt-4o', async () => {
    return await openai.chat.completions.create({
      model: 'gpt-4o', messages, tools,
    });
  });

  // Agentic loop — LLM decides which tools to call
  while (response.choices[0].message.tool_calls) {
    const toolMessages = await ctx.executeTools(response, toolMap);
    messages.push(response.choices[0].message, ...toolMessages);
    response = await ctx.llmCall('gpt-4o', async () => {
      return await openai.chat.completions.create({
        model: 'gpt-4o', messages, tools,
      });
    });
  }
}, { name: 'search-agent' });

await foil.shutdown();