Conversational agents

[
  {
    "name": "kleep_recommend_size",
    "description": "Recommend a size for the shopper and a product of this store, using Kleep. Call it whenever the shopper asks which size to take, even if you don't know their measurements yet: the result tells you which questions to ask. Never guess a size yourself.",
    "input_schema": {
      "type": "object",
      "properties": {
        "product_id": { "type": "string", "description": "The store's product ID of the item discussed." },
        "gender": { "type": "string", "enum": ["female", "male"], "description": "Women's or men's sizes, if known." },
        "height_cm": { "type": "number" },
        "weight_kg": { "type": "number" },
        "age": { "type": "integer" },
        "body_shape": { "type": "object", "description": "Optional: stomach, hips (women), torso and thighs (men)." },
        "fit_preference": { "type": "string", "enum": ["fitted", "regular", "loose"] }
      },
      "required": ["product_id"]
    }
  },
  {
    "name": "kleep_product_sizing",
    "description": "Get how a product of this store fits (does it run small or large) and which sizes are in stock. Needs no information about the shopper.",
    "input_schema": {
      "type": "object",
      "properties": { "product_id": { "type": "string" } },
      "required": ["product_id"]
    }
  }
]

const KLEEP = 'https://fit.kleep.ai/v1';

async function kleep(path: string, retailer: string, body?: unknown) {
  const res = await fetch(KLEEP + path, {
    method: body ? 'POST' : 'GET',
    headers: {
      Authorization: `Bearer ${process.env.KLEEP_API_KEY}`,
      'Kleep-Retailer': retailer,
      'Content-Type': 'application/json',
    },
    body: body ? JSON.stringify(body) : undefined,
    signal: AbortSignal.timeout(8000),
  });
  return { status: res.status, data: await res.json() };
}

// Tool: kleep_recommend_size. `session` is your per-conversation storage.
export async function kleepRecommendSize(retailer, session, input) {
  const { product_id, fit_preference, ...measurements } = input;
  const shopper = session.kleepProfileId
    ? { profile_id: session.kleepProfileId, measurements }
    : { measurements, customer_id: session.customerId };
  const { status, data } = await kleep('/recommendations', retailer, {
    product_id, shopper, fit_preference, locale: session.locale, conversation_id: session.id,
  });

  if (status === 200) {
    session.kleepProfileId = data.profile_id;
    return data; // the model reads summary, size, alternatives
  }
  if (data.error?.code === 'missing_inputs') {
    return { ask_the_shopper: data.error.questions.map(q => q.prompt) };
  }
  if (data.error?.code === 'product_not_supported') {
    return { not_supported: 'Kleep cannot size this product. Use the size chart.' };
  }
  return { error: 'Size recommendation unavailable right now.' };
}