Added value: +{
+  "description": "Quantos desses pets estão disponíveis para adoção (status 'available'). É o número do título do catálogo; use este, não `total`, ao dizer quantos pets há para adotar.",
+  "title": "Available Total",
+  "type": "integer"
+}

Previous value: -[
-  "total",
-  "page",
-  "pets"
-]New value: +[
+  "total",
+  "available_total",
+  "page",
+  "pets"
+]

Previous value: -"Raça: slug ('golden-retriever') ou nome em português ('pastor alemão'). A maioria do catálogo é SRD (sem raça definida). Use a listagem de raças para ver as raças com pets hoje."New value: +"Raça: slug ('golden-retriever') ou nome em português ('pastor alemão'). A maioria do catálogo é SRD (sem raça definida)."

Previous value: -"Nome do MUNICÍPIO por extenso, não do bairro nem abreviado: 'Belo Horizonte', não 'BH'. Acento é opcional. Se o nome for ambíguo, ou se nenhuma ONG tiver pets ali hoje, o erro explica o que fazer — leia e siga; não significa que a cidade não exista."New value: +"Nome do MUNICÍPIO por extenso, não do bairro nem abreviado: 'Belo Horizonte', não 'BH'. Acento é opcional. Se o nome for ambíguo, ou se nenhuma ONG tiver pets ali hoje, o erro explica o que corrigir; isso não significa que a cidade não exista."

Previous value: -"Sem efeito no momento: o catálogo devolve os pets anunciados em qualquer data, independente deste parâmetro. Mantido por compatibilidade. Não prometa à pessoa que um resultado é recente — confira a data do anúncio."New value: +"Sem efeito no momento: o catálogo devolve os pets anunciados em qualquer data, independente deste parâmetro. Mantido por compatibilidade. Um resultado pode ser antigo: `days_without_update`, quando vem, diz há quanto tempo."

Previous value: -"Nome do pet como a pessoa escreveu ('nina', 'bebe'). Acentos e maiúsculas não importam; erros de grafia geralmente NÃO são encontrados. Leia `name_match.confidence` antes de afirmar de qual pet se trata. Se a lista vier vazia, diga que não achou e pergunte como se escreve."New value: +"Nome do pet como a pessoa escreveu ('nina', 'bebe'). Acentos e maiúsculas não importam; erros de grafia geralmente NÃO são encontrados. `name_match.confidence` diz quão certo é o pet encontrado. Se a lista vier vazia, o nome não foi encontrado como escrito."

Previous value: -"true devolve somente pets castrados. `false` é IGNORADO pelo mesmo motivo de `vaccinated`; leia `neutered` na ficha do pet."New value: +"true devolve somente pets castrados. `false` é IGNORADO pelo mesmo motivo de `vaccinated`; o valor de cada pet está em `neutered`."

Previous value: -"Restringe a busca a UMA ONG ou protetor: o código curto do link ou o @ do Instagram, como devolvidos pela busca de ONGs. Combina com os outros filtros ('gatos filhotes desta ONG'). Sem ele a busca cobre o catálogo inteiro."New value: +"Restringe a busca a UMA ONG ou protetor: o código curto do link ou o @ do Instagram da ONG. Combina com os outros filtros ('gatos filhotes desta ONG'). Sem ele a busca cobre o catálogo inteiro."

Previous value: -"true devolve somente pets vacinados. `false` é IGNORADO: a maioria dos anúncios não informa vacinação, então filtrar por 'não vacinado' esconderia quase todo o catálogo. Para saber de um pet específico, leia `vaccinated` na ficha (null = a ONG não informou)."New value: +"true devolve somente pets vacinados. `false` é IGNORADO: a maioria dos anúncios não informa vacinação, então filtrar por 'não vacinado' esconderia quase todo o catálogo. O valor de cada pet está em `vaccinated` (null = a ONG não informou)."

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Amplia a busca em volta de `city`: 'city'/'cidade' (padrão, só a cidade), 'neighbors'/'vizinhas' (mais as cidades que fazem divisa) ou 'radius'/'raio' (mais as cidades a até `radius_km` km). Resultados: a cidade primeiro, depois as vizinhas, depois o resto. Não combina com `name`.",
+  "title": "Area"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Raio em km (1 a 100) para `area=radius`. Mandar só `radius_km` já significa raio.",
+  "title": "Radius Km"
+}

Added value: +{
+  "default": false,
+  "description": "Se a área pedida não tiver pets disponíveis com os filtros, amplia a partir dela: cidades vizinhas, depois raio de 50 km, depois 100 km, parando no primeiro passo com pets. `searched_area` diz o que foi usado.",
+  "title": "Widen If Empty",
+  "type": "boolean"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Distância em km entre o centro da cidade do pet e o da cidade buscada (0 = a própria cidade). Só vem quando a busca usou `area` ou `widen_if_empty`.",
+  "title": "Distance Km"
+}

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/AgentSearchedArea"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "A área que a busca realmente cobriu. Se `widened` for true, os pets não são da cidade pedida: diga isso antes de listá-los."
+}

Added value: +{
+  "description": "The area the pet search actually ran — after any automatic widening.",
+  "properties": {
+    "area": {
+      "description": "Área usada: 'city' (só a cidade), 'neighbors' (a cidade e as que fazem divisa com ela) ou 'radius' (também as cidades a até `radius_km`).",
+      "enum": [
+        "city",
+        "neighbors",
+        "radius"
+      ],
+      "title": "Area",
+      "type": "string"
+    },
+    "cities": {
+      "description": "Quantas cidades a área cobriu (0 = busca sem cidade).",
+      "title": "Cities",
+      "type": "integer"
+    },
+    "radius_km": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Raio em km quando `area` é 'radius'; senão null.",
+      "title": "Radius Km"
+    },
+    "widened": {
+      "description": "true quando a cidade não tinha pets e a busca foi ampliada sozinha (widen_if_empty). Diga isso à pessoa e cite a cidade de cada pet.",
+      "title": "Widened",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "area",
+    "radius_km",
+    "widened",
+    "cities"
+  ],
+  "title": "AgentSearchedArea",
+  "type": "object"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Só quando status='adopted': 'announced' (a ONG anunciou) ou 'unlisted' (o post saiu do ar e a ONG confirma isso como adoção). null nos demais status.",
+  "title": "Adoption Evidence"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Link para falar com a ONG sobre este pet: abre uma página da Adoteca que leva ao post original no Instagram. Mostre este link ao indicar contato.",
+  "title": "Contact Url"
+}

Previous value: -"Perfil oficial da ONG no Instagram."New value: +"Perfil oficial da ONG no Instagram. Para indicar contato, mostre contact_url."

Previous value: -"'available', 'adopted', 'deceased' ou 'source_gone' (posts apagados, desfecho incerto). Nunca ofereça um pet que não esteja 'available'. E 'available' não confirma que o pet continua esperando: diz só que ninguém sinalizou mudança. Leia `days_without_update` antes de afirmar que está disponível."New value: +"'available', 'adopted', 'deceased' ou 'source_gone' (post original saiu do ar: pode ter sido adotado; confirme com o protetor). Nunca ofereça um pet que não esteja 'available'. 'available' só diz que ninguém sinalizou mudança: leia `days_without_update` antes de afirmar que está disponível."

Previous value: -"'available', 'adopted' ou 'deceased'. Nunca ofereça um pet que não esteja 'available'. E 'available' não confirma que o pet continua esperando: diz só que ninguém sinalizou mudança. Leia `days_without_update` antes de afirmar que está disponível."New value: +"'available', 'adopted', 'deceased' ou 'source_gone' (posts apagados, desfecho incerto). Nunca ofereça um pet que não esteja 'available'. E 'available' não confirma que o pet continua esperando: diz só que ninguém sinalizou mudança. Leia `days_without_update` antes de afirmar que está disponível."

Previous value: -"Código curto do pet (o mesmo de www.adoteca.com.br/p/{code})."New value: +"Código curto do pet (o mesmo de adoteca.com.br/p/{code})."

Previous value: -"Código curto do pet (o mesmo de adoteca.com.br/p/{code})."New value: +"Código curto do pet (o mesmo de www.adoteca.com.br/p/{code})."

Added value: +false

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Dias desde a última notícia nova sobre este pet (publicação da ONG ou sinal de adoção). null = desfecho confirmado ou data desconhecida. Passado um mês, diga que nada novo chegou desde então e que o pet pode ou não continuar disponível; quem confirma é quem cuida dele.",
+  "title": "Days Without Update"
+}

Previous value: -"'available', 'adopted' ou 'deceased'. Nunca ofereça um pet que não esteja 'available'."New value: +"'available', 'adopted' ou 'deceased'. Nunca ofereça um pet que não esteja 'available'. E 'available' não confirma que o pet continua esperando: diz só que ninguém sinalizou mudança. Leia `days_without_update` antes de afirmar que está disponível."

Previous value: -"Idade máxima em meses. O catálogo só distingue três faixas — filhote (até 12 meses), adulto (12 a 96) e idoso (96+) — então 6 e 12 selecionam os mesmos pets."New value: +"Idade máxima em meses. O catálogo só distingue três faixas — filhote, adulto e idoso — então sem porte 6 e 12 selecionam os mesmos pets. Os cortes mudam com espécie e porte: idoso a partir de 8 anos no cão grande, 9 no médio, 10 no pequeno e no gato."

Previous value: -"Por padrão só devolvemos pets anunciados nos últimos 90 dias, para não oferecer pets que provavelmente já foram adotados. Só ative se a pessoa pedir explicitamente anúncios antigos. Buscar por `name` já ignora essa janela de 90 dias: quem pergunta pelo nome já sabe que o pet existe."New value: +"Sem efeito no momento: o catálogo devolve os pets anunciados em qualquer data, independente deste parâmetro. Mantido por compatibilidade. Não prometa à pessoa que um resultado é recente — confira a data do anúncio."

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "null = a ONG não informou.",
+  "title": "Dewormed"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "'aceita lar temporário' ou 'precisa de lar temporário'. Muda o que se pede à pessoa: não é adoção definitiva. null = não classificado.",
+  "title": "Foster Status"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "null = a ONG não informou.",
+  "title": "Good With Cats"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "null = a ONG não informou.",
+  "title": "Good With Dogs"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "null = a ONG não informou.",
+  "title": "Good With Kids"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "null = a ONG não informou.",
+  "title": "Microchipped"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "null = a ONG não informou. Nunca afirme 'não castrado' quando for null.",
+  "title": "Neutered"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "null = a ONG não informou. Nunca afirme 'não vacinado' quando for null.",
+  "title": "Vaccinated"
+}

Removed value: -{
-  "anyOf": [
-    {
-      "type": "boolean"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "true devolve somente pets que aceitam ou precisam de lar temporário. `false` é IGNORADO: a maioria dos anúncios não fala em lar temporário.",
-  "title": "Foster"
-}

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "true devolve somente pets que aceitam ou precisam de lar temporário. `false` é IGNORADO: a maioria dos anúncios não fala em lar temporário.",
+  "title": "Foster"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Restringe a busca a UMA ONG ou protetor: o código curto do link ou o @ do Instagram, como devolvidos pela busca de ONGs. Combina com os outros filtros ('gatos filhotes desta ONG'). Sem ele a busca cobre o catálogo inteiro.",
+  "title": "Rescuer"
+}

Removed value: -{
-  "properties": {
-    "instagram_url": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "description": "Perfil oficial da ONG no Instagram.",
-      "title": "Instagram Url"
-    },
-    "name": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "description": "Nome da ONG ou protetor responsável pelo pet.",
-      "title": "Name"
-    }
-  },
-  "required": [
-    "name",
-    "instagram_url"
-  ],
-  "title": "AgentNgo",
-  "type": "object"
-}

Removed value: -{
-  "$ref": "#/$defs/AgentNgo",
-  "description": "Quem cuida do pet."
-}

Added value: +{
+  "$ref": "#/$defs/AgentRescuer",
+  "description": "Quem cuida do pet."
+}

Previous value: -[
-  "short_code",
-  "name",
-  "species",
-  "sex",
-  "size",
-  "breed",
-  "age",
-  "age_category",
-  "city",
-  "status",
-  "photo_url",
-  "adoption_url",
-  "ngo"
-]New value: +[
+  "short_code",
+  "name",
+  "species",
+  "sex",
+  "size",
+  "breed",
+  "age",
+  "age_category",
+  "city",
+  "status",
+  "photo_url",
+  "adoption_url",
+  "rescuer"
+]

Added value: +{
+  "properties": {
+    "instagram_url": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Perfil oficial da ONG no Instagram.",
+      "title": "Instagram Url"
+    },
+    "name": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Nome da ONG ou protetor responsável pelo pet.",
+      "title": "Name"
+    }
+  },
+  "required": [
+    "name",
+    "instagram_url"
+  ],
+  "title": "AgentRescuer",
+  "type": "object"
+}

Previous value: -"Por padrão só devolvemos pets anunciados nos últimos 90 dias, para não oferecer pets que provavelmente já foram adotados. Só ative se a pessoa pedir explicitamente anúncios antigos."New value: +"Por padrão só devolvemos pets anunciados nos últimos 90 dias, para não oferecer pets que provavelmente já foram adotados. Só ative se a pessoa pedir explicitamente anúncios antigos. Buscar por `name` já ignora essa janela de 90 dias: quem pergunta pelo nome já sabe que o pet existe."

Previous value: -"Quantos resultados devolver por página. Valores acima de 24 são reduzidos a 24."New value: +"Quantos resultados devolver por página. Valores acima de 24 são reduzidos a 24. Buscar por `name` devolve no máximo 5: é uma lista para confirmar, não para navegar."

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Nome do pet como a pessoa escreveu ('nina', 'bebe'). Acentos e maiúsculas não importam; erros de grafia geralmente NÃO são encontrados. Leia `name_match.confidence` antes de afirmar de qual pet se trata. Se a lista vier vazia, diga que não achou e pergunte como se escreve.",
+  "title": "Name"
+}

Added value: +{
+  "properties": {
+    "confidence": {
+      "description": "'high' = é este pet: afirme direto. 'low' = NÃO afirme qual é; mostre os pets da lista e pergunte qual deles.",
+      "enum": [
+        "high",
+        "low"
+      ],
+      "title": "Confidence",
+      "type": "string"
+    },
+    "query": {
+      "description": "O nome que foi buscado.",
+      "title": "Query",
+      "type": "string"
+    }
+  },
+  "required": [
+    "query",
+    "confidence"
+  ],
+  "title": "AgentNameMatch",
+  "type": "object"
+}

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/AgentPublishedRecently"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Preenchido só na busca por nome: a Adoteca postou este pet nesta rede há pouco. Use para situar a pessoa ('o que postamos no Instagram') em vez de afirmar sem contexto."
+}

Added value: +{
+  "properties": {
+    "platform": {
+      "description": "Rede onde a Adoteca postou este pet, ex.: 'Instagram'.",
+      "title": "Platform",
+      "type": "string"
+    },
+    "published_at": {
+      "description": "Quando a Adoteca postou.",
+      "format": "date-time",
+      "title": "Published At",
+      "type": "string"
+    }
+  },
+  "required": [
+    "platform",
+    "published_at"
+  ],
+  "title": "AgentPublishedRecently",
+  "type": "object"
+}

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/AgentNameMatch"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Só quando a busca enviou `name`. Leia `confidence` antes de afirmar de qual pet a pessoa está falando."
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Raça: slug ('golden-retriever') ou nome em português ('pastor alemão'). A maioria do catálogo é SRD (sem raça definida). Use a listagem de raças para ver as raças com pets hoje.",
+  "title": "Breed"
+}

Previous value: -"Quantos pets devolver por página. Valores acima de 24 são reduzidos a 24."New value: +"Quantos resultados devolver por página. Valores acima de 24 são reduzidos a 24."