{
  "type": "object",
  "properties": {
    "nom": {
      "type": "string",
      "description": "Recherche par nom (autocomplétion). Ex: \"Villeneuve d'Ascq\", \"Lyon\"."
    },
    "codePostal": {
      "type": "string",
      "description": "Code postal exact (5 chiffres). Ex: \"59650\"."
    },
    "code": {
      "type": "string",
      "description": "Code INSEE exact (5 caractères). Ex: \"59009\"."
    },
    "limit": {
      "type": "number",
      "description": "Nombre max de résultats (1-30, défaut 10).",
      "default": 10
    },
    "boostPopulation": {
      "type": "boolean",
      "description": "Trier par population décroissante. Recommandé pour les noms ambigus (ex: 'Charleville').",
      "default": true
    }
  }
}

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Code INSEE 5 caractères. Ex: \"75056\" Paris, \"59009\" Villeneuve-d'Ascq, \"2A004\" Ajaccio."
    }
  },
  "required": [
    "code"
  ]
}

{
  "type": "object",
  "properties": {
    "adresse": {
      "type": "string",
      "description": "Adresse complète à géocoder."
    },
    "codePostal": {
      "type": "string",
      "description": "Optionnel — limiter le résultat à un code postal pour désambiguïser."
    },
    "codeCommune": {
      "type": "string",
      "description": "Optionnel — limiter au code INSEE de commune."
    }
  },
  "required": [
    "adresse"
  ]
}

{
  "type": "object",
  "properties": {
    "lon": {
      "type": "number",
      "description": "Longitude (WGS84)."
    },
    "lat": {
      "type": "number",
      "description": "Latitude (WGS84)."
    }
  },
  "required": [
    "lon",
    "lat"
  ]
}

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Code INSEE — 5 caractères = commune (ex \"75056\"), 2-3 caractères = département (ex \"75\", \"971\", \"2A\"). Granularité auto-détectée par la longueur."
    }
  },
  "required": [
    "code"
  ]
}

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "description": "Latitude du point (mode point)."
    },
    "lon": {
      "type": "number",
      "description": "Longitude du point (mode point)."
    },
    "code_iris": {
      "type": "string",
      "description": "Code IRIS 9 caractères (ex `751103701`) — alternatif au point."
    },
    "rayon_km": {
      "type": "number",
      "description": "Rayon du bassin en km (0 < r ≤ 10). Absent = profil de l'îlot seul."
    }
  }
}

{
  "type": "object",
  "properties": {
    "naf": {
      "type": "string",
      "description": "Code NAF principal (ex: '8690B' = labos, '4773Z' = pharmacies, '8710A' = EHPAD, '8621Z' = MG)."
    },
    "q": {
      "type": "string",
      "description": "Recherche textuelle libre (raison sociale, dirigeant…)."
    },
    "lon": {
      "type": "number",
      "description": "Longitude du centre du cercle de recherche."
    },
    "lat": {
      "type": "number",
      "description": "Latitude du centre du cercle de recherche."
    },
    "radiusKm": {
      "type": "number",
      "description": "Rayon en km (1-50)."
    },
    "codePostal": {
      "type": "string",
      "description": "Filtre alternatif : code postal exact."
    },
    "departement": {
      "type": "string",
      "description": "Filtre alternatif : code département."
    },
    "perPage": {
      "type": "number",
      "description": "Résultats par page (1-25, défaut 10).",
      "default": 10
    },
    "page": {
      "type": "number",
      "description": "Page (1-indexed).",
      "default": 1
    },
    "includeDirigeants": {
      "type": "boolean",
      "description": "Inclure la liste des dirigeants RNE dans chaque entreprise (défaut true). `false` strip `dirigeants: []` côté handler — utile en énumération volume où les dirigeants ne sont pas exploités (économie de tokens, groupes type Biogroup peuvent lister 20+ dirigeants par entité).",
      "default": true
    }
  }
}

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string",
      "description": "SIREN exact, 9 chiffres."
    }
  },
  "required": [
    "siren"
  ]
}

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "num_finess": {
      "type": "string",
      "description": "Numéro FINESS exact (9 chiffres)."
    }
  },
  "required": [
    "num_finess"
  ]
}

{
  "type": "object",
  "properties": {
    "num_finess": {
      "type": "string",
      "description": "Numéro FINESS exact (9 chiffres)."
    }
  },
  "required": [
    "num_finess"
  ]
}

{
  "type": "object",
  "properties": {
    "num_finess": {
      "type": "string",
      "description": "Numéro FINESS exact (9 chiffres)."
    }
  },
  "required": [
    "num_finess"
  ]
}

{
  "type": "object",
  "properties": {
    "num_finess": {
      "type": "string",
      "description": "Numéro FINESS exact (9 chiffres)."
    }
  },
  "required": [
    "num_finess"
  ]
}

{
  "type": "object",
  "properties": {
    "num_finess": {
      "type": "string",
      "description": "Numéro FINESS exact (9 chiffres)."
    }
  },
  "required": [
    "num_finess"
  ]
}

{
  "type": "object",
  "properties": {
    "siret": {
      "type": "string",
      "description": "SIRET exact, 14 chiffres."
    }
  },
  "required": [
    "siret"
  ]
}

{
  "type": "object",
  "properties": {
    "lon": {
      "type": "number",
      "description": "Longitude du centre (WGS84)."
    },
    "lat": {
      "type": "number",
      "description": "Latitude du centre (WGS84)."
    },
    "radius_km": {
      "type": "number",
      "description": "Rayon en km (0.1-50, défaut 5).",
      "minimum": 0.1,
      "maximum": 50,
      "default": 5
    },
    "familles": {
      "type": "array",
      "description": "Familles FINESS à inclure (24 valeurs disponibles, voir enum). Si omis, toutes catégories.",
      "items": {
        "type": "string",
        "enum": [
          "mco",
          "ssr",
          "sld",
          "had",
          "psychiatrie",
          "dialyse",
          "ambulatoire",
          "labo",
          "imagerie",
          "pharmacie",
          "msp_cpts",
          "ehpad",
          "residence_autonomie",
          "senior_accompagnement",
          "ssiad",
          "aide_domicile",
          "handicap_enfants",
          "handicap_adultes",
          "addictologie",
          "enfance_protection",
          "pmi",
          "hebergement_social",
          "prevention_sante",
          "groupement"
        ]
      }
    },
    "limit": {
      "type": "number",
      "description": "Nombre max de résultats (1-500, défaut 100).",
      "minimum": 1,
      "maximum": 500,
      "default": 100
    },
    "include_freshness": {
      "type": "boolean",
      "default": false,
      "description": "Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant, par source (FINESS, Ameli, RPPS, CDS, IRIS), la dernière ingestion réussie (`last_success_at`, `staleness_days`) ET la dernière fois que la donnée a réellement changé (`last_data_change_at`, `data_age_days` — un run court-circuité « fichier amont identique » compte comme succès mais ne rajeunit pas la donnée ; c'est `data_age_days` qui dit l'âge réel de ce qui est servi). Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable."
    }
  },
  "required": [
    "lon",
    "lat"
  ]
}

{
  "type": "object",
  "properties": {
    "categorie": {
      "type": "string",
      "description": "Famille FINESS recherchée (24 valeurs disponibles, voir enum).",
      "enum": [
        "mco",
        "ssr",
        "sld",
        "had",
        "psychiatrie",
        "dialyse",
        "ambulatoire",
        "labo",
        "imagerie",
        "pharmacie",
        "msp_cpts",
        "ehpad",
        "residence_autonomie",
        "senior_accompagnement",
        "ssiad",
        "aide_domicile",
        "handicap_enfants",
        "handicap_adultes",
        "addictologie",
        "enfance_protection",
        "pmi",
        "hebergement_social",
        "prevention_sante",
        "groupement"
      ]
    },
    "departement": {
      "type": "string",
      "description": "Code département INSEE (ex: '75', '2A', '2B', '971'). Métropole 2 caractères (Corse '2A'/'2B', pas '20'), DOM/TOM 3 caractères. Optionnel. Combinable avec `nom_commune` comme hint resolver (filtre les homonymes), sinon XOR strict avec `code_insee` et `nom_commune`."
    },
    "code_insee": {
      "type": "string",
      "description": "Code INSEE de commune (5 caractères). Optionnel. XOR strict avec `departement` et `nom_commune`."
    },
    "nom_commune": {
      "type": "string",
      "description": "Nom officiel de commune (alternative à `code_insee`, V0.19). Ex: \"Lille\", \"Saint-Étienne\". Le serveur résout en interne via geo.api.gouv.fr. Si ambigu (ex \"Saint-Martin\" → 5 villes), retourne une erreur structurée avec candidates. Combinable avec `departement` comme hint de désambiguïsation. Abréviations type \"St-Martin\" non reconnues — utiliser le nom officiel complet."
    },
    "limit": {
      "type": "number",
      "description": "Nombre max de résultats (1-500, défaut 100).",
      "minimum": 1,
      "maximum": 500,
      "default": 100
    },
    "include_freshness": {
      "type": "boolean",
      "default": false,
      "description": "Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant, par source (FINESS, Ameli, RPPS, CDS, IRIS), la dernière ingestion réussie (`last_success_at`, `staleness_days`) ET la dernière fois que la donnée a réellement changé (`last_data_change_at`, `data_age_days` — un run court-circuité « fichier amont identique » compte comme succès mais ne rajeunit pas la donnée ; c'est `data_age_days` qui dit l'âge réel de ce qui est servi). Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable."
    }
  },
  "required": [
    "categorie"
  ]
}

{
  "type": "object",
  "properties": {
    "num_finess": {
      "type": "string",
      "description": "Numéro FINESS exact (9 chiffres)."
    },
    "include_freshness": {
      "type": "boolean",
      "default": false,
      "description": "Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant, par source (FINESS, Ameli, RPPS, CDS, IRIS), la dernière ingestion réussie (`last_success_at`, `staleness_days`) ET la dernière fois que la donnée a réellement changé (`last_data_change_at`, `data_age_days` — un run court-circuité « fichier amont identique » compte comme succès mais ne rajeunit pas la donnée ; c'est `data_age_days` qui dit l'âge réel de ce qui est servi). Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable."
    }
  },
  "required": [
    "num_finess"
  ]
}

{
  "type": "object",
  "properties": {
    "nom": {
      "type": "string",
      "description": "Nom de l'établissement tel qu'on le dit (3 caractères min). Accents, casse et ponctuation indifférents. Sans le nom de la commune (le mettre dans `nom_commune`)."
    },
    "nom_commune": {
      "type": "string",
      "description": "Nom officiel de la commune où se trouve l'établissement (résolu via geo.api.gouv.fr). Ex : \"Villejuif\", \"Paris\". Combinable avec `departement` comme hint de désambiguïsation. XOR avec `code_insee`."
    },
    "code_insee": {
      "type": "string",
      "description": "Code INSEE de la commune (5 caractères). Paris/Lyon/Marseille : 75056 / 69123 / 13055 acceptés (ville entière) comme un arrondissement. XOR avec `nom_commune` et `departement`."
    },
    "departement": {
      "type": "string",
      "description": "Code département (ex : '94', '2A', '971'). Seul = filtre département ; avec `nom_commune` = hint de désambiguïsation."
    },
    "limit": {
      "type": "number",
      "description": "Candidats bruts lus avant seuil et tri (1-200, défaut 50). Monter si le nom est très partagé (« Saint Antoine » : 42 fiches).",
      "minimum": 1,
      "maximum": 200,
      "default": 50
    },
    "include_freshness": {
      "type": "boolean",
      "default": false,
      "description": "Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant, par source (FINESS, Ameli, RPPS, CDS, IRIS), la dernière ingestion réussie (`last_success_at`, `staleness_days`) ET la dernière fois que la donnée a réellement changé (`last_data_change_at`, `data_age_days` — un run court-circuité « fichier amont identique » compte comme succès mais ne rajeunit pas la donnée ; c'est `data_age_days` qui dit l'âge réel de ce qui est servi). Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable."
    }
  },
  "required": [
    "nom"
  ]
}

{
  "type": "object",
  "properties": {
    "lon": {
      "type": "number",
      "description": "Longitude du centre (WGS84). Ex: 2.317 (Paris)."
    },
    "lat": {
      "type": "number",
      "description": "Latitude du centre (WGS84). Ex: 48.872 (Paris)."
    },
    "radius_km": {
      "type": "number",
      "description": "Rayon en km (0.1-50, défaut 5).",
      "minimum": 0.1,
      "maximum": 50,
      "default": 5
    },
    "specialite_codes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Codes spécialité CNAM Annexe A (ex: ['01'] médecine générale, ['53'] chirurgien-dentiste). Match any-of. Vide = pas de filtre spécialité."
    },
    "accepte_carte_vitale": {
      "type": "boolean",
      "description": "Filtre par acceptation carte Vitale. true = uniquement CDS qui acceptent CV, false = uniquement ceux qui ne l'acceptent pas. Omis = pas de filtre."
    },
    "type_etab_codes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Codes type établissement Annexe B : ['124'] CDS standard (défaut implicite), ['125'] CDS dentaire deprecated. Vide = tous types."
    },
    "limit": {
      "type": "number",
      "description": "Nombre max de résultats (1-500, défaut 100).",
      "minimum": 1,
      "maximum": 500,
      "default": 100
    },
    "include_freshness": {
      "type": "boolean",
      "default": false,
      "description": "Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant, par source (FINESS, Ameli, RPPS, CDS, IRIS), la dernière ingestion réussie (`last_success_at`, `staleness_days`) ET la dernière fois que la donnée a réellement changé (`last_data_change_at`, `data_age_days` — un run court-circuité « fichier amont identique » compte comme succès mais ne rajeunit pas la donnée ; c'est `data_age_days` qui dit l'âge réel de ce qui est servi). Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable."
    }
  },
  "required": [
    "lon",
    "lat"
  ]
}

{
  "type": "object",
  "properties": {
    "num_finess": {
      "type": "string",
      "description": "Numéro FINESS exact 9 chiffres. Ex: '750000123'."
    },
    "include_freshness": {
      "type": "boolean",
      "default": false,
      "description": "Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant, par source (FINESS, Ameli, RPPS, CDS, IRIS), la dernière ingestion réussie (`last_success_at`, `staleness_days`) ET la dernière fois que la donnée a réellement changé (`last_data_change_at`, `data_age_days` — un run court-circuité « fichier amont identique » compte comme succès mais ne rajeunit pas la donnée ; c'est `data_age_days` qui dit l'âge réel de ce qui est servi). Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable."
    }
  },
  "required": [
    "num_finess"
  ]
}

{
  "type": "object",
  "properties": {
    "lon": {
      "type": "number",
      "description": "Longitude du centre (WGS84)."
    },
    "lat": {
      "type": "number",
      "description": "Latitude du centre (WGS84)."
    },
    "radius_km": {
      "type": "number",
      "description": "Rayon en km (0.1-50, défaut 5).",
      "minimum": 0.1,
      "maximum": 50,
      "default": 5
    },
    "specialite_codes": {
      "type": "array",
      "description": "Liste de codes spécialité Ameli (ex: ['01'] MG, ['03'] cardio). Si omis, toutes spécialités.",
      "items": {
        "type": "string"
      }
    },
    "type_ps_codes": {
      "type": "array",
      "description": "Liste de codes type PS Ameli (3 valeurs présentes en base : '1' médecins, '2' auxiliaires médicaux fourre-tout — IDE/kinés/sages-femmes/podologues/orthophonistes/orthoptistes/IPA, '5' chirurgiens-dentistes). Pour cibler une seule profession, préférer `specialite_codes`. Si omis, tous types.",
      "items": {
        "type": "string"
      }
    },
    "limit": {
      "type": "number",
      "description": "Nombre max de résultats (1-500, défaut 100). Appliqué AVANT déduplication.",
      "minimum": 1,
      "maximum": 500,
      "default": 100
    },
    "dedupe_by_ps": {
      "type": "boolean",
      "description": "Regrouper les entrées par praticien (nom + prénom + code spécialité) et lister chaque adresse d'exercice dans `sites[]`. Défaut false (comportement V0.4 historique : un PS multi-sites = N entrées).",
      "default": false
    },
    "precise_only": {
      "type": "boolean",
      "description": "Si true, exclut les PS au centroïde commune et ne renvoie que ceux géocodés à l'adresse BAN, à `distance_km` exacte (cf. description du tool pour la sémantique complète). Défaut false.",
      "default": false
    },
    "include_freshness": {
      "type": "boolean",
      "default": false,
      "description": "Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant, par source (FINESS, Ameli, RPPS, CDS, IRIS), la dernière ingestion réussie (`last_success_at`, `staleness_days`) ET la dernière fois que la donnée a réellement changé (`last_data_change_at`, `data_age_days` — un run court-circuité « fichier amont identique » compte comme succès mais ne rajeunit pas la donnée ; c'est `data_age_days` qui dit l'âge réel de ce qui est servi). Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable."
    }
  },
  "required": [
    "lon",
    "lat"
  ]
}

{
  "type": "object",
  "properties": {
    "departement": {
      "type": "string",
      "description": "Code département INSEE : 2 caractères métropole/Corse ('01'-'95', '2A'/'2B'), 3 caractères DOM ('971'-'978')."
    },
    "specialite_code": {
      "type": "string",
      "description": "Code spécialité Ameli (ex: '01' MG, '24' IDE, '26' kiné, '03' cardio). Optionnel. Liste complète via `lister_nomenclature(referentiel:'ameli_specialites')`."
    },
    "type_ps_code": {
      "type": "string",
      "description": "Code type PS Ameli ('1' médecins, '2' auxiliaires médicaux, '5' chirurgiens-dentistes). Optionnel — préférer `specialite_code` pour un ciblage précis. Liste complète via `lister_nomenclature(referentiel:'ameli_types_ps')`."
    },
    "limit": {
      "type": "number",
      "description": "Nombre max de résultats (1-500, défaut 100). Appliqué AVANT déduplication.",
      "minimum": 1,
      "maximum": 500,
      "default": 100
    },
    "offset": {
      "type": "number",
      "description": "Décalage de pagination (≥ 0, défaut 0). Combiner avec `limit` pour énumérer un département à fort effectif. Re-paginer tant que `truncated=true`.",
      "minimum": 0,
      "default": 0
    },
    "dedupe_by_ps": {
      "type": "boolean",
      "description": "Regrouper les entrées par praticien (nom + prénom + code spécialité) et lister chaque adresse d'exercice dans `sites[]`. Défaut false.",
      "default": false
    },
    "include_freshness": {
      "type": "boolean",
      "default": false,
      "description": "Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant, par source (FINESS, Ameli, RPPS, CDS, IRIS), la dernière ingestion réussie (`last_success_at`, `staleness_days`) ET la dernière fois que la donnée a réellement changé (`last_data_change_at`, `data_age_days` — un run court-circuité « fichier amont identique » compte comme succès mais ne rajeunit pas la donnée ; c'est `data_age_days` qui dit l'âge réel de ce qui est servi). Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable."
    }
  },
  "required": [
    "departement"
  ]
}

{
  "type": "object",
  "properties": {
    "referentiel": {
      "type": "string",
      "enum": [
        "ameli_specialites",
        "ameli_types_ps",
        "rpps_savoir_faire"
      ],
      "description": "Nomenclature à lister. `ameli_specialites` / `ameli_types_ps` = Ameli (libéraux conventionnés) ; `rpps_savoir_faire` = spécialités médicales ANS/RPPS (nomenclature DISTINCTE)."
    },
    "limit": {
      "type": "number",
      "description": "Nombre max de résultats (défaut 50, max 1000). Triés par fréquence décroissante. La réponse expose `total` (effectif réel) et `truncated` — re-appeler avec un `limit` supérieur pour la liste complète."
    },
    "include_freshness": {
      "type": "boolean",
      "default": false,
      "description": "Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant, par source (FINESS, Ameli, RPPS, CDS, IRIS), la dernière ingestion réussie (`last_success_at`, `staleness_days`) ET la dernière fois que la donnée a réellement changé (`last_data_change_at`, `data_age_days` — un run court-circuité « fichier amont identique » compte comme succès mais ne rajeunit pas la donnée ; c'est `data_age_days` qui dit l'âge réel de ce qui est servi). Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable."
    },
    "include_specialites": {
      "type": "boolean",
      "description": "Référentiel `ameli_types_ps` UNIQUEMENT : inclure le sous-tableau `specialites_presentes` détaillé (défaut true). `false` → remplacé par `nb_specialites` (compteur), ~6K tokens économisés.",
      "default": true
    },
    "profession_code": {
      "type": "string",
      "description": "Référentiel `rpps_savoir_faire` UNIQUEMENT : code profession ANS (TRE_R94). Défaut '10' (Médecin). String vide ou 'null' = tous savoir_faire, toutes professions."
    }
  },
  "required": [
    "referentiel"
  ]
}

{
  "type": "object",
  "properties": {
    "center": {
      "type": "object",
      "description": "Centre du cercle de recherche (coordonnées WGS84).",
      "properties": {
        "lat": {
          "type": "number",
          "description": "Latitude (WGS84)."
        },
        "lon": {
          "type": "number",
          "description": "Longitude (WGS84)."
        }
      },
      "required": [
        "lat",
        "lon"
      ]
    },
    "radius_km": {
      "type": "number",
      "description": "Rayon en km (0.1-50).",
      "minimum": 0.1,
      "maximum": 50
    },
    "profession_codes": {
      "type": "array",
      "description": "Codes profession ANS (ex: ['10'] Médecin, ['60'] Infirmier). Si omis, toutes professions.",
      "items": {
        "type": "string"
      }
    },
    "savoir_faire_codes": {
      "type": "array",
      "description": "Codes savoir-faire ANS (spécialités fines DES/DESC). Si omis, tous savoir-faire.",
      "items": {
        "type": "string"
      }
    },
    "mode_exercice_codes": {
      "type": "array",
      "description": "Codes mode d'exercice ANS (libéral / salarié / mixte). Si omis, tous modes.",
      "items": {
        "type": "string"
      }
    },
    "include_etudiants": {
      "type": "boolean"
    },
    "include_agents_publics": {
      "type": "boolean"
    },
    "limit": {
      "type": "number",
      "description": "Nombre max de résultats retournés (défaut serveur 100)."
    },
    "precise_only": {
      "type": "boolean",
      "description": "Si true, exclut les PS au centroïde commune et ne renvoie que ceux à `distance_km` exacte (cf. description du tool pour la sémantique complète et le seuil d'usage recommandé). Défaut false.",
      "default": false
    },
    "include_freshness": {
      "type": "boolean",
      "default": false,
      "description": "Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant, par source (FINESS, Ameli, RPPS, CDS, IRIS), la dernière ingestion réussie (`last_success_at`, `staleness_days`) ET la dernière fois que la donnée a réellement changé (`last_data_change_at`, `data_age_days` — un run court-circuité « fichier amont identique » compte comme succès mais ne rajeunit pas la donnée ; c'est `data_age_days` qui dit l'âge réel de ce qui est servi). Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable."
    }
  },
  "required": [
    "center",
    "radius_km"
  ]
}

{
  "type": "object",
  "properties": {
    "departement": {
      "type": "string",
      "description": "Code département INSEE (ex: '75', '2A', '2B', '971'). Métropole 2 caractères (Corse '2A'/'2B', pas '20'), DOM/TOM 3 caractères."
    },
    "profession_code": {
      "type": "string",
      "description": "Code profession ANS (ex: '10' Médecin, '60' Infirmier). Optionnel."
    },
    "savoir_faire_code": {
      "type": "string",
      "description": "Code savoir-faire ANS (spécialité fine DES/DESC). Optionnel."
    },
    "mode_exercice_code": {
      "type": "string",
      "description": "Code mode d'exercice ANS (libéral / salarié / mixte). Optionnel."
    },
    "include_etudiants": {
      "type": "boolean"
    },
    "include_agents_publics": {
      "type": "boolean"
    },
    "limit": {
      "type": "number",
      "description": "Nombre max de résultats par page (défaut serveur 100)."
    },
    "offset": {
      "type": "number",
      "description": "Offset pour pagination (défaut 0). Re-paginer tant que `truncated=true`."
    },
    "include_freshness": {
      "type": "boolean",
      "default": false,
      "description": "Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant, par source (FINESS, Ameli, RPPS, CDS, IRIS), la dernière ingestion réussie (`last_success_at`, `staleness_days`) ET la dernière fois que la donnée a réellement changé (`last_data_change_at`, `data_age_days` — un run court-circuité « fichier amont identique » compte comme succès mais ne rajeunit pas la donnée ; c'est `data_age_days` qui dit l'âge réel de ce qui est servi). Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable."
    }
  },
  "required": [
    "departement"
  ]
}

{
  "type": "object",
  "properties": {
    "num_finess": {
      "type": "string",
      "pattern": "^\\d{9}$"
    },
    "include_etudiants": {
      "type": "boolean"
    },
    "include_agents_publics": {
      "type": "boolean"
    },
    "limit": {
      "type": "number"
    },
    "include_freshness": {
      "type": "boolean",
      "default": false,
      "description": "Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant, par source (FINESS, Ameli, RPPS, CDS, IRIS), la dernière ingestion réussie (`last_success_at`, `staleness_days`) ET la dernière fois que la donnée a réellement changé (`last_data_change_at`, `data_age_days` — un run court-circuité « fichier amont identique » compte comme succès mais ne rajeunit pas la donnée ; c'est `data_age_days` qui dit l'âge réel de ce qui est servi). Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable."
    }
  },
  "required": [
    "num_finess"
  ]
}

{
  "type": "object",
  "properties": {
    "cible": {
      "type": "string",
      "enum": [
        "professionnels",
        "etablissements"
      ],
      "description": "`professionnels` = densité de PS (RPPS, filtres profession_code/savoir_faire_code/mode_exercice_codes) ; `etablissements` = densité d'établissements (FINESS, `famille` obligatoire)."
    },
    "code_dept": {
      "type": "string",
      "description": "Code INSEE du département 2-3 caractères. Ex: \"75\" Paris, \"59\" Nord, \"2A\" Corse-du-Sud, \"971\" Guadeloupe. Sémantique conditionnelle : seul = scope dept entier ; combiné avec `nom_commune` = hint resolver pour désambiguer les homonymes. XOR avec `code_insee`."
    },
    "code_insee": {
      "type": "string",
      "description": "Code INSEE de la commune 5 caractères. Ex: \"59009\" Villeneuve-d'Ascq, \"33063\" Bordeaux, \"2A004\" Ajaccio. Paris/Lyon/Marseille NON supporté au niveau commune (densité indisponible — voir description) : utiliser code_dept. XOR avec `code_dept` et `nom_commune`."
    },
    "nom_commune": {
      "type": "string",
      "description": "Nom officiel de commune (alternative à `code_insee`). Ex: \"Lille\", \"Villeneuve-d'Ascq\". Le serveur résout en interne via geo.api.gouv.fr. Combinable avec `code_dept` comme hint de désambiguïsation pour homonymes (ex \"Saint-Martin\" + dept \"65\"). XOR avec `code_insee`."
    },
    "famille": {
      "type": "string",
      "description": "cible='etablissements' UNIQUEMENT (obligatoire) : famille FINESS à compter (labo, pharmacie, ehpad, mco, ssr, psychiatrie, dialyse, imagerie, had, msp_cpts, handicap_enfants, handicap_adultes, addictologie, pmi, prevention_sante, etc.)."
    },
    "profession_code": {
      "type": "string",
      "description": "cible='professionnels' UNIQUEMENT : code profession ANS (TRE_R94). Default '10' (Médecin). Ex : '60' Infirmier, '21' Pharmacien, '50' Sage-femme, '40' Chirurgien-dentiste, '70' Masseur-kinésithérapeute."
    },
    "savoir_faire_code": {
      "type": "string",
      "description": "cible='professionnels' UNIQUEMENT : code spécialité (savoir_faire). Pertinent surtout pour profession_code=10 (médecin). Ex : 'SM04' Cardiologie, 'SM15' Dermatologie et vénéréologie, 'SM02' Anesthésie-réanimation, 'SM26' Médecine générale. Voir lister_nomenclature(referentiel:'rpps_savoir_faire') pour la liste exhaustive."
    },
    "mode_exercice_codes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "cible='professionnels' UNIQUEMENT : codes mode_exercice ANS à inclure. Default ['L','S','M'] (libéral + salarié + mixte = activité régulière DREES). Passer ['L'] pour libéraux seuls. Codes mode_exercice ANS : L libéral, S salarié, M mixte, R remplaçant, B bénévole, A autre."
    },
    "compare_national": {
      "type": "boolean",
      "description": "Ajoute le calcul France entière + écart relatif en % (recommandé pour qualifier 'sous-doté'/'sur-doté').",
      "default": false
    },
    "include_etudiants": {
      "type": "boolean"
    },
    "include_agents_publics": {
      "type": "boolean"
    }
  },
  "required": [
    "cible"
  ]
}

{
  "type": "object",
  "properties": {
    "code_insee": {
      "type": "string",
      "description": "Code INSEE de la commune 5 caractères. Ex: \"59009\" Villeneuve-d'Ascq, \"33063\" Bordeaux, \"2A004\" Ajaccio. Paris/Lyon/Marseille NON supporté (voir description). XOR avec `nom_commune`."
    },
    "nom_commune": {
      "type": "string",
      "description": "Nom officiel de commune (alternative à `code_insee`, V0.19). Ex: \"Lille\", \"Saint-Étienne\". Combinable avec `departement` comme hint de désambiguïsation pour homonymes (ex \"Saint-Martin\" + dept \"65\"). Abréviations type \"St-Martin\" non reconnues."
    },
    "departement": {
      "type": "string",
      "description": "Code département INSEE (V0.19, hint resolver UNIQUEMENT). À utiliser EN COMBINAISON avec `nom_commune` pour désambiguer les homonymes. Seul, lève une erreur (panorama = calcul commune uniquement, utiliser `code_insee` ou `nom_commune`)."
    },
    "finess_familles": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Familles FINESS à inclure dans le décompte établissements. Default [\"labo\",\"pharmacie\",\"ehpad\",\"mco\",\"msp_cpts\"]. Passer [] pour omettre le décompte FINESS (renvoie uniquement population + densités PS)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "num_finess": {
      "type": "string",
      "description": "Numéro FINESS exact 9 chiffres. Ex: '590048997'."
    },
    "rpps_limit": {
      "type": "integer",
      "description": "Nombre max de PS dans `professionnels.sample`. `professionnels.count` = taille du sample (≤ cette borne), pas le total du site ; `truncated: true` signale qu'il y a davantage de PS. Borné [1, 50]. Défaut 10."
    },
    "historique_detail": {
      "type": "boolean",
      "description": "Inclure les timelines SIRENE détaillées dans `historique.siret_timelines` (défaut true). `false` = payload allégé (~7K tokens en moins) : `historique` ne porte qu'un `resume` (counts) + un pointeur vers `historique_etablissement`.",
      "default": true
    }
  },
  "required": [
    "num_finess"
  ]
}

{
  "type": "object",
  "properties": {
    "nom": {
      "type": "string",
      "description": "Nom de famille (non vide)."
    },
    "prenom": {
      "type": "string",
      "description": "Prénom du PS."
    },
    "departement": {
      "type": "string",
      "description": "Code département INSEE (ex: '75', '2A', '2B', '971'). Métropole 2 caractères (Corse '2A'/'2B', pas '20'), DOM/COM 3 caractères."
    },
    "include_etudiants": {
      "type": "boolean"
    },
    "include_agents_publics": {
      "type": "boolean"
    },
    "limit": {
      "type": "number",
      "description": "Nombre max de résultats (1-500, défaut 100).",
      "minimum": 1,
      "maximum": 500,
      "default": 100
    },
    "include_freshness": {
      "type": "boolean",
      "default": false,
      "description": "Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant, par source (FINESS, Ameli, RPPS, CDS, IRIS), la dernière ingestion réussie (`last_success_at`, `staleness_days`) ET la dernière fois que la donnée a réellement changé (`last_data_change_at`, `data_age_days` — un run court-circuité « fichier amont identique » compte comme succès mais ne rajeunit pas la donnée ; c'est `data_age_days` qui dit l'âge réel de ce qui est servi). Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable."
    }
  },
  "required": [
    "nom"
  ]
}

{
  "type": "object",
  "properties": {
    "rpps_id": {
      "type": "string",
      "pattern": "^\\s*\\d{11,12}\\s*$"
    },
    "include_freshness": {
      "type": "boolean",
      "default": false,
      "description": "Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant, par source (FINESS, Ameli, RPPS, CDS, IRIS), la dernière ingestion réussie (`last_success_at`, `staleness_days`) ET la dernière fois que la donnée a réellement changé (`last_data_change_at`, `data_age_days` — un run court-circuité « fichier amont identique » compte comme succès mais ne rajeunit pas la donnée ; c'est `data_age_days` qui dit l'âge réel de ce qui est servi). Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable."
    }
  },
  "required": [
    "rpps_id"
  ]
}

{
  "type": "object",
  "properties": {
    "lon": {
      "type": "number",
      "description": "Longitude WGS84 du centre de la zone."
    },
    "lat": {
      "type": "number",
      "description": "Latitude WGS84 du centre de la zone."
    },
    "radius_km": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 50,
      "default": 5,
      "description": "Rayon de la zone en km (0.1-50, défaut 5)."
    },
    "naf": {
      "type": "string",
      "description": "Code NAF SIRENE à comparer (ex: '8690B' labos d'analyses médicales, '4773Z' pharmacies, '8621Z' médecine générale)."
    },
    "familles": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "mco",
          "ssr",
          "sld",
          "had",
          "psychiatrie",
          "dialyse",
          "ambulatoire",
          "labo",
          "imagerie",
          "pharmacie",
          "msp_cpts",
          "ehpad",
          "residence_autonomie",
          "senior_accompagnement",
          "ssiad",
          "aide_domicile",
          "handicap_enfants",
          "handicap_adultes",
          "addictologie",
          "enfance_protection",
          "pmi",
          "hebergement_social",
          "prevention_sante",
          "groupement"
        ]
      },
      "description": "Familles FINESS à inclure côté DREES. V0.13.2 : si omis, auto-dérivé du NAF cible via la table naf-finess-mapping (ex: naf=8690B → familles=[labo] ; naf=8610Z → multi-familles hospitalières). Passer explicitement si vous voulez restreindre davantage le scope. Valeurs : mco, ssr, sld, had, psychiatrie, dialyse, ambulatoire, labo, imagerie, pharmacie, msp_cpts, ehpad, residence_autonomie, senior_accompagnement, ssiad, aide_domicile, handicap_enfants, handicap_adultes, addictologie, enfance_protection, pmi, hebergement_social, prevention_sante, groupement."
    },
    "max_unites_legales": {
      "type": "number",
      "minimum": 1,
      "maximum": 25,
      "default": 10,
      "description": "Nombre maximum d'unités légales DINUM à déplier (1-25, défaut 10). Au-delà : truncated_unites_legales=true."
    }
  },
  "required": [
    "lon",
    "lat",
    "naf"
  ]
}

{
  "type": "object",
  "properties": {
    "adresse": {
      "type": "string",
      "description": "Adresse cible, géocodée en interne via IGN. Ex: \"12 rue Nationale, Lille\". XOR avec `point`."
    },
    "point": {
      "type": "object",
      "description": "Coordonnées { lat, lon } si déjà connues (skip géocodage). Fournir `code_insee` avec.",
      "properties": {
        "lat": {
          "type": "number"
        },
        "lon": {
          "type": "number"
        }
      }
    },
    "code_insee": {
      "type": "string",
      "description": "Code INSEE commune (avec `point`, quand le géocodage est déjà fait)."
    },
    "rayon_km": {
      "type": "number",
      "description": "Rayon du bassin de l'étude (km). Défaut 5."
    }
  }
}

{
  "type": "object",
  "properties": {
    "finess": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Numéros FINESS à enquêter (typiquement le top 3 concurrents par distance)."
    },
    "max": {
      "type": "number",
      "description": "Cap dur du nombre de concurrents enquêtés. Défaut 3."
    }
  },
  "required": [
    "finess"
  ]
}

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "description": "Latitude du centre (WGS84)."
    },
    "lon": {
      "type": "number",
      "description": "Longitude du centre (WGS84)."
    },
    "rayon_km": {
      "type": "number",
      "description": "Rayon en km (0.1-10, défaut 3).",
      "minimum": 0.1,
      "maximum": 10,
      "default": 3
    }
  },
  "required": [
    "lat",
    "lon"
  ]
}

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "description": "Latitude du centre (WGS84)."
    },
    "lon": {
      "type": "number",
      "description": "Longitude du centre (WGS84)."
    },
    "rayon_km": {
      "type": "number",
      "description": "Rayon en km (0.1-10, défaut 3).",
      "minimum": 0.1,
      "maximum": 10,
      "default": 3
    }
  },
  "required": [
    "lat",
    "lon"
  ]
}