Check one costume character's stock at one size, across Target, Walmart, and Spirit Halloween

bowmark.costume_size_check.checkSize(args: { character: string; size: string }): Promise<CostumeSizeCheck>

interface RetailerSizeMatch {
  title: string
  url: string
  price: { amount: number; currency: string } | null
  inStock: boolean
}
interface RetailerSizeResult {
  matched: RetailerSizeMatch | null   // null + incomplete=false means this retailer
                                       // answered and has no listing in this size
  incomplete: boolean                 // true means this retailer's call never
                                       // answered — matched is NOT a stockout then
}
interface CostumeSizeCheck {
  character: string
  size: string
  retailers: { target: RetailerSizeResult; walmart: RetailerSizeResult; spirithalloween: RetailerSizeResult }
  warnings: string[]
}
type CallOptions = {
  timeoutMs?: number   // per-provider budget in ms, default 30000, clamped to 1000-55000.
                       // A provider slower than this is DROPPED from the results and
                       // NAMED in warnings — never silently absent
}

// A real live check — run this as-is to see genuine current stock.
const check = await bowmark.costume_size_check.checkSize({ character: "Rumi", size: "7-8" });
for (const [retailer, result] of Object.entries(check.retailers)) {
  if (result.incomplete) {
    log(`${retailer}: did not answer — unknown, not a stockout`);
  } else if (result.matched) {
    log(`${retailer}: ${result.matched.inStock ? "IN STOCK" : "sold out"} — ${result.matched.url}`);
  } else {
    log(`${retailer}: no listing in this size`);
  }
}
return check;