Function describeModel

packages/core/src/describe.ts:24–96

(model: DescriptionInput)

}

export function describeModel(model: DescriptionInput) {
  const id = model.id ?? "";
  const name = model.name ?? humanizeID(id);
  const lab = labID(id, model.providerId);
  const target = `${id} ${name} ${model.family ?? ""}`.toLowerCase();
  const input = model.modalities?.input ?? [];
  const output = model.modalities?.output ?? [];
  const multimodal = input.some((value) => value !== "text");
  const fast = has(target, /\b(flash|lite|mini|nano|small|fast|highspeed|ultraspeed|instant|turbo|micro)\b/);
  const frontier = has(target, /\b(pro|opus|max|ultra|premier|large|frontier|maverick|behemoth|5\.5|5\.4|5\.3|4\.8|4\.7|4\.6|m3)\b/);
  const free = has(target, /(^|[^a-z])free([^a-z]|$)|:free\b/);
  const preview = model.status === "beta" || has(target, /\b(preview|beta|experimental)\b/);

  if (model.status === "deprecated") {
    return "Legacy model retained for compatibility with older integrations";
  }

  const special = specialDescription({
    id,
    lab,
    name,
    target,
    input,
    output,
    multimodal,
    fast,
    frontier,
    free,
    preview,
    model,
  });
  if (special !== undefined) return special;

  if (free) {
    return "Free provider route for experiments, demos, and cost-sensitive chat workloads";
  }

  if (preview) {
    return "Preview model for early access evaluation, prototyping, and compatibility testing";
  }

  if (model.reasoning === true) {
    if (fast) {
      return "Efficient reasoning model for fast analysis, coding help, and agent workflows";
    }
    if (frontier) {
      return "Flagship reasoning model for complex planning, coding, math, and tool use";
    }
    return "Reasoning model for deliberate analysis, multi-step problem solving, and tool use";
  }

  if (multimodal) {
    return "Multimodal model for analyzing text, images, documents, and rich media";
  }

  if (model.open_weights === true) {
    return "Open-weight instruction model for adaptable chat and self-hosted production workloads";
  }