Production AI Agents: Deterministic Tooling, Evals, and Structured Workflows

import { z } from 'zod';

export const QueryCustomerRecordsTool = {
  name: 'query_customer_records',
  description: 'Search customer database by verified organization ID and status filter.',
  parameters: z.object({
    organizationId: z.string().uuid({ message: 'Must be a valid UUID' }),
    status: z.enum(['active', 'trial', 'churned']),
    limit: z.number().int().min(1).max(50).default(10),
  }),
  execute: async (args: z.infer<typeof QueryCustomerRecordsTool.parameters>) => {
    try {
      const records = await db.customer.findMany({
        where: { orgId: args.organizationId, status: args.status },
        take: args.limit,
        select: { id: true, name: true, plan: true, mrr: true }
      });
      return { success: true, count: records.length, data: records };
    } catch (error) {
      // Return structured error context so the model can self-correct
      return { success: false, error: (error as Error).message, recoverable: true };
    }
  }
};