npm install @getfoil/foil-js

import { Foil } from '@getfoil/foil-js';

const foil = new Foil({
  apiKey: 'your-api-key',
  agentName: 'my-agent',
  instrumentModules: { openAI: OpenAI },
});

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

  // LLM calls are auto-instrumented
  let response = 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 openai.chat.completions.create({
      model: 'gpt-4o', messages, tools,
    });
  }

  return response.choices[0].message.content;
});

// Vercel AI SDK
import { createVercelAICallbacks } from '@getfoil/foil-js';
const callbacks = createVercelAICallbacks(tracer);

pip install foil-sdk

from foil import Foil

foil = Foil(
    api_key='your-api-key',
    agent_name='my-agent',
)

def my_workflow(ctx):
    result = ctx.llm_call('gpt-4o', lambda _: openai.chat.completions.create(
        model='gpt-4o',
        messages=[{'role': 'user', 'content': 'Hello!'}],
    ))

    data = ctx.tool('search', lambda _: search_api(query))
    return result.choices[0].message.content

foil.trace(my_workflow, name='my-trace')

from openai import OpenAI
from foil import Foil

client = OpenAI()
foil = Foil(api_key='your-api-key')

wrapped = foil.wrap_openai(client)
response = wrapped.chat.completions.create(
    model='gpt-4o',
    messages=[{'role': 'user', 'content': 'Hello!'}]
)

# Environment variable (recommended)
export FOIL_API_KEY=sk_live_xxx_yyy