Call your API from a tool

import { LuaTool, env } from 'lua-cli';
import { z } from 'zod';

export default class GetOrderStatusTool implements LuaTool {
  name = 'get_order_status';
  description =
    'Look up the shipping status of one order by order number. ' +
    'Use when a customer asks where an order is or when it will arrive.';
  inputSchema = z.object({
    orderNumber: z.string().regex(/^[A-Z]-\d{4,}$/).describe('Order number, for example A-1001'),
  });

  async execute(input: z.infer<typeof this.inputSchema>) {
    const baseUrl = env('ORDERS_API_URL');
    const apiKey = env('ORDERS_API_KEY');
    if (!baseUrl || !apiKey) throw new Error('ORDERS_API_URL and ORDERS_API_KEY are not set');

    const res = await fetch(`${baseUrl}/orders/${encodeURIComponent(input.orderNumber)}`, {
      headers: { Authorization: `Bearer ${apiKey}`, Accept: 'application/json' },
      signal: AbortSignal.timeout(10_000),
    });
    if (res.status === 404) return { found: false, orderNumber: input.orderNumber };
    if (!res.ok) throw new Error(`Orders API answered ${res.status} for ${input.orderNumber}`);

    const order = (await res.json()) as { status: string; carrier?: string; eta?: string };
    return { found: true, orderNumber: input.orderNumber, ...order };
  }
}

…
📄 Loaded environment variables from .env file
✅ Selected tool: get_order_status
Input: {
  "orderNumber": "A-1001"
}

🚀 Executing tool...
✅ Tool execution successful!

Tool returned: Object — fields: found, orderNumber, status, carrier, eta
Output:
{ found: true, orderNumber: 'A-1001', status: 'shipped', carrier: 'DHL', eta: '2026-09-15' }