boondmanager-mcp-server 2.16.0 → 2.18.0

package/dist/schemas/index.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE, MAX_SEARCH_PAGE } from "../constants.js";
+import { DEFAULT_PAGE_SIZE, INLINE_UPLOAD_MAX_BYTES, MAX_PAGE_SIZE, MAX_SEARCH_PAGE } from "../constants.js";
 import { appendOverridesToDescription, resolveLabel } from "../config/dictionary-overrides.js";
 // Client-side projection, shared by every search schema. Declared before
 // `SearchSchema` because that schema embeds it (a `const` referenced during
@@ -10,7 +10,7 @@ import { appendOverridesToDescription, resolveLabel } from "../config/dictionary
 export const fieldsField = z
     .array(z.string())
     .optional()
-    .describe("Projection : attributs à afficher par résultat (ex: ['title','updateDate']). " +
+    .describe("Projection : attributs ou relations (type#id) par résultat (ex: ['title','dependsOn']). " +
     "Absent = résumé standard. Noms inconnus ignorés.");
 // ---- Reusable filter field helpers ----
 // IMPORTANT: input field names below MUST match the BoondManager API query parameter names
@@ -24,7 +24,7 @@ export const fieldsField = z
 // ("Too big: expected number to be <=100") says what was refused but not what
 // to do instead, and a model that hit the page ceiling should refine its
 // filters rather than retry one page lower.
-const pageField = z
+export const pageField = z
     .number()
     .int()
     .min(1)
@@ -33,15 +33,27 @@ const pageField = z
 })
     .default(1)
     .describe(`Numéro de page (défaut: 1, max: ${MAX_SEARCH_PAGE})`);
-const pageSizeField = z
+export const pageSizeField = z
     .number()
     .int()
     .min(1)
     .max(MAX_PAGE_SIZE, { error: `pageSize > ${MAX_PAGE_SIZE} refusé : maximum ${MAX_PAGE_SIZE} résultats par page.` })
     .default(DEFAULT_PAGE_SIZE)
     .describe(`Nombre de résultats par page (max: ${MAX_PAGE_SIZE}, défaut: ${DEFAULT_PAGE_SIZE})`);
-const sortField = z.string().optional().describe("Champ de tri (ex: lastName, firstName, updateDate)");
-const orderField = z.enum(["asc", "desc"]).optional().describe("Ordre de tri (asc/desc)");
+export const sortField = z.string().optional().describe("Champ de tri (ex: lastName, firstName, updateDate)");
+export const orderField = z.enum(["asc", "desc"]).optional().describe("Ordre de tri (asc/desc)");
+/** `page` / `pageSize` / `fields` — every paginated search. */
+export const paginationShape = {
+    page: pageField,
+    pageSize: pageSizeField,
+    fields: fieldsField,
+};
+/** `sort` / `order` + pagination — the six entity searches that accept sorting. */
+export const sortedPaginationShape = {
+    sort: sortField,
+    order: orderField,
+    ...paginationShape,
+};
 // Integer-id filters take ids, and a model that passes labels ("actif",
 // "Acme") gets an invalid_type issue. Point it at the resolution path in the
 // message itself rather than making it re-read the field description — but at
@@ -61,9 +73,7 @@ const strArray = (doc) => z.array(z.string()).optional().describe(doc);
 export const SearchSchema = z
     .object({
     keywords: z.string().optional().describe("Mots-clés de recherche (nom, email, compétences...)"),
-    page: pageField,
-    pageSize: pageSizeField,
-    fields: fieldsField,
+    ...paginationShape,
 })
     .strict();
 // Shared `tools` (technologies/skills) filter. Centralised so every entity
@@ -106,6 +116,90 @@ const endDateField = z
     .regex(/^\d{4}-\d{2}-\d{2}$/)
     .optional()
     .describe("Date de fin (YYYY-MM-DD), à utiliser avec `period`.");
+// ---- Shared filters of the finance / activity searches (issue #248) ----
+// `/invoices`, `/orders`, `/actions`, `/times-reports`, `/absences-reports`,
+// `/deliveries-groupments` and `/payments` all declare the RAML trait
+// `searchable`, so they take the six `perimeter*` filters — verified live on
+// 2026-09-26 (`perimeterDynamic=data` reduced every one of them). The
+// vocabulary below is per endpoint and was read from each `search.raml`.
+/** `periodDynamic` — the relative windows the RAML lists on every dated search (no `startDate` / `endDate` needed). */
+const periodDynamicField = z
+    .enum([
+    "today",
+    "yesterday",
+    "tomorrow",
+    "thisWeek",
+    "lastWeek",
+    "nextWeek",
+    "thisMonth",
+    "lastMonth",
+    "nextMonth",
+    "thisTrimester",
+    "lastTrimester",
+    "nextTrimester",
+    "thisSemester",
+    "lastSemester",
+    "nextSemester",
+    "thisYear",
+    "lastYear",
+    "nextYear",
+    "thisFiscalYear",
+    "lastFiscalYear",
+    "nextFiscalYear",
+    "untilToday",
+])
+    .optional()
+    .describe("Fenêtre relative appliquée à `period` (à la place de `startDate` / `endDate`) : today, thisWeek, thisMonth, lastMonth, thisYear, untilToday…");
+const flagsField = entityIdArray("IDs de drapeaux (flags) — `boond_flags_search`.");
+/** The validation workflow of a CRA / absence report is a string state, not a dictionary id (#250). */
+const validationStatesField = z
+    .array(z.enum(["waitingForValidation", "validated", "rejected"]))
+    .optional()
+    .describe("États du workflow de validation : waitingForValidation (à valider), validated, rejected.");
+const resourceTypesField = intArray("IDs de types de ressource — `boond://dictionary/typeOf/resources`.");
+const paymentMethodsField = intArray("IDs de modes de paiement — `boond://dictionary/paymentMethods`.");
+const projectTypesFilterField = intArray("IDs de types de projet — `boond://dictionary/typeOf/projects`.");
+const companiesFilterField = entityIdArray("IDs de sociétés (filtre API natif, équivalent de `companyId` pour plusieurs sociétés).");
+// ---- Shared shapes (issue #240) ----
+// Composed by spread into the entity search schemas so a change to one field
+// (a `.describe()`, the page-ceiling message) propagates everywhere. Before,
+// the six perimeter fields were copied six times, `shields` five times and the
+// `page`/`pageSize` pair ~16 times — ten of those copies had already lost the
+// `MAX_SEARCH_PAGE` explanation `pageField` carries.
+/** The six RAML-trait `searchable` perimeter filters, in API order. */
+export const perimeterShape = {
+    perimeterManagers: perimeterManagersField,
+    perimeterAgencies: perimeterAgenciesField,
+    perimeterPoles: perimeterPolesField,
+    perimeterBusinessUnits: perimeterBusinessUnitsField,
+    perimeterDynamic: perimeterDynamicField,
+    narrowPerimeter: narrowPerimeterField,
+};
+/** Completeness level of the conditional fields (RAML trait `shields`). */
+export const shieldsField = z
+    .array(z.enum(["uncomplete", "minimum", "complete"]))
+    .optional()
+    .describe("Niveau de complétude des champs conditionnels.");
+/** `keywordsType` values shared by the two people endpoints (resources, candidates). */
+export const peopleKeywordsTypeEnum = z.enum([
+    "resumeTd",
+    "lastName",
+    "firstName",
+    "fullName",
+    "strictFullName",
+    "emails",
+    "title",
+    "titleSkills",
+    "phones",
+    "reference",
+    "resume",
+    "td",
+]);
+/** `perimeterManagersType` — candidates and opportunities only. */
+const perimeterManagersTypeField = z
+    .enum(["main", "hr"])
+    .optional()
+    .describe("Type de responsable visé par `perimeterManagers`: 'main' (Main Manager) ou 'hr' (HR Manager).");
 // ---- Resource search schema (collaborateurs internes) ----
 // Source: https://doc.boondmanager.com/api-externe/raml-build/resources/resources/search.raml
 export const ResourceSearchSchema = z
@@ -115,30 +209,11 @@ export const ResourceSearchSchema = z
         .optional()
         .describe("Mots-clés (par défaut, recherche dans CV + dossier technique). Pour cibler un champ précis, " +
         "fournir aussi `keywordsType` (ex: lastName, firstName, fullName, emails, title, titleSkills, phones, reference)."),
-    keywordsType: z
-        .enum([
-        "resumeTd",
-        "lastName",
-        "firstName",
-        "fullName",
-        "strictFullName",
-        "emails",
-        "title",
-        "titleSkills",
-        "phones",
-        "reference",
-        "resume",
-        "td",
-    ])
+    keywordsType: peopleKeywordsTypeEnum
         .optional()
         .describe("Champ ciblé par `keywords`. Défaut: 'resumeTd' (CV + dossier technique). " +
         "Pour 'fullName' utiliser `keywords = 'NOM#PRENOM'`."),
-    perimeterManagers: perimeterManagersField,
-    perimeterAgencies: perimeterAgenciesField,
-    perimeterPoles: perimeterPolesField,
-    perimeterBusinessUnits: perimeterBusinessUnitsField,
-    perimeterDynamic: perimeterDynamicField,
-    narrowPerimeter: narrowPerimeterField,
+    ...perimeterShape,
     resourceStates: intArray("IDs d'états de ressource (dictionnaire setting.state.resource via boond_application_dictionary)."),
     excludeResourceStates: intArray("IDs d'états de ressource à EXCLURE."),
     resourceTypes: intArray("IDs de types de ressource (dictionnaire setting.typeOf.resource)."),
@@ -178,15 +253,8 @@ export const ResourceSearchSchema = z
         .optional()
         .describe("Rayon en km pour la recherche géographique (5-200). Requis si `coordinates` ou `location` est fourni."),
     excludeManager: z.boolean().optional().describe("Si true, ne retourne que les ressources sans compte manager."),
-    shields: z
-        .array(z.enum(["uncomplete", "minimum", "complete"]))
-        .optional()
-        .describe("Niveau de complétude des champs conditionnels."),
-    sort: sortField,
-    order: orderField,
-    page: pageField,
-    pageSize: pageSizeField,
-    fields: fieldsField,
+    shields: shieldsField,
+    ...sortedPaginationShape,
 })
     .strict();
 // ---- Candidate search schema ----
@@ -197,33 +265,9 @@ export const CandidateSearchSchema = z
         .string()
         .optional()
         .describe("Mots-clés (par défaut, recherche dans CV + dossier technique). Combinable avec `keywordsType`."),
-    keywordsType: z
-        .enum([
-        "resumeTd",
-        "lastName",
-        "firstName",
-        "fullName",
-        "strictFullName",
-        "emails",
-        "title",
-        "titleSkills",
-        "phones",
-        "reference",
-        "resume",
-        "td",
-    ])
-        .optional()
-        .describe("Champ ciblé par `keywords` (défaut: 'resumeTd')."),
-    perimeterManagers: perimeterManagersField,
-    perimeterAgencies: perimeterAgenciesField,
-    perimeterPoles: perimeterPolesField,
-    perimeterBusinessUnits: perimeterBusinessUnitsField,
-    perimeterDynamic: perimeterDynamicField,
-    perimeterManagersType: z
-        .enum(["main", "hr"])
-        .optional()
-        .describe("Type de responsable visé par `perimeterManagers`: 'main' (Main Manager) ou 'hr' (HR Manager)."),
-    narrowPerimeter: narrowPerimeterField,
+    keywordsType: peopleKeywordsTypeEnum.optional().describe("Champ ciblé par `keywords` (défaut: 'resumeTd')."),
+    ...perimeterShape,
+    perimeterManagersType: perimeterManagersTypeField,
     candidateStates: intArray("IDs d'états de candidat (dictionnaire setting.state.candidate via boond_application_dictionary)."),
     candidateTypes: intArray("IDs de types de candidat (dictionnaire setting.typeOf.resource)."),
     contractTypes: intArray("IDs de types de contrat recherchés (dictionnaire setting.typeOf.contract)."),
@@ -249,15 +293,8 @@ export const CandidateSearchSchema = z
     coordinates: z.string().optional().describe("Coordonnées GPS 'lat,lon'. Requiert `geoDistance`."),
     location: z.string().optional().describe("Adresse texte. Requiert `geoDistance`."),
     geoDistance: z.number().int().min(5).max(200).optional().describe("Rayon km (5-200)."),
-    shields: z
-        .array(z.enum(["uncomplete", "minimum", "complete"]))
-        .optional()
-        .describe("Niveau de complétude."),
-    sort: sortField,
-    order: orderField,
-    page: pageField,
-    pageSize: pageSizeField,
-    fields: fieldsField,
+    shields: shieldsField,
+    ...sortedPaginationShape,
 })
     .strict();
 // ---- Contact search schema ----
@@ -284,12 +321,7 @@ export const ContactSearchSchema = z
         .optional()
         .describe("Champ ciblé. Défaut: 'default'. Pour 'fullName' utiliser `keywords = 'NOM#PRENOM'`. " +
         "Pour 'companyFullName' utiliser `keywords = 'CSOCid#NOM#PRENOM'`."),
-    perimeterManagers: perimeterManagersField,
-    perimeterAgencies: perimeterAgenciesField,
-    perimeterPoles: perimeterPolesField,
-    perimeterBusinessUnits: perimeterBusinessUnitsField,
-    perimeterDynamic: perimeterDynamicField,
-    narrowPerimeter: narrowPerimeterField,
+    ...perimeterShape,
     states: intArray("IDs d'états de contact (dictionnaire setting.state.contact)."),
     companyStates: intArray("IDs d'états des sociétés rattachées (dictionnaire setting.state.company)."),
     typesOf: intArray("IDs de types de contact (dictionnaire setting.typeOf.contact). " +
@@ -309,15 +341,8 @@ export const ContactSearchSchema = z
     endDate: endDateField,
     completeness: strArray("Filtre par complétude des champs au format `fieldId:mode` (fieldId: email/phone/socialNetworks ; " +
         "mode: empty/filled). Logique OU par défaut, '#AND#' en 1er pour ET. Ex: ['email:empty','phone:empty']."),
-    shields: z
-        .array(z.enum(["uncomplete", "minimum", "complete"]))
-        .optional()
-        .describe("Niveau de complétude."),
-    sort: sortField,
-    order: orderField,
-    page: pageField,
-    pageSize: pageSizeField,
-    fields: fieldsField,
+    shields: shieldsField,
+    ...sortedPaginationShape,
 })
     .strict();
 // ---- Company search schema ----
@@ -332,12 +357,7 @@ export const CompanySearchSchema = z
         .enum(["default", "name", "phones", "emails", "socialNetworks"])
         .optional()
         .describe("Champ ciblé par `keywords`. Défaut: 'default'."),
-    perimeterManagers: perimeterManagersField,
-    perimeterAgencies: perimeterAgenciesField,
-    perimeterPoles: perimeterPolesField,
-    perimeterBusinessUnits: perimeterBusinessUnitsField,
-    perimeterDynamic: perimeterDynamicField,
-    narrowPerimeter: narrowPerimeterField,
+    ...perimeterShape,
     states: intArray("IDs d'états de société (dictionnaire setting.state.company)."),
     expertiseAreas: strArray("IDs de domaines d'expertise (dictionnaire setting.expertiseArea)."),
     origins: strArray("IDs d'origines (dictionnaire setting.origin)."),
@@ -350,15 +370,8 @@ export const CompanySearchSchema = z
         "À combiner avec `startDate` + `endDate`."),
     startDate: startDateField,
     endDate: endDateField,
-    shields: z
-        .array(z.enum(["uncomplete", "minimum", "complete"]))
-        .optional()
-        .describe("Niveau de complétude."),
-    sort: sortField,
-    order: orderField,
-    page: pageField,
-    pageSize: pageSizeField,
-    fields: fieldsField,
+    shields: shieldsField,
+    ...sortedPaginationShape,
 })
     .strict();
 // ---- Opportunity search schema ----
@@ -371,16 +384,8 @@ export const OpportunitySearchSchema = z
         .describe("Mots-clés. Pour cibler par ID préfixé : 'AOnnn' (opportunité), 'CSOCnnn' (société), " +
         "'CCONnnn' (contact), 'CANDnnn' (candidat), 'COMPnnn' (ressource), 'PRODnnn' (produit). " +
         "Sinon recherche plein texte sur titre/société."),
-    perimeterManagers: perimeterManagersField,
-    perimeterAgencies: perimeterAgenciesField,
-    perimeterPoles: perimeterPolesField,
-    perimeterBusinessUnits: perimeterBusinessUnitsField,
-    perimeterDynamic: perimeterDynamicField,
-    perimeterManagersType: z
-        .enum(["main", "hr"])
-        .optional()
-        .describe("Type de responsable visé par `perimeterManagers` (main/hr)."),
-    narrowPerimeter: narrowPerimeterField,
+    ...perimeterShape,
+    perimeterManagersType: perimeterManagersTypeField,
     opportunityStates: intArray("IDs d'états d'opportunité (dictionnaire setting.state.opportunity)."),
     opportunityTypes: strArray("IDs de types d'opportunité (dictionnaire setting.typeOf.project)."),
     positioningStates: strArray("IDs d'états de positionnement, ou 'none' pour les opportunités sans positionnement."),
@@ -399,15 +404,8 @@ export const OpportunitySearchSchema = z
         "À combiner avec `startDate` + `endDate`."),
     startDate: startDateField,
     endDate: endDateField,
-    shields: z
-        .array(z.enum(["uncomplete", "minimum", "complete"]))
-        .optional()
-        .describe("Niveau de complétude."),
-    sort: sortField,
-    order: orderField,
-    page: pageField,
-    pageSize: pageSizeField,
-    fields: fieldsField,
+    shields: shieldsField,
+    ...sortedPaginationShape,
 })
     .strict();
 // ---- Project search schema ----
@@ -419,12 +417,7 @@ export const ProjectSearchSchema = z
         .optional()
         .describe("Mots-clés. Pour cibler par ID préfixé : 'PRJnnn' (projet), 'CSOCnnn' (société), " +
         "'CCONnnn' (contact), 'AOnnn' (opportunité), 'COMPnnn' (ressource), 'CTRnnn' (contrat)."),
-    perimeterManagers: perimeterManagersField,
-    perimeterAgencies: perimeterAgenciesField,
-    perimeterPoles: perimeterPolesField,
-    perimeterBusinessUnits: perimeterBusinessUnitsField,
-    perimeterDynamic: perimeterDynamicField,
-    narrowPerimeter: narrowPerimeterField,
+    ...perimeterShape,
     projectStates: intArray("IDs d'états de projet (dictionnaire setting.state.project)."),
     projectTypes: intArray("IDs de types de projet (dictionnaire setting.typeOf.project)."),
     companies: entityIdArray("IDs de sociétés clientes : projets rattachés à ces sociétés."),
@@ -438,11 +431,7 @@ export const ProjectSearchSchema = z
         "'hasAdditionalDataOrPurchase'. À combiner avec `startDate` + `endDate`."),
     startDate: startDateField,
     endDate: endDateField,
-    sort: sortField,
-    order: orderField,
-    page: pageField,
-    pageSize: pageSizeField,
-    fields: fieldsField,
+    ...sortedPaginationShape,
 })
     .strict();
 // BoondManager entity ids are numeric. Constraining the schema to digits
@@ -470,6 +459,11 @@ export const IdSchema = z
 // the id still can't smuggle a path segment, `..`, `?` or `#` into the API
 // path. Letters are allowed in both cases because Boond derives the suffix
 // from camelCase parent types (`administrativeFile`).
+/** `mode` of `boond_documents_get` (issue #263): extracted text by default, the raw bytes on demand. */
+export const DocumentGetModeSchema = z
+    .enum(["text", "raw"])
+    .default("text")
+    .describe("text (défaut) : PDF et DOCX renvoyés en texte extrait côté serveur, images en contenu `image` ; raw : le fichier tel quel en ressource embarquée (base64).");
 export const DocumentIdSchema = z
     .object({
     id: z
@@ -478,6 +472,7 @@ export const DocumentIdSchema = z
         .describe("Identifiant du document, tel qu'exposé par les relations d'entités (ex. 123_resume)"),
 })
     .strict();
+export const DocumentGetSchema = DocumentIdSchema.extend({ mode: DocumentGetModeSchema }).strict();
 // ID + tab param schema
 export const IdTabSchema = z
     .object({
@@ -520,13 +515,8 @@ export const CandidateCreateSchema = z
     .strict();
 export const PositioningUpdateSchema = z
     .object({
-    id: z.string().min(1).describe("ID du positionnement \u00e0 modifier"),
-    state: z
-        .number()
-        .int()
-        .min(0)
-        .optional()
-        .describe("\u00c9tat du positionnement : ID num\u00e9rique du dictionnaire setting.state.positioning"),
+    id: EntityIdSchema.describe("ID du positionnement \u00e0 modifier"),
+    state: stateField("positioning", "État du positionnement : ID numérique de `boond://dictionary/states/positionings`"),
     stateReasonTypeOf: z
         .number()
         .int()
@@ -540,7 +530,7 @@ export const PositioningUpdateSchema = z
     .strict();
 export const CandidateUpdateSchema = z
     .object({
-    id: z.string().min(1).describe("ID du candidat à modifier"),
+    id: EntityIdSchema.describe("ID du candidat à modifier"),
     firstName: z.string().optional().describe("Prénom"),
     lastName: z.string().optional().describe("Nom"),
     email1: z.string().email().optional().describe("Email principal"),
@@ -551,6 +541,24 @@ export const CandidateUpdateSchema = z
     state: stateField("candidate", "État du candidat"),
     mainSkills: z.string().optional().describe("Compétences principales"),
     note: z.string().optional().describe("Notes"),
+    address: z.string().optional().describe("Adresse (rue et numéro)"),
+    postcode: z.string().optional().describe("Code postal"),
+    town: z.string().optional().describe("Ville, telle que stockée par l'onglet Information (`town`)"),
+    availability: z
+        .number()
+        .int()
+        .optional()
+        .describe("Disponibilité : ID numérique du dictionnaire `setting.availability`"),
+    mobilityAreas: z
+        .array(z.string())
+        .optional()
+        .describe("Zones de mobilité : IDs du dictionnaire `setting.mobilityArea` (ex: 'mondeeuropebelgique'). " +
+        "Remplace la liste existante : relire l'onglet Information et fusionner avant d'appeler."),
+    globalEvaluation: z
+        .string()
+        .optional()
+        .describe("Évaluation globale : ID du dictionnaire `setting.evaluation` (ex: 'a', 'b', 'c', 'd')"),
+    informationComments: z.string().optional().describe("Commentaires de l'onglet Information"),
 })
     .strict();
 // ---- Resource schemas ----
@@ -569,7 +577,7 @@ export const ResourceCreateSchema = z
     .strict();
 export const ResourceUpdateSchema = z
     .object({
-    id: z.string().min(1).describe("ID de la ressource à modifier"),
+    id: EntityIdSchema.describe("ID de la ressource à modifier"),
     firstName: z.string().optional().describe("Prénom"),
     lastName: z.string().optional().describe("Nom"),
     email1: z.string().email().optional().describe("Email principal"),
@@ -600,7 +608,7 @@ const technicalDataLanguageItemSchema = z
     .strict();
 export const ResourceTechnicalDataUpdateSchema = z
     .object({
-    id: z.string().min(1).describe("ID de la ressource dont le dossier technique est mis à jour."),
+    id: EntityIdSchema.describe("ID de la ressource dont le dossier technique est mis à jour."),
     mode: z
         .enum(["merge", "replace"])
         .default("merge")
@@ -620,6 +628,64 @@ export const ResourceTechnicalDataUpdateSchema = z
         .describe("Diplômes (texte libre, ex: 'DUT Informatique - IUT Bordeaux (2016)')."),
 })
     .strict();
+// ---- Candidate technical-data (DT) write schema ----
+// Same payload as the resource DT (PUT /candidates/{id}/technical-data, type=candidate).
+// Scalars experience/training and the area lists take dictionary IDs, not free text.
+export const CandidateTechnicalDataUpdateSchema = z
+    .object({
+    id: EntityIdSchema.describe("ID du candidat dont le dossier technique est mis à jour."),
+    mode: z
+        .enum(["merge", "replace"])
+        .default("merge")
+        .describe("'merge' (défaut) enrichit le DT sans rien écraser. 'replace' remplace intégralement chaque champ fourni."),
+    title: z.string().optional().describe("Titre / poste."),
+    summary: z.string().optional().describe("Résumé / synthèse du parcours (Profile Summary)."),
+    skills: z.string().optional().describe("Compétences libres, séparées par virgule."),
+    experience: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe("Tranche d'expérience : ID numérique du dictionnaire `setting.experience`."),
+    training: z.string().optional().describe("Niveau de formation : ID du dictionnaire `setting.training`."),
+    expertiseAreas: z
+        .array(z.string())
+        .optional()
+        .describe("Domaines d'expertise : IDs du dictionnaire `setting.expertiseArea`."),
+    activityAreas: z
+        .array(z.string())
+        .optional()
+        .describe("Secteurs / profils : IDs du dictionnaire `setting.activityArea` (options des groupes)."),
+    tools: z.array(technicalDataToolItemSchema).optional().describe("Outils maîtrisés avec niveau (1-4)."),
+    languages: z.array(technicalDataLanguageItemSchema).optional().describe("Langues parlées avec niveau."),
+    diplomas: z
+        .array(z.string())
+        .optional()
+        .describe("Diplômes (texte libre, ex: '2021 - Ingénieur Civil - UCLouvain')."),
+})
+    .strict();
+// ---- Candidate administrative write schema ----
+// PUT /candidates/{id}/administrative, type=candidate. Attribute names mirror the GET payload.
+const salaryRangeSchema = z
+    .object({
+    min: z.number().min(0).describe("Borne basse"),
+    max: z.number().min(0).describe("Borne haute"),
+})
+    .strict();
+export const CandidateAdministrativeUpdateSchema = z
+    .object({
+    id: EntityIdSchema.describe("ID du candidat."),
+    nationality: z.string().optional().describe("Nationalité (texte, ex: 'Belgique')."),
+    desiredSalary: salaryRangeSchema.optional().describe("Salaire souhaité (fourchette min / max)."),
+    actualSalary: z.number().min(0).optional().describe("Salaire actuel."),
+    desiredContract: z
+        .number()
+        .int()
+        .optional()
+        .describe("Contrat souhaité : ID du dictionnaire `setting.typeOf.contract` (-1 = non renseigné)."),
+    administrativeComments: z.string().optional().describe("Commentaires administratifs."),
+})
+    .strict();
 // ---- Reference (DT experience) schemas ----
 // Validated live against the BoondManager API on 2026-05-20: references are NOT a
 // standalone REST entity. They're sub-objects embedded in the resource's DT (the
@@ -646,7 +712,7 @@ const referenceYear = z.coerce
     .describe("Année (ex: 2024). Accepte int ou string '2024'.");
 export const ReferenceCreateSchema = z
     .object({
-    resourceId: z.string().min(1).describe("ID de la ressource à laquelle rattacher la référence."),
+    resourceId: EntityIdSchema.describe("ID de la ressource à laquelle rattacher la référence."),
     title: z.string().min(1).describe("Intitulé du poste."),
     company: z.string().min(1).describe("Société / employeur."),
     description: z
@@ -663,11 +729,8 @@ export const ReferenceCreateSchema = z
     .strict();
 export const ReferenceUpdateSchema = z
     .object({
-    resourceId: z
-        .string()
-        .min(1)
-        .describe("ID de la ressource portant la référence (les references sont embarquées dans le DT)."),
-    referenceId: z.string().min(1).describe("ID de la référence à modifier."),
+    resourceId: EntityIdSchema.describe("ID de la ressource portant la référence (les references sont embarquées dans le DT)."),
+    referenceId: EntityIdSchema.describe("ID de la référence à modifier."),
     title: z.string().optional().describe("Intitulé du poste."),
     company: z.string().optional().describe("Société / employeur."),
     description: z.string().optional().describe("Description / missions / réalisations."),
@@ -681,11 +744,8 @@ export const ReferenceUpdateSchema = z
     .strict();
 export const ReferenceIdSchema = z
     .object({
-    resourceId: z
-        .string()
-        .min(1)
-        .describe("ID de la ressource portant la référence (les references sont embarquées dans le DT)."),
-    referenceId: z.string().min(1).describe("ID de la référence à supprimer."),
+    resourceId: EntityIdSchema.describe("ID de la ressource portant la référence (les references sont embarquées dans le DT)."),
+    referenceId: EntityIdSchema.describe("ID de la référence à supprimer."),
 })
     .strict();
 // ---- Contact schemas ----
@@ -698,13 +758,13 @@ export const ContactCreateSchema = z
     city: z.string().optional().describe("Ville"),
     country: z.string().optional().describe("Pays"),
     title: z.string().optional().describe("Titre / fonction"),
-    companyId: z.string().optional().describe("ID de la société associée"),
+    companyId: EntityIdSchema.optional().describe("ID de la société associée"),
     note: z.string().optional().describe("Notes"),
 })
     .strict();
 export const ContactUpdateSchema = z
     .object({
-    id: z.string().min(1).describe("ID du contact à modifier"),
+    id: EntityIdSchema.describe("ID du contact à modifier"),
     firstName: z.string().optional().describe("Prénom"),
     lastName: z.string().optional().describe("Nom"),
     email1: z.string().email().optional().describe("Email"),
@@ -730,7 +790,7 @@ export const CompanyCreateSchema = z
     .strict();
 export const CompanyUpdateSchema = z
     .object({
-    id: z.string().min(1).describe("ID de la société à modifier"),
+    id: EntityIdSchema.describe("ID de la société à modifier"),
     name: z.string().optional().describe("Nom"),
     email1: z.string().email().optional().describe("Email"),
     phone1: z.string().optional().describe("Téléphone"),
@@ -759,8 +819,8 @@ const opportunityWritableShape = {
         .min(1)
         .optional()
         .describe("Type d'opportunité : ID numérique du dictionnaire setting.typeOf.project (ex: 1, 3), via boond_application_dictionary"),
-    companyId: z.string().optional().describe("ID de la société cliente (relation company)"),
-    contactId: z.string().optional().describe("ID du contact associé (relation contact)"),
+    companyId: EntityIdSchema.optional().describe("ID de la société cliente (relation company)"),
+    contactId: EntityIdSchema.optional().describe("ID du contact associé (relation contact)"),
     state: stateField("opportunity", "État de l'opportunité"),
     startDate: z.string().optional().describe("Date de début prévue (YYYY-MM-DD ou 'immediate')"),
     endDate: z.string().optional().describe("Date de fin prévue (YYYY-MM-DD)"),
@@ -779,13 +839,10 @@ const opportunityWritableShape = {
         .optional()
         .describe("Domaine d'expertise : ID du dictionnaire setting.expertiseArea (via boond_application_dictionary)"),
     turnoverEstimatedExcludingTax: z.coerce.number().optional().describe("Chiffre d'affaires estimé HT (montant)"),
-    poleId: z.string().optional().describe("ID du pôle (relation pole)"),
-    hrManagerId: z.string().optional().describe("ID de la ressource responsable RH (relation hrManager)"),
-    mainManagerId: z
-        .string()
-        .optional()
-        .describe("ID de la ressource responsable principal / commercial (relation mainManager)"),
-    agencyId: z.string().optional().describe("ID de l'agence (relation agency)"),
+    poleId: EntityIdSchema.optional().describe("ID du pôle (relation pole)"),
+    hrManagerId: EntityIdSchema.optional().describe("ID de la ressource responsable RH (relation hrManager)"),
+    mainManagerId: EntityIdSchema.optional().describe("ID de la ressource responsable principal / commercial (relation mainManager)"),
+    agencyId: EntityIdSchema.optional().describe("ID de l'agence (relation agency)"),
 };
 export const OpportunityCreateSchema = z
     .object({
@@ -795,22 +852,35 @@ export const OpportunityCreateSchema = z
     .strict();
 export const OpportunityUpdateSchema = z
     .object({
-    id: z.string().min(1).describe("ID de l'opportunité à modifier"),
+    id: EntityIdSchema.describe("ID de l'opportunité à modifier"),
     name: z.string().optional().describe("Nom / titre"),
     ...opportunityWritableShape,
 })
     .strict();
 // ---- Action schemas ----
+// Source: resources/actions/search.raml (filters verified live, issue #248).
 export const ActionSearchSchema = z
     .object({
     keywords: z.string().optional().describe("Mots-clés de recherche"),
-    candidateId: z.string().optional().describe("Filtrer par ID candidat"),
-    resourceId: z.string().optional().describe("Filtrer par ID ressource"),
-    contactId: z.string().optional().describe("Filtrer par ID contact"),
-    companyId: z.string().optional().describe("Filtrer par ID société"),
-    page: z.number().int().min(1).max(MAX_SEARCH_PAGE).default(1).describe(`Numéro de page (max: ${MAX_SEARCH_PAGE})`),
-    pageSize: z.number().int().min(1).max(MAX_PAGE_SIZE).default(DEFAULT_PAGE_SIZE).describe("Résultats par page"),
-    fields: fieldsField,
+    candidateId: EntityIdSchema.optional().describe("Filtrer par ID candidat (référence keywords CAND<id>)"),
+    resourceId: EntityIdSchema.optional().describe("Filtrer par ID ressource (référence keywords COMP<id>)"),
+    contactId: EntityIdSchema.optional().describe("Filtrer par ID contact (référence keywords CCON<id>)"),
+    companyId: EntityIdSchema.optional().describe("Filtrer par ID société (référence keywords CSOC<id>)"),
+    opportunityId: EntityIdSchema.optional().describe("Filtrer par ID opportunité (référence keywords AO<id>)"),
+    projectId: EntityIdSchema.optional().describe("Filtrer par ID projet (référence keywords PRJ<id>)"),
+    orderId: EntityIdSchema.optional().describe("Filtrer par ID bon de commande (référence keywords BDC<id>)"),
+    invoiceId: EntityIdSchema.optional().describe("Filtrer par ID facture (référence keywords FACT<id>)"),
+    actionTypes: intArray("IDs de types d'action — `boond://dictionary/actions/<entité>` (les types sont déclarés par entité de rattachement)."),
+    period: z
+        .enum(["started", "created", "updated"])
+        .optional()
+        .describe("Champ de date borné par `startDate` / `endDate` : started (date de l'action), created, updated."),
+    periodDynamic: periodDynamicField,
+    startDate: startDateField,
+    endDate: endDateField,
+    flags: flagsField,
+    ...perimeterShape,
+    ...sortedPaginationShape,
 })
     .strict();
 // POST /actions requires a polymorphic `dependsOn` relationship (the entity the
@@ -831,16 +901,13 @@ export const ActionCreateSchema = z
         .optional()
         .describe("Date de début au format ISO 8601 avec timezone (ex: 2026-06-05T10:00:00+0200)"),
     endDate: z.string().regex(actionDateTimeRegex).optional().describe("Date de fin (même format que startDate)"),
-    candidateId: z.string().optional().describe("ID du candidat auquel rattacher l'action (dependsOn)"),
-    resourceId: z.string().optional().describe("ID de la ressource à laquelle rattacher l'action (dependsOn)"),
-    contactId: z.string().optional().describe("ID du contact auquel rattacher l'action (dependsOn)"),
-    opportunityId: z.string().optional().describe("ID de l'opportunité à laquelle rattacher l'action (dependsOn)"),
-    projectId: z.string().optional().describe("ID du projet auquel rattacher l'action (dependsOn)"),
-    companyId: z.string().optional().describe("ID de la société associée (uniquement en complément d'un contactId)"),
-    positioningId: z
-        .string()
-        .optional()
-        .describe("ID du positionnement à lier à l'action (relation positioning). Requis par l'API pour les types d'action liés aux positionnements (ex. RQ) — sans lui, erreur 422 « 1002 - Wrong or missing attribute (/data/relationships/positioning) »."),
+    candidateId: EntityIdSchema.optional().describe("ID du candidat auquel rattacher l'action (dependsOn)"),
+    resourceId: EntityIdSchema.optional().describe("ID de la ressource à laquelle rattacher l'action (dependsOn)"),
+    contactId: EntityIdSchema.optional().describe("ID du contact auquel rattacher l'action (dependsOn)"),
+    opportunityId: EntityIdSchema.optional().describe("ID de l'opportunité à laquelle rattacher l'action (dependsOn)"),
+    projectId: EntityIdSchema.optional().describe("ID du projet auquel rattacher l'action (dependsOn)"),
+    companyId: EntityIdSchema.optional().describe("ID de la société associée (uniquement en complément d'un contactId)"),
+    positioningId: EntityIdSchema.optional().describe("ID du positionnement à lier à l'action (relation positioning). Requis par l'API pour les types d'action liés aux positionnements (ex. RQ) — sans lui, erreur 422 « 1002 - Wrong or missing attribute (/data/relationships/positioning) »."),
 })
     .strict();
 // PUT /actions/{id} (PATCH renvoie 405). Mise à jour partielle des seuls
@@ -850,7 +917,7 @@ export const ActionCreateSchema = z
 // de résolution de libellé, faute d'entité `dependsOn` connue sur l'update).
 export const ActionUpdateSchema = z
     .object({
-    id: z.string().min(1).describe("ID de l'action à modifier"),
+    id: EntityIdSchema.describe("ID de l'action à modifier"),
     typeOf: z.coerce
         .number()
         .int()
@@ -870,7 +937,7 @@ export const ActionUpdateSchema = z
 // ---- Timesheet schemas ----
 export const ResourceTimesheetSchema = z
     .object({
-    resourceId: z.string().min(1).describe("ID de la ressource"),
+    resourceId: EntityIdSchema.describe("ID de la ressource"),
     month: z.number().int().min(1).max(12).optional().describe("Mois (1-12). Si omis, mois courant."),
     year: z.number().int().min(2000).optional().describe("Année (ex: 2025). Si omis, année courante."),
 })
@@ -889,28 +956,103 @@ export const TimesheetSearchSchema = z
         .regex(/^\d{4}-\d{2}$/)
         .describe("Mois de fin au format YYYY-MM (ex: '2025-03'). Requis."),
     keywords: z.string().optional().describe("Mots-clés (préfixes 'TPS', 'COMP'...)."),
-    page: z.number().int().min(1).max(MAX_SEARCH_PAGE).default(1).describe(`Numéro de page (max: ${MAX_SEARCH_PAGE})`),
-    pageSize: z
+    resourceId: EntityIdSchema.optional().describe("Filtrer par ID ressource (référence keywords COMP<id>)"),
+    resourceTypes: resourceTypesField,
+    validationStates: validationStatesField,
+    closed: z.boolean().optional().describe("true = CRA clôturés uniquement, false = non clôturés."),
+    ...perimeterShape,
+    ...sortedPaginationShape,
+})
+    .strict();
+// ---- Timesheet (CRA) write schemas (issue #249) ----
+//
+// A times report is a monthly container per resource (`term` + `resource`)
+// whose lines live in `regularTimes[]` / `exceptionalTimes[]` — the exact
+// twin of the expenses report (#179). The line shape below is the one the API
+// *returns* (`GET /times-reports/{id}`, `models.time` in the dictionary, and
+// the `plannedTimes` of `/times-reports/default`): `startDate`, `duration`,
+// `workUnitType.reference`, `project`, `delivery`, `batch`. `state` is moved by
+// the validation workflow (`validated`, `waitingForValidation`…) and is not a
+// write field. See CLAUDE.md → *Timesheets* for what was and was not verified
+// against the live API.
+export const TimesheetLineSchema = z
+    .object({
+    startDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .describe("Jour saisi (YYYY-MM-DD). Doit tomber dans le mois `term` du CRA."),
+    duration: z
+        .number()
+        .positive()
+        .default(1)
+        .describe("Durée en unités d'œuvre (jour par défaut : 1 = journée, 0.5 = demi-journée)."),
+    workUnitTypeReference: z
         .number()
         .int()
-        .min(1)
-        .max(MAX_PAGE_SIZE)
-        .default(DEFAULT_PAGE_SIZE)
-        .describe(`Nombre de résultats par page (max: ${MAX_PAGE_SIZE}, défaut: ${DEFAULT_PAGE_SIZE})`),
+        .default(1)
+        .describe("Code `reference` du type d'unité d'œuvre — voir `boond_timesheets_default` (`workUnitTypesAllowed` de la ressource). " +
+        "1 = « Normale » (production) sur les tenants observés ; les absences (congés, RTT, maladie…) ont leurs propres codes."),
+    projectId: EntityIdSchema.optional().describe("ID du projet imputé. Requis pour une activité de production ; absent pour une absence. Couples autorisés : `boond_timesheets_default`."),
+    deliveryId: EntityIdSchema.optional().describe("ID de la prestation (delivery) imputée. Requis avec `projectId` pour la production — voir `boond_timesheets_default`."),
+    batchId: EntityIdSchema.optional().describe("ID du lot. Absent = aucun lot."),
+})
+    .strict();
+export const TimesheetCreateSchema = z
+    .object({
+    resourceId: EntityIdSchema.describe("ID de la ressource (le collaborateur dont c'est le CRA)."),
+    agencyId: EntityIdSchema.optional().describe("ID de l'agence — voir `boond_timesheets_default`. Déduite de la ressource si omise."),
+    term: z
+        .string()
+        .regex(/^\d{4}-\d{2}$/)
+        .describe("Mois du CRA (YYYY-MM). Un CRA = un mois × une ressource ; l'API ne déduplique pas."),
+    informationComments: z.string().optional().describe("Commentaires du CRA."),
+    regularTimes: z
+        .array(TimesheetLineSchema)
+        .optional()
+        .describe("Lignes d'activité normale (production et absences). Omettre pour créer un CRA vide."),
+    exceptionalTimes: z
+        .array(TimesheetLineSchema)
+        .optional()
+        .describe("Lignes d'activité exceptionnelle (interventions, astreintes) — types `exceptionalTime` / `exceptionalCalendar`."),
+})
+    .strict();
+export const TimesheetUpdateSchema = z
+    .object({
+    id: EntityIdSchema.describe("ID du CRA à modifier"),
+    informationComments: z.string().optional().describe("Commentaires"),
+    closed: z.boolean().optional().describe("Clôturer le CRA"),
+    regularTimes: z
+        .array(TimesheetLineSchema)
+        .optional()
+        .describe("⚠️ Remplace TOUTES les lignes d'activité normale — envoyer la liste complète (relire le CRA avec `boond_timesheets_get` et fusionner), pas seulement les ajouts."),
+    exceptionalTimes: z
+        .array(TimesheetLineSchema)
+        .optional()
+        .describe("⚠️ Remplace TOUTES les lignes d'activité exceptionnelle — même règle que `regularTimes`."),
+})
+    .strict();
+export const TimesheetDefaultSchema = z
+    .object({
+    resourceId: EntityIdSchema.describe("ID de la ressource"),
+    term: z
+        .string()
+        .regex(/^\d{4}-\d{2}$/)
+        .describe("Mois du CRA (YYYY-MM)"),
+    agencyId: EntityIdSchema.optional().describe("ID de l'agence, si la ressource en a plusieurs"),
 })
     .strict();
 export const TimesheetGetSchema = z
     .object({
-    id: z.string().min(1).describe("Identifiant unique de la feuille de temps"),
+    id: EntityIdSchema.describe("Identifiant unique de la feuille de temps"),
 })
     .strict();
 // ---- Project schemas ----
 export const ProjectCreateSchema = z
     .object({
     name: z.string().min(1).describe("Nom du projet / mission"),
-    companyId: z.string().optional().describe("ID de la société cliente"),
-    contactId: z.string().optional().describe("ID du contact associé"),
-    opportunityId: z.string().optional().describe("ID de l'opportunité liée"),
+    companyId: EntityIdSchema.optional().describe("ID de la société cliente"),
+    contactId: EntityIdSchema.optional().describe("ID du contact associé"),
+    opportunityId: EntityIdSchema.optional().describe("ID de l'opportunité liée"),
     typeOf: z.number().int().optional().describe("Type de projet (ID du dictionnaire setting.typeOf.project)"),
     state: stateField("project", "État du projet (0=en cours, 1=terminé, 2=archivé...)"),
     startDate: z.string().optional().describe("Date de début (YYYY-MM-DD)"),
@@ -920,7 +1062,7 @@ export const ProjectCreateSchema = z
     .strict();
 export const ProjectUpdateSchema = z
     .object({
-    id: z.string().min(1).describe("ID du projet à modifier"),
+    id: EntityIdSchema.describe("ID du projet à modifier"),
     name: z.string().optional().describe("Nom du projet"),
     typeOf: z.number().int().optional().describe("Type de projet (ID du dictionnaire setting.typeOf.project)"),
     state: stateField("project", "État du projet"),
@@ -930,13 +1072,29 @@ export const ProjectUpdateSchema = z
 })
     .strict();
 // ---- Invoice schemas ----
+// API pattern is `^|YYYY-MM-DD$`: an empty string clears the date.
+const performedPaymentDateField = z
+    .union([z.string().regex(/^\d{4}-\d{2}-\d{2}$/), z.literal("")])
+    .optional()
+    .describe("Date de règlement effectif (YYYY-MM-DD, `\"\"` pour l'effacer). À envoyer dans le même appel que le passage de `state` à l'état « payée » : sans elle, BoondManager date le règlement du jour du changement d'état. Si la date est encore écrasée, rappeler `boond_invoices_update` avec ce seul champ.");
+const invoicePaymentMethodField = z
+    .number()
+    .int()
+    .min(-1)
+    .optional()
+    .describe("Mode de règlement : ID de `boond://dictionary/paymentMethods`");
 export const InvoiceCreateSchema = z
     .object({
     reference: z.string().optional().describe("Référence de la facture"),
-    orderId: z.string().optional().describe("ID du bon de commande associé"),
-    state: z.number().int().optional().describe("État de la facture"),
+    orderId: EntityIdSchema.optional().describe("ID du bon de commande associé"),
+    state: stateField("invoice", "État de la facture : ID de `boond://dictionary/states/invoices` (ex: 0 = Création, 1 = Transmis au client)"),
     invoiceDate: z.string().optional().describe("Date de facturation (YYYY-MM-DD)"),
-    expectedPaymentDate: z.string().optional().describe("Date d'échéance/paiement attendu (YYYY-MM-DD)"),
+    expectedPaymentDate: z
+        .string()
+        .optional()
+        .describe("Date d'échéance (YYYY-MM-DD) — pas la date de règlement, voir `performedPaymentDate`"),
+    performedPaymentDate: performedPaymentDateField,
+    paymentMethod: invoicePaymentMethodField,
     amountExcludingTax: z.number().optional().describe("Montant HT"),
     taxRate: z.number().optional().describe("Taux de TVA (%)"),
     invoiceRecords: z.array(z.record(z.string(), z.unknown())).optional().describe("Lignes de facture Boond"),
@@ -946,11 +1104,16 @@ export const InvoiceCreateSchema = z
     .strict();
 export const InvoiceUpdateSchema = z
     .object({
-    id: z.string().min(1).describe("ID de la facture à modifier"),
+    id: EntityIdSchema.describe("ID de la facture à modifier"),
     reference: z.string().optional().describe("Référence de la facture"),
-    state: z.number().int().optional().describe("État de la facture"),
+    state: stateField("invoice", "État de la facture : ID de `boond://dictionary/states/invoices` (ex: 0 = Création, 1 = Transmis au client)"),
     invoiceDate: z.string().optional().describe("Date de facturation (YYYY-MM-DD)"),
-    expectedPaymentDate: z.string().optional().describe("Date d'échéance/paiement attendu (YYYY-MM-DD)"),
+    expectedPaymentDate: z
+        .string()
+        .optional()
+        .describe("Date d'échéance (YYYY-MM-DD) — pas la date de règlement, voir `performedPaymentDate`"),
+    performedPaymentDate: performedPaymentDateField,
+    paymentMethod: invoicePaymentMethodField,
     amountExcludingTax: z.number().optional().describe("Montant HT"),
     taxRate: z.number().optional().describe("Taux de TVA (%)"),
     invoiceRecords: z.array(z.record(z.string(), z.unknown())).optional().describe("Lignes de facture Boond"),
@@ -958,29 +1121,42 @@ export const InvoiceUpdateSchema = z
     note: z.string().optional().describe("Notes"),
 })
     .strict();
+// Source: resources/invoices/search.raml (filters verified live, issue #248).
 export const InvoiceSearchSchema = z
     .object({
     keywords: z.string().optional().describe("Mots-clés de recherche (référence, société...)"),
-    companyId: z.string().optional().describe("Filtrer par ID société"),
-    projectId: z.string().optional().describe("Filtrer par ID projet"),
-    startDate: z.string().optional().describe("Date de début de période (YYYY-MM-DD)"),
-    endDate: z.string().optional().describe("Date de fin de période (YYYY-MM-DD)"),
+    companyId: EntityIdSchema.optional().describe("Filtrer par ID société (référence keywords CSOC<id>)"),
+    projectId: EntityIdSchema.optional().describe("Filtrer par ID projet (référence keywords PRJ<id>)"),
+    contactId: EntityIdSchema.optional().describe("Filtrer par ID contact (référence keywords CCON<id>)"),
+    orderId: EntityIdSchema.optional().describe("Filtrer par ID bon de commande (référence keywords BDC<id>)"),
+    states: intArray("IDs d'états de facture — `boond://dictionary/states/invoices` (ex. impayées = tous les états sauf « payée »)."),
+    projectTypes: projectTypesFilterField,
+    paymentMethods: paymentMethodsField,
+    companies: companiesFilterField,
+    closed: z
+        .boolean()
+        .optional()
+        .describe("true = factures / avoirs clôturés uniquement, false = non clôturés uniquement."),
+    creditNote: z.boolean().optional().describe("true = avoirs uniquement, false = factures uniquement."),
     period: z
-        .string()
+        .enum(["created", "updated", "expectedPayment", "performedPayment", "period"])
         .optional()
-        .describe("Type de période (created, updated, expectedPayment, performedPayment, period)"),
-    page: z.number().int().min(1).max(MAX_SEARCH_PAGE).default(1).describe(`Numéro de page (max: ${MAX_SEARCH_PAGE})`),
-    pageSize: z.number().int().min(1).max(MAX_PAGE_SIZE).default(DEFAULT_PAGE_SIZE).describe("Résultats par page"),
-    fields: fieldsField,
+        .describe("Champ de date borné par `startDate` / `endDate` : created, updated, expectedPayment (échéance), performedPayment (règlement), period (période facturée, défaut)."),
+    periodDynamic: periodDynamicField,
+    startDate: startDateField,
+    endDate: endDateField,
+    flags: flagsField,
+    ...perimeterShape,
+    ...sortedPaginationShape,
 })
     .strict();
 // ---- Order schemas (Bons de commande) ----
 export const OrderCreateSchema = z
     .object({
     reference: z.string().optional().describe("Référence du bon de commande"),
-    companyId: z.string().optional().describe("ID de la société"),
-    projectId: z.string().optional().describe("ID du projet associé"),
-    state: z.number().int().optional().describe("État du bon de commande"),
+    companyId: EntityIdSchema.optional().describe("ID de la société"),
+    projectId: EntityIdSchema.optional().describe("ID du projet associé"),
+    state: stateField("order", "État du bon de commande : ID de `boond://dictionary/states/orders`"),
     orderDate: z.string().optional().describe("Date du bon de commande (YYYY-MM-DD)"),
     startDate: z.string().optional().describe("Date de début couverte (YYYY-MM-DD)"),
     endDate: z.string().optional().describe("Date de fin couverte (YYYY-MM-DD)"),
@@ -992,9 +1168,9 @@ export const OrderCreateSchema = z
     .strict();
 export const OrderUpdateSchema = z
     .object({
-    id: z.string().min(1).describe("ID du bon de commande à modifier"),
+    id: EntityIdSchema.describe("ID du bon de commande à modifier"),
     reference: z.string().optional().describe("Référence"),
-    state: z.number().int().optional().describe("État"),
+    state: stateField("order", "État du bon de commande : ID de `boond://dictionary/states/orders`"),
     orderDate: z.string().optional().describe("Date (YYYY-MM-DD)"),
     startDate: z.string().optional().describe("Date de début couverte (YYYY-MM-DD)"),
     endDate: z.string().optional().describe("Date de fin couverte (YYYY-MM-DD)"),
@@ -1004,61 +1180,197 @@ export const OrderUpdateSchema = z
     note: z.string().optional().describe("Notes"),
 })
     .strict();
+// Source: resources/orders/search.raml (filters verified live, issue #248).
 export const OrderSearchSchema = z
     .object({
     keywords: z.string().optional().describe("Mots-clés de recherche"),
-    companyId: z.string().optional().describe("Filtrer par ID société"),
-    projectId: z.string().optional().describe("Filtrer par ID projet"),
-    page: z.number().int().min(1).max(MAX_SEARCH_PAGE).default(1).describe(`Numéro de page (max: ${MAX_SEARCH_PAGE})`),
-    pageSize: z.number().int().min(1).max(MAX_PAGE_SIZE).default(DEFAULT_PAGE_SIZE).describe("Résultats par page"),
-    fields: fieldsField,
+    companyId: EntityIdSchema.optional().describe("Filtrer par ID société (référence keywords CSOC<id>)"),
+    projectId: EntityIdSchema.optional().describe("Filtrer par ID projet (référence keywords PRJ<id>)"),
+    contactId: EntityIdSchema.optional().describe("Filtrer par ID contact (référence keywords CCON<id>)"),
+    states: intArray("IDs d'états de bon de commande — `boond://dictionary/states/orders`."),
+    projectTypes: projectTypesFilterField,
+    paymentMethods: paymentMethodsField,
+    companies: companiesFilterField,
+    customerAgreement: z.boolean().optional().describe("true = accord client reçu uniquement, false = sans accord."),
+    exceededOrderedTurnover: z
+        .boolean()
+        .optional()
+        .describe("true = commandes dont le facturé dépasse le montant commandé."),
+    period: z
+        .enum(["created", "updated", "period"])
+        .optional()
+        .describe("Champ de date borné par `startDate` / `endDate` : created, updated, period (période couverte)."),
+    periodDynamic: periodDynamicField,
+    startDate: startDateField,
+    endDate: endDateField,
+    flags: flagsField,
+    ...perimeterShape,
+    ...sortedPaginationShape,
 })
     .strict();
 // ---- Delivery schemas (Livraisons / CRA) ----
+// Source: resources/deliveriesGroupments/search.raml — the list route of the
+// deliveries domain (filters verified live, issue #248).
 export const DeliverySearchSchema = z
     .object({
     keywords: z.string().optional().describe("Mots-clés de recherche"),
-    projectId: z.string().optional().describe("Filtrer par ID projet"),
-    companyId: z.string().optional().describe("Filtrer par ID société"),
+    projectId: EntityIdSchema.optional().describe("Filtrer par ID projet (référence keywords PRJ<id>)"),
+    companyId: EntityIdSchema.optional().describe("Filtrer par ID société (référence keywords CSOC<id>)"),
+    resourceId: EntityIdSchema.optional().describe("Filtrer par ID ressource (référence keywords COMP<id>)"),
+    opportunityId: EntityIdSchema.optional().describe("Filtrer par ID opportunité (référence keywords AO<id>)"),
+    projectTypes: projectTypesFilterField,
+    projectStates: intArray("IDs d'états de projet — `boond://dictionary/states/projects`."),
+    deliveryStates: intArray("IDs d'états de prestation — `boond://dictionary/states/deliveries`."),
+    expertiseAreas: strArray("Domaines d'expertise — `boond://dictionary/expertiseAreas`."),
+    transferType: z
+        .enum(["master", "slave", "none", "notSlave", "notMaster", "missing"])
+        .optional()
+        .describe("Filtre sur les transferts de prestation (master / slave / none / notSlave / notMaster / missing)."),
+    period: z
+        .enum(["started", "updated", "stopped", "projectRunning", "running", "hasAdditionalDataOrPurchase"])
+        .optional()
+        .describe("Champ de date borné par `startDate` / `endDate` : started, stopped, updated, running (prestations en cours sur la fenêtre), projectRunning (projet en cours)."),
+    periodDynamic: periodDynamicField,
+    startDate: startDateField,
+    endDate: endDateField,
+    companies: companiesFilterField,
+    flags: flagsField,
+    ...perimeterShape,
+    ...sortedPaginationShape,
+})
+    .strict();
+export const DeliveryCreateSchema = z
+    .object({
+    projectId: EntityIdSchema.describe("ID du projet"),
+    resourceId: EntityIdSchema.describe("ID de la ressource portée par la prestation"),
+    title: z.string().optional().describe("Titre de la prestation/livraison"),
+    typeOf: z.number().int().optional().describe("Type de prestation : ID de `boond://dictionary/typeOf/deliveries`"),
+    state: stateField("delivery", "État de la prestation : ID de `boond://dictionary/states/deliveries`"),
     startDate: z.string().optional().describe("Date de début (YYYY-MM-DD)"),
     endDate: z.string().optional().describe("Date de fin (YYYY-MM-DD)"),
-    page: z.number().int().min(1).max(MAX_SEARCH_PAGE).default(1).describe(`Numéro de page (max: ${MAX_SEARCH_PAGE})`),
-    pageSize: z.number().int().min(1).max(MAX_PAGE_SIZE).default(DEFAULT_PAGE_SIZE).describe("Résultats par page"),
-    fields: fieldsField,
+    quantity: z.number().optional().describe("Nombre de jours / quantité"),
+    unitPrice: z.number().optional().describe("Prix journalier HT"),
+    averageDailyCost: z.number().optional().describe("Coût journalier moyen"),
+    forceAverageDailyPriceExcludingTax: z.boolean().optional().describe("Forcer le prix journalier HT"),
+    note: z.string().optional().describe("Notes, mappées vers informationComments"),
+})
+    .strict();
+// PUT /deliveries/{id} — attributes only, the project / resource attachment
+// is not moved by an update (issue #252; write path not exercised, see CLAUDE.md).
+export const DeliveryUpdateSchema = z
+    .object({
+    id: EntityIdSchema.describe("ID de la prestation à modifier"),
+    title: z.string().optional().describe("Titre de la prestation"),
+    typeOf: z.number().int().optional().describe("Type de prestation : ID de `boond://dictionary/typeOf/deliveries`"),
+    state: stateField("delivery", "État de la prestation : ID de `boond://dictionary/states/deliveries`"),
+    startDate: z.string().optional().describe("Date de début (YYYY-MM-DD)"),
+    endDate: z
+        .string()
+        .optional()
+        .describe("Date de fin (YYYY-MM-DD) — prolonger une prestation = repousser cette date"),
+    quantity: z.number().optional().describe("Nombre de jours / quantité (`numberOfDaysInvoicedOrQuantity`)"),
+    unitPrice: z.number().optional().describe("Prix journalier HT (`averageDailyPriceExcludingTax`, forcé)"),
+    averageDailyCost: z.number().optional().describe("Coût journalier moyen"),
+    note: z.string().optional().describe("Notes, mappées vers informationComments"),
 })
     .strict();
 // ---- Absence schemas ----
+/** `GET /absences-reports/default?resource=&agency=` (issue #257) — the absence types are published there only. */
+export const AbsenceDefaultSchema = z
+    .object({
+    resourceId: EntityIdSchema.describe("ID de la ressource (requis par l'API)."),
+    agencyId: EntityIdSchema.optional().describe("ID de l'agence — déduite de la ressource si omise."),
+})
+    .strict();
 export const AbsenceCreateSchema = z
     .object({
-    resourceId: z.string().min(1).describe("ID de la ressource en absence"),
-    typeOf: z.string().min(1).describe("Libellé de l'absence (congé payé, RTT, maladie, sans solde...)"),
+    resourceId: EntityIdSchema.describe("ID de la ressource en absence"),
+    typeOf: z
+        .string()
+        .min(1)
+        .describe("Libellé de l'absence (congé payé, RTT, maladie, sans solde...) — porté par `title` ; le type effectif est `workUnitTypeReference`."),
     startDate: z.string().min(1).describe("Date de début (YYYY-MM-DD)"),
     endDate: z.string().min(1).describe("Date de fin (YYYY-MM-DD)"),
     duration: z.number().optional().describe("Durée en jours ; calculée automatiquement si absente"),
-    workUnitTypeReference: z.number().int().min(1).optional().describe("Référence du type d'unité d'absence, défaut 1"),
+    workUnitTypeReference: z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .describe("Code `reference` du type d'absence, publié par `boond_absences_default` (`workUnitTypesAllowed` de la ressource : RTT, maladie, congés payés…) — nulle part ailleurs. Défaut 1 (à confirmer avec le default)."),
     absencesPeriods: z.array(z.record(z.string(), z.unknown())).optional().describe("Périodes d'absence Boond brutes"),
-    state: z.number().int().optional().describe("État de la demande (0=en attente, 1=validé, 2=refusé...)"),
+    // No `state` (issue #250): on `/absences-reports` it is a validation-workflow
+    // string (`waitingForValidation`, `validated`…), not a dictionary integer,
+    // and it is moved by the workflow — same finding as `/expenses-reports`.
     note: z.string().optional().describe("Commentaire / motif"),
 })
     .strict();
 export const AbsenceUpdateSchema = z
     .object({
-    id: z.string().min(1).describe("ID de l'absence à modifier"),
+    id: EntityIdSchema.describe("ID de l'absence à modifier"),
     startDate: z.string().optional().describe("Date de début (YYYY-MM-DD)"),
     endDate: z.string().optional().describe("Date de fin (YYYY-MM-DD)"),
-    state: z.number().int().optional().describe("État de la demande"),
     note: z.string().optional().describe("Commentaire / motif"),
 })
     .strict();
 export const AbsenceSearchSchema = z
     .object({
     keywords: z.string().optional().describe("Mots-clés de recherche"),
-    resourceId: z.string().optional().describe("Filtrer par ID ressource"),
-    startMonth: z.string().optional().describe("Mois de début de période (YYYY-MM)"),
-    endMonth: z.string().optional().describe("Mois de fin de période (YYYY-MM)"),
-    page: z.number().int().min(1).max(MAX_SEARCH_PAGE).default(1).describe(`Numéro de page (max: ${MAX_SEARCH_PAGE})`),
-    pageSize: z.number().int().min(1).max(MAX_PAGE_SIZE).default(DEFAULT_PAGE_SIZE).describe("Résultats par page"),
-    fields: fieldsField,
+    resourceId: EntityIdSchema.optional().describe("Filtrer par ID ressource (référence keywords COMP<id>)"),
+    // Both are REQUIRED by `GET /absences-reports` (422 `1017 - Missing required
+    // attribute` otherwise — caught by scripts/smoke-live.mjs, issue #244).
+    // Declaring them optional made the tool fail on its most natural call.
+    startMonth: z
+        .string()
+        .regex(/^\d{4}-\d{2}$/, "Format attendu : YYYY-MM")
+        .describe("Mois de début de période (YYYY-MM) — obligatoire pour l'API"),
+    endMonth: z
+        .string()
+        .regex(/^\d{4}-\d{2}$/, "Format attendu : YYYY-MM")
+        .describe("Mois de fin de période (YYYY-MM) — obligatoire pour l'API"),
+    resourceTypes: resourceTypesField,
+    validationStates: validationStatesField,
+    ...perimeterShape,
+    ...sortedPaginationShape,
+})
+    .strict();
+// ---- Contract search (issue #253) ----
+// There is no collection GET on `/contracts` (WAF 403 page, the RAML only
+// documents `post`) and no `/resources/{id}/contracts` tab (404) — probed live
+// on 2026-09-26. A resource's contracts are only reachable through
+// `/resources/{id}/administrative` (`included` of type `contract`). This schema
+// therefore drives a *composed* search: the resource filters select the
+// resources to scan, the contract filters are applied server-side to what
+// their administrative tabs return.
+export const ContractSearchSchema = z
+    .object({
+    resourceId: EntityIdSchema.optional().describe("ID d'une ressource : ne lit que ses contrats (aucune recherche de ressources)."),
+    keywords: z.string().optional().describe("Mots-clés de la recherche de ressources (nom, prénom…)."),
+    resourceStates: intArray("IDs d'états de ressource à parcourir — `boond://dictionary/states/resources`."),
+    resourceTypes: resourceTypesField,
+    ...perimeterShape,
+    contractTypes: intArray("IDs de types de contrat à retenir — `boond://dictionary/typeOf/contracts` (CDI, CDD…)."),
+    period: z
+        .enum(["running", "ending", "starting", "probationEnding"])
+        .optional()
+        .describe("Fenêtre `startDate` / `endDate` appliquée côté serveur : running (contrat en cours sur la fenêtre), ending (fin de contrat dans la fenêtre), starting (début dans la fenêtre), probationEnding (fin de période d'essai — `probationEndDate` ou `renewalProbationEndDate` — dans la fenêtre)."),
+    startDate: startDateField,
+    endDate: endDateField,
+    ...paginationShape,
+})
+    .strict();
+// ---- Validation decision (issue #251) ----
+// `PUT /validations/{id}` with the workflow state the RAML enumerates on
+// `validationStates` (`validated` | `rejected`). No RAML documents the write;
+// the route follows the pattern of every other single-entity PUT and has NOT
+// been exercised (production tenant) — see CLAUDE.md → *Validations*.
+export const ValidationDecisionSchema = z
+    .object({
+    id: EntityIdSchema.describe("ID de la validation (ligne de `boond_validations_search`), pas celui du CRA / de la note / de l'absence."),
+    decision: z
+        .enum(["validate", "reject"])
+        .describe("validate → `validated` ; reject → `rejected` (confirmation demandée à l'utilisateur si le client la supporte)."),
+    reason: z.string().optional().describe("Motif, recommandé sur un refus — transmis dans `reason`."),
 })
     .strict();
 // ---- Expense schemas (Notes de frais) ----
@@ -1128,15 +1440,9 @@ export const ExpenseLineSchema = z
         .describe("`true` pour un frais kilométrique : renseigner `numberOfKilometers` et omettre `expenseTypeReference`."),
     numberOfKilometers: z.number().optional().describe("Nombre de kilomètres (frais kilométrique uniquement)."),
     activityType: z.enum(EXPENSE_ACTIVITY_TYPES).default("production").describe("Type d'activité rattachée au frais."),
-    projectId: z
-        .string()
-        .min(1)
-        .describe("ID du projet à imputer. Obligatoire — les couples (projet, prestation) autorisés sont donnés par `boond_expenses_default`."),
-    deliveryId: z
-        .string()
-        .min(1)
-        .describe("ID de la prestation (delivery) à imputer. Obligatoire — voir `boond_expenses_default`."),
-    batchId: z.string().optional().describe("ID du lot. Absent = aucun lot."),
+    projectId: EntityIdSchema.describe("ID du projet à imputer. Obligatoire — les couples (projet, prestation) autorisés sont donnés par `boond_expenses_default`."),
+    deliveryId: EntityIdSchema.describe("ID de la prestation (delivery) à imputer. Obligatoire — voir `boond_expenses_default`."),
+    batchId: EntityIdSchema.optional().describe("ID du lot. Absent = aucun lot."),
     reinvoiced: z.boolean().default(false).describe("Frais refacturable au client."),
     currency: z.number().int().default(0).describe("ID de devise (`setting.currency`, 0 = EUR)."),
     exchangeRate: z.number().default(1).describe("Taux de change vers la devise agence."),
@@ -1150,11 +1456,8 @@ export const ExpenseLineSchema = z
     .strict();
 export const ExpenseCreateSchema = z
     .object({
-    resourceId: z.string().min(1).describe("ID de la ressource (le collaborateur qui a engagé les frais)."),
-    agencyId: z
-        .string()
-        .optional()
-        .describe("ID de l'agence — voir `boond_expenses_default`. Déduit de la ressource si omis."),
+    resourceId: EntityIdSchema.describe("ID de la ressource (le collaborateur qui a engagé les frais)."),
+    agencyId: EntityIdSchema.optional().describe("ID de l'agence — voir `boond_expenses_default`. Déduit de la ressource si omis."),
     term: z
         .string()
         .regex(/^\d{4}-\d{2}$/)
@@ -1176,7 +1479,7 @@ export const ExpenseCreateSchema = z
     .strict();
 export const ExpenseUpdateSchema = z
     .object({
-    id: z.string().min(1).describe("ID de la note de frais à modifier"),
+    id: EntityIdSchema.describe("ID de la note de frais à modifier"),
     exchangeRateAgency: z.number().optional().describe("Taux de change agence"),
     currencyAgency: z.number().int().optional().describe("ID de devise de l'agence"),
     informationComments: z.string().optional().describe("Commentaires"),
@@ -1192,24 +1495,22 @@ export const ExpenseUpdateSchema = z
     .strict();
 export const ExpenseDefaultSchema = z
     .object({
-    resourceId: z.string().min(1).describe("ID de la ressource"),
+    resourceId: EntityIdSchema.describe("ID de la ressource"),
     term: z
         .string()
         .regex(/^\d{4}-\d{2}$/)
         .describe("Mois ciblé (YYYY-MM)"),
-    agencyId: z.string().optional().describe("ID de l'agence (optionnel — déduit de la ressource)"),
+    agencyId: EntityIdSchema.optional().describe("ID de l'agence (optionnel — déduit de la ressource)"),
 })
     .strict();
 export const ExpenseSearchSchema = z
     .object({
     keywords: z.string().optional().describe("Mots-clés de recherche"),
-    resourceId: z.string().optional().describe("Filtrer par ID ressource"),
-    projectId: z.string().optional().describe("Filtrer par ID projet"),
+    resourceId: EntityIdSchema.optional().describe("Filtrer par ID ressource (référence keywords COMP<id>)"),
+    projectId: EntityIdSchema.optional().describe("Filtrer par ID projet (référence keywords PRJ<id>)"),
     startDate: z.string().optional().describe("Date de début (YYYY-MM-DD)"),
     endDate: z.string().optional().describe("Date de fin (YYYY-MM-DD)"),
-    page: z.number().int().min(1).max(MAX_SEARCH_PAGE).default(1).describe(`Numéro de page (max: ${MAX_SEARCH_PAGE})`),
-    pageSize: z.number().int().min(1).max(MAX_PAGE_SIZE).default(DEFAULT_PAGE_SIZE).describe("Résultats par page"),
-    fields: fieldsField,
+    ...paginationShape,
 })
     .strict();
 // ---- Product schemas ----
@@ -1225,7 +1526,7 @@ export const ProductCreateSchema = z
     .strict();
 export const ProductUpdateSchema = z
     .object({
-    id: z.string().min(1).describe("ID du produit à modifier"),
+    id: EntityIdSchema.describe("ID du produit à modifier"),
     name: z.string().optional().describe("Nom du produit"),
     reference: z.string().optional().describe("Référence"),
     unitPrice: z.number().optional().describe("Prix unitaire HT"),
@@ -1237,11 +1538,11 @@ export const ProductUpdateSchema = z
 // ---- Positioning schemas ----
 export const PositioningCreateSchema = z
     .object({
-    candidateId: z.string().optional().describe("ID du candidat positionné"),
-    resourceId: z.string().optional().describe("ID de la ressource positionnée"),
-    projectId: z.string().optional().describe("ID du projet"),
-    opportunityId: z.string().optional().describe("ID de l'opportunité"),
-    state: z.number().int().optional().describe("État du positionnement"),
+    candidateId: EntityIdSchema.optional().describe("ID du candidat positionné"),
+    resourceId: EntityIdSchema.optional().describe("ID de la ressource positionnée"),
+    projectId: EntityIdSchema.optional().describe("ID du projet"),
+    opportunityId: EntityIdSchema.optional().describe("ID de l'opportunité"),
+    state: stateField("positioning", "État du positionnement : ID de `boond://dictionary/states/positionings` (`won` rattache le positionnement à un projet)"),
     startDate: z.string().optional().describe("Date de début (YYYY-MM-DD)"),
     endDate: z.string().optional().describe("Date de fin (YYYY-MM-DD)"),
     note: z.string().optional().describe("Notes / commentaires"),
@@ -1253,61 +1554,403 @@ export const PositioningSearchSchema = z
         .string()
         .optional()
         .describe("Mots-clés de recherche. L'API y accepte aussi des références d'entités (AO<id>, CAND<id>, COMP<id>...) — les filtres *Id ci-dessous sont convertis automatiquement en de telles références."),
-    candidateId: z
-        .string()
-        .optional()
-        .describe("Filtrer par ID candidat (envoyé à l'API comme référence keywords CAND<id>)"),
-    resourceId: z
-        .string()
-        .optional()
-        .describe("Filtrer par ID ressource (envoyé à l'API comme référence keywords COMP<id>)"),
-    opportunityId: z
-        .string()
-        .optional()
-        .describe("Filtrer par ID opportunité (envoyé à l'API comme référence keywords AO<id>)"),
-    companyId: z
-        .string()
+    candidateId: EntityIdSchema.optional().describe("Filtrer par ID candidat (envoyé à l'API comme référence keywords CAND<id>)"),
+    resourceId: EntityIdSchema.optional().describe("Filtrer par ID ressource (envoyé à l'API comme référence keywords COMP<id>)"),
+    opportunityId: EntityIdSchema.optional().describe("Filtrer par ID opportunité (envoyé à l'API comme référence keywords AO<id>)"),
+    companyId: EntityIdSchema.optional().describe("Filtrer par ID société (envoyé à l'API comme référence keywords CSOC<id>)"),
+    contactId: EntityIdSchema.optional().describe("Filtrer par ID contact (envoyé à l'API comme référence keywords CCON<id>)"),
+    productId: EntityIdSchema.optional().describe("Filtrer par ID produit (envoyé à l'API comme référence keywords PROD<id>)"),
+    ...paginationShape,
+})
+    .strict();
+// ---- Payment schemas ----
+// Source: resources/payments/search.raml (filters verified live, issue #248).
+export const PaymentSearchSchema = z
+    .object({
+    keywords: z.string().optional().describe("Mots-clés de recherche"),
+    purchaseId: EntityIdSchema.optional().describe("Filtrer par ID achat (référence keywords ACH<id>)"),
+    companyId: EntityIdSchema.optional().describe("Filtrer par ID société (référence keywords CSOC<id>)"),
+    projectId: EntityIdSchema.optional().describe("Filtrer par ID projet (référence keywords PRJ<id>)"),
+    resourceId: EntityIdSchema.optional().describe("Filtrer par ID ressource (référence keywords COMP<id>)"),
+    contactId: EntityIdSchema.optional().describe("Filtrer par ID contact (référence keywords CCON<id>)"),
+    paymentStates: intArray("IDs d'états de paiement — `boond://dictionary/states/payments`."),
+    paymentMethods: paymentMethodsField,
+    purchaseTypes: intArray("IDs de types d'achat — `boond://dictionary/typeOf/purchases`."),
+    subscriptionTypes: intArray("IDs de types d'abonnement (`setting.typeOf.subscription` via `boond_application_dictionary`)."),
+    period: z
+        .enum(["created", "updated", "createdPurchase", "subscription", "expected", "performed", "billing"])
         .optional()
-        .describe("Filtrer par ID société (envoyé à l'API comme référence keywords CSOC<id>)"),
-    contactId: z
-        .string()
+        .describe("Champ de date borné par `startDate` / `endDate` : expected (échéance), performed (règlement effectif), created, updated, createdPurchase, subscription, billing."),
+    periodDynamic: periodDynamicField,
+    startDate: startDateField,
+    endDate: endDateField,
+    excludeProviderInvoice: z
+        .boolean()
         .optional()
-        .describe("Filtrer par ID contact (envoyé à l'API comme référence keywords CCON<id>)"),
-    productId: z
-        .string()
+        .describe("true = exclure les paiements adossés à une facture fournisseur."),
+    deliveryPurchases: z.boolean().optional().describe("true = paiements des achats liés à une prestation uniquement."),
+    flags: flagsField,
+    ...perimeterShape,
+    ...sortedPaginationShape,
+})
+    .strict();
+export const PaymentCreateSchema = z
+    .object({
+    purchaseId: EntityIdSchema.describe("ID de l'achat réglé"),
+    paymentDate: z.string().optional().describe("Date du paiement (YYYY-MM-DD), mappée vers date"),
+    performedDate: z.string().optional().describe("Date de paiement effectif (YYYY-MM-DD)"),
+    expectedDate: z.string().optional().describe("Date de paiement attendu (YYYY-MM-DD)"),
+    startDate: z.string().optional().describe("Date de début couverte (YYYY-MM-DD)"),
+    endDate: z.string().optional().describe("Date de fin couverte (YYYY-MM-DD)"),
+    amount: z.number().optional().describe("Montant HT du paiement, mappé vers amountExcludingTax"),
+    amountExcludingTax: z.number().optional().describe("Montant HT du paiement"),
+    state: stateField("payment", "État du paiement : ID de `boond://dictionary/states/payments`"),
+    paymentMethod: z.number().int().optional().describe("Mode de paiement : ID de `boond://dictionary/paymentMethods`"),
+    taxRates: z.array(z.number()).optional().describe("Taux de taxes Boond"),
+    reference: z.string().optional().describe("Référence bancaire ou règlement"),
+    note: z.string().optional().describe("Note interne, mappée vers informationComments"),
+})
+    .strict();
+// PUT /payments/{id} — issue #252 (write path not exercised, see CLAUDE.md).
+export const PaymentUpdateSchema = z
+    .object({
+    id: EntityIdSchema.describe("ID du paiement à modifier"),
+    paymentDate: z.string().optional().describe("Date du paiement (YYYY-MM-DD), mappée vers date"),
+    performedDate: z.string().optional().describe("Date de paiement effectif (YYYY-MM-DD) — régulariser un règlement"),
+    expectedDate: z.string().optional().describe("Date de paiement attendu (YYYY-MM-DD)"),
+    startDate: z.string().optional().describe("Date de début couverte (YYYY-MM-DD)"),
+    endDate: z.string().optional().describe("Date de fin couverte (YYYY-MM-DD)"),
+    amount: z.number().optional().describe("Montant HT, mappé vers amountExcludingTax"),
+    amountExcludingTax: z.number().optional().describe("Montant HT"),
+    amountIncludingTax: z.number().optional().describe("Montant TTC"),
+    state: stateField("payment", "État du paiement : ID de `boond://dictionary/states/payments`"),
+    paymentMethod: z.number().int().optional().describe("Mode de paiement : ID de `boond://dictionary/paymentMethods`"),
+    taxRates: z.array(z.number()).optional().describe("Taux de taxes Boond"),
+    reference: z.string().optional().describe("Référence bancaire ou règlement (`number`)"),
+    note: z.string().optional().describe("Note interne, mappée vers informationComments"),
+})
+    .strict();
+// ---- Purchase schemas (achats / sous-traitance) ----
+export const PurchaseSearchSchema = z
+    .object({
+    keywords: z.string().optional().describe("Mots-clés de recherche"),
+    companyId: EntityIdSchema.optional().describe("Filtrer par ID société (référence keywords CSOC<id>)"),
+    projectId: EntityIdSchema.optional().describe("Filtrer par ID projet (référence keywords PRJ<id>)"),
+    ...paginationShape,
+})
+    .strict();
+export const PurchaseCreateSchema = z
+    .object({
+    title: z.string().optional().describe("Titre de l'achat/sous-traitance"),
+    companyId: EntityIdSchema.optional().describe("ID de la société fournisseur"),
+    contactId: EntityIdSchema.optional().describe("ID du contact fournisseur"),
+    projectId: EntityIdSchema.optional().describe("ID du projet associé"),
+    state: stateField("purchase", "État de l'achat : ID de `boond://dictionary/states/purchases`"),
+    startDate: z.string().optional().describe("Date de début (YYYY-MM-DD)"),
+    endDate: z.string().optional().describe("Date de fin (YYYY-MM-DD)"),
+    note: z.string().optional().describe("Notes / commentaires"),
+})
+    .strict();
+// PUT /purchases/{id}/information (RAML `purchases/information.raml`, issue #252).
+export const PurchaseUpdateSchema = z
+    .object({
+    id: EntityIdSchema.describe("ID de l'achat à modifier"),
+    title: z.string().optional().describe("Titre de l'achat/sous-traitance"),
+    typeOf: z.number().int().optional().describe("Type d'achat : ID de `boond://dictionary/typeOf/purchases`"),
+    state: stateField("purchase", "État de l'achat : ID de `boond://dictionary/states/purchases`"),
+    companyId: EntityIdSchema.optional().describe("ID de la société fournisseur"),
+    contactId: EntityIdSchema.optional().describe("ID du contact fournisseur"),
+    projectId: EntityIdSchema.optional().describe("ID du projet associé"),
+    startDate: z.string().optional().describe("Date de début (YYYY-MM-DD)"),
+    endDate: z.string().optional().describe("Date de fin (YYYY-MM-DD)"),
+    quantity: z.number().optional().describe("Quantité"),
+    amountExcludingTax: z.number().optional().describe("Montant unitaire HT"),
+    taxRate: z.number().optional().describe("Taux de TVA (%) — `boond://dictionary/taxRates`"),
+    paymentMethod: z.number().int().optional().describe("Mode de paiement : ID de `boond://dictionary/paymentMethods`"),
+    paymentTerm: z
+        .number()
+        .int()
         .optional()
-        .describe("Filtrer par ID produit (envoyé à l'API comme référence keywords PROD<id>)"),
-    page: z.number().int().min(1).max(MAX_SEARCH_PAGE).default(1).describe(`Numéro de page (max: ${MAX_SEARCH_PAGE})`),
-    pageSize: z.number().int().min(1).max(MAX_PAGE_SIZE).default(DEFAULT_PAGE_SIZE).describe("Résultats par page"),
-    fields: fieldsField,
+        .describe("Condition de paiement : ID de `boond://dictionary/paymentTerms`"),
+    note: z.string().optional().describe("Notes / commentaires (`informationComments`)"),
 })
     .strict();
-// ---- Payment schemas ----
-export const PaymentSearchSchema = z
+// ---- Provider invoice schemas (factures fournisseur) ----
+export const ProviderInvoiceSearchSchema = z
     .object({
     keywords: z.string().optional().describe("Mots-clés de recherche"),
-    invoiceId: z.string().optional().describe("Filtrer par ID facture"),
-    purchaseId: z.string().optional().describe("Filtrer par ID achat"),
-    companyId: z.string().optional().describe("Filtrer par ID société"),
-    projectId: z.string().optional().describe("Filtrer par ID projet"),
-    resourceId: z.string().optional().describe("Filtrer par ID ressource"),
+    companyId: EntityIdSchema.optional().describe("Filtrer par ID société fournisseur (référence keywords CSOC<id>)"),
+    resourceId: EntityIdSchema.optional().describe("Filtrer par ID ressource (référence keywords COMP<id>)"),
+    ...paginationShape,
+})
+    .strict();
+export const ProviderInvoiceCreateSchema = z
+    .object({
+    reference: z.string().min(1).describe("Référence de la facture fournisseur"),
+    resourceId: EntityIdSchema.describe("ID de la ressource portée par la facture fournisseur"),
+    companyId: EntityIdSchema.optional().describe("ID de la société fournisseur, mappé vers providerCompany"),
+    contactId: EntityIdSchema.optional().describe("ID du contact fournisseur, mappé vers providerContact"),
+    invoiceDate: z.string().optional().describe("Date de facture (YYYY-MM-DD)"),
+    startDate: z.string().min(1).describe("Date de début de période (YYYY-MM-DD)"),
+    endDate: z.string().min(1).describe("Date de fin de période (YYYY-MM-DD)"),
+    amountExcludingTax: z.number().optional().describe("Montant HT"),
+    amountIncludingTax: z.number().optional().describe("Montant TTC"),
+    currency: z.number().optional().describe("Devise Boond"),
+    exchangeRate: z.number().optional().describe("Taux de change"),
+    currencyAgency: z.number().optional().describe("Devise agence"),
+    exchangeRateAgency: z.number().optional().describe("Taux de change agence"),
+    state: stateField("providerinvoice", "État de la facture fournisseur : ID de `boond://dictionary/states/provider-invoices`"),
+})
+    .strict();
+// PUT /provider-invoices/{id} — issue #252 (write path not exercised, see CLAUDE.md).
+export const ProviderInvoiceUpdateSchema = z
+    .object({
+    id: EntityIdSchema.describe("ID de la facture fournisseur à modifier"),
+    reference: z.string().optional().describe("Référence de la facture fournisseur"),
+    invoiceDate: z.string().optional().describe("Date de facture (YYYY-MM-DD)"),
+    startDate: z.string().optional().describe("Date de début de période (YYYY-MM-DD)"),
+    endDate: z.string().optional().describe("Date de fin de période (YYYY-MM-DD)"),
+    dueDate: z.string().optional().describe("Date d'échéance (YYYY-MM-DD)"),
+    paidDate: z.string().optional().describe("Date de règlement (YYYY-MM-DD) — marquer la facture payée"),
+    amountExcludingTax: z.number().optional().describe("Montant HT"),
+    amountIncludingTax: z.number().optional().describe("Montant TTC"),
+    state: stateField("providerinvoice", "État de la facture fournisseur : ID de `boond://dictionary/states/provider-invoices`"),
+})
+    .strict();
+// ---- Contract schemas ----
+export const ContractCreateSchema = z
+    .object({
+    resourceId: EntityIdSchema.optional().describe("ID de la ressource associée"),
+    typeOf: z
+        .number()
+        .int()
+        .optional()
+        .describe("Type de contrat : ID entier du dictionnaire `setting.typeOf.contract` (CDI, CDD, freelance…), via `boond_application_dictionary`"),
     startDate: z.string().optional().describe("Date de début (YYYY-MM-DD)"),
     endDate: z.string().optional().describe("Date de fin (YYYY-MM-DD)"),
-    page: z.number().int().min(1).max(MAX_SEARCH_PAGE).default(1).describe(`Numéro de page (max: ${MAX_SEARCH_PAGE})`),
-    pageSize: z.number().int().min(1).max(MAX_PAGE_SIZE).default(DEFAULT_PAGE_SIZE).describe("Résultats par page"),
-    fields: fieldsField,
+    note: z.string().optional().describe("Notes / commentaires (`informationComments`)"),
+})
+    .strict();
+// PUT /contracts/{id} — issue #252 (write path not exercised, see CLAUDE.md).
+export const ContractUpdateSchema = z
+    .object({
+    id: EntityIdSchema.describe("ID du contrat à modifier"),
+    typeOf: z.number().int().optional().describe("Type de contrat : ID de `boond://dictionary/typeOf/contracts`"),
+    startDate: z.string().optional().describe("Date de début (YYYY-MM-DD)"),
+    endDate: z.string().optional().describe("Date de fin (YYYY-MM-DD) — prolonger un CDD = repousser cette date"),
+    endReason: z.number().int().optional().describe("Motif de fin : ID de `boond://dictionary/contractEndReasons`"),
+    probationEndDate: z.string().optional().describe("Fin de période d'essai initiale (YYYY-MM-DD)"),
+    renewalProbationEndDate: z.string().optional().describe("Fin de période d'essai renouvelée (YYYY-MM-DD)"),
+    monthlySalary: z.number().optional().describe("Salaire mensuel"),
+    annualSalary: z.number().optional().describe("Salaire annuel"),
+    numberOfWorkingDays: z.number().optional().describe("Nombre de jours ouvrés annuel"),
+    note: z.string().optional().describe("Notes / commentaires (`informationComments`)"),
 })
     .strict();
 // ---- Advantage schemas ----
+// `GET /advantages` does not exist (the RAML only has POST there, and the live
+// API answers with a WAF 403 page); advantages are listed per resource via
+// `GET /resources/{id}/advantages` (issue #247). Hence a required `resourceId`.
 export const AdvantageSearchSchema = z
     .object({
-    keywords: z.string().optional().describe("Mots-clés de recherche"),
-    resourceId: z.string().optional().describe("Filtrer par ID ressource"),
-    page: z.number().int().min(1).max(MAX_SEARCH_PAGE).default(1).describe(`Numéro de page (max: ${MAX_SEARCH_PAGE})`),
-    pageSize: z.number().int().min(1).max(MAX_PAGE_SIZE).default(DEFAULT_PAGE_SIZE).describe("Résultats par page"),
-    fields: fieldsField,
+    resourceId: EntityIdSchema.describe("ID de la ressource dont on liste les avantages (route /resources/{id}/advantages)"),
+    advantageTypes: strArray("Types d'avantage à conserver, au format `<reference>_<agencyId>` (référence du type + ID d'agence, ex: '2_1')."),
+    ...paginationShape,
+})
+    .strict();
+// ---- Flags, attached flags, tasks, todolists, advantages writes (issue #254) ----
+/** Entities that carry `attachedFlags.raml` (11) — the query-parameter name of `DELETE /attached-flags` is the entity's singular. */
+export const ATTACHED_FLAG_ENTITIES = [
+    "candidate",
+    "resource",
+    "contact",
+    "company",
+    "opportunity",
+    "project",
+    "order",
+    "product",
+    "purchase",
+    "action",
+    "positioning",
+    "invoice",
+];
+/** Entities that carry `tasks.raml` (14). */
+export const TASK_ENTITIES = [
+    "candidate",
+    "resource",
+    "contact",
+    "company",
+    "opportunity",
+    "project",
+    "order",
+    "product",
+    "purchase",
+    "positioning",
+    "invoice",
+    "contract",
+    "delivery",
+    "payment",
+    "form",
+];
+export const FlagCreateSchema = z
+    .object({
+    name: z.string().min(1).describe("Libellé du drapeau (ex. « vivier Java Q4 »)."),
+    mainManagerId: EntityIdSchema.optional().describe("ID de la ressource responsable du drapeau — l'utilisateur courant si omis."),
+})
+    .strict();
+export const AttachedFlagsListSchema = z
+    .object({
+    entity: z.enum(ATTACHED_FLAG_ENTITIES).describe("Type de l'enregistrement."),
+    id: EntityIdSchema.describe("ID numérique de l'enregistrement."),
+})
+    .strict();
+export const AttachedFlagSchema = AttachedFlagsListSchema.extend({
+    flagId: EntityIdSchema.describe("ID du drapeau (`boond_flags_search`)."),
+}).strict();
+export const TasksGetSchema = z
+    .object({
+    entity: z.enum(TASK_ENTITIES).describe("Type de l'enregistrement."),
+    id: EntityIdSchema.describe("ID numérique de l'enregistrement."),
+})
+    .strict();
+const TodolistTaskSchema = z
+    .object({
+    description: z.string().min(1).describe("Intitulé de la tâche."),
+    row: z.number().int().min(0).optional().describe("Ordre d'affichage."),
+    state: z.number().int().optional().describe("État (0 = à faire par défaut)."),
+})
+    .strict();
+// POST /todolists from `models.todolist` (title, state, profile, profileTypesOf,
+// profileStates, agencies, tasks) — the RAML documents no body; not exercised.
+export const TodolistCreateSchema = z
+    .object({
+    title: z.string().min(1).describe("Titre de la todolist."),
+    profile: z
+        .string()
+        .optional()
+        .describe("Fiche sur laquelle la liste s'applique (ex. candidate, resource, opportunity…)."),
+    profileTypesOf: z.array(z.number().int()).optional().describe("Types de fiche concernés (IDs de dictionnaire)."),
+    profileStates: z.array(z.number().int()).optional().describe("États de fiche concernés (IDs de dictionnaire)."),
+    agencyIds: z.array(EntityIdSchema).optional().describe("Agences concernées (IDs)."),
+    tasks: z.array(TodolistTaskSchema).min(1).describe("Tâches de la liste, dans l'ordre."),
+})
+    .strict();
+/** `GET /advantages/default?resource=&contract=&project=&delivery=` (RAML `advantages/default.raml`). */
+export const AdvantageDefaultSchema = z
+    .object({
+    resourceId: EntityIdSchema.describe("ID de la ressource bénéficiaire."),
+    contractId: EntityIdSchema.optional().describe("ID du contrat de rattachement."),
+    projectId: EntityIdSchema.optional().describe("ID du projet (avantage refacturable)."),
+    deliveryId: EntityIdSchema.optional().describe("ID de la prestation."),
 })
     .strict();
+// POST /advantages from `models.advantage`; the RAML documents no body — not exercised.
+export const AdvantageCreateSchema = z
+    .object({
+    resourceId: EntityIdSchema.describe("ID de la ressource bénéficiaire (relation `resource`, requise)."),
+    advantageType: z
+        .union([z.number().int(), z.string().min(1)])
+        .describe("Type d'avantage : `reference` ou `<reference>_<agencyId>` tel que publié par `boond_advantages_default` (`advantageTypes`)."),
+    date: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .describe("Date de l'avantage (YYYY-MM-DD)."),
+    returnDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .optional()
+        .describe("Date de restitution (véhicule, matériel)."),
+    quantity: z.number().optional().describe("Quantité (ex. nombre de tickets)."),
+    participationAmount: z.number().optional().describe("Participation salarié."),
+    employeeAmount: z.number().optional().describe("Montant versé au salarié."),
+    agencyAmount: z.number().optional().describe("Charges / coefficient de charge côté agence."),
+    contractId: EntityIdSchema.optional().describe("ID du contrat de rattachement."),
+    projectId: EntityIdSchema.optional().describe("ID du projet à refacturer."),
+    deliveryId: EntityIdSchema.optional().describe("ID de la prestation."),
+    note: z.string().optional().describe("Commentaires (`informationComments`)."),
+})
+    .strict();
+// ---- Inactivities, forms, groupments (issue #256) ----
+// All three collections document `post` only (no list GET), plus `default`
+// and `rights`; bodies come from `models.*` in the dictionary and were not
+// exercised (production tenant). Detail reads follow the `/{collection}/{id}`
+// pattern of every other entity.
+const isoDate = (doc) => z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}$/)
+    .describe(doc);
+export const InactivityDefaultSchema = z
+    .object({
+    resourceId: EntityIdSchema.describe("ID de la ressource (requis par `GET /inactivities/default`)."),
+})
+    .strict();
+export const InactivityCreateSchema = z
+    .object({
+    resourceId: EntityIdSchema.describe("ID de la ressource en intercontrat / inactivité (relation `resource`, requise)."),
+    title: z.string().optional().describe("Intitulé (ex. « Intercontrat », « Formation interne »)."),
+    inactivityType: z
+        .union([z.number().int(), z.string().min(1)])
+        .optional()
+        .describe("Type d'inactivité tel que publié par `boond_inactivities_default`."),
+    startDate: isoDate("Date de début (YYYY-MM-DD)."),
+    endDate: isoDate("Date de fin (YYYY-MM-DD)."),
+    numberOfDaysInvoicedOrQuantity: z.number().optional().describe("Nombre de jours de la période."),
+    averageDailyCost: z.number().optional().describe("Coût journalier moyen retenu."),
+    contractId: EntityIdSchema.optional().describe("ID du contrat de rattachement."),
+    note: z.string().optional().describe("Commentaires (`informationComments`)."),
+})
+    .strict();
+export const FormDefaultSchema = z
+    .object({
+    templateId: EntityIdSchema.describe("ID du modèle de formulaire (`template`)."),
+    resourceId: EntityIdSchema.describe("ID de l'entité visée par le formulaire (`resource`)."),
+})
+    .strict();
+export const FormCreateSchema = z
+    .object({
+    templateId: EntityIdSchema.describe("ID du modèle de formulaire (relation `template`, requise)."),
+    resourceId: EntityIdSchema.optional().describe("Ressource visée (relation `dependsOn`, type resource)."),
+    candidateId: EntityIdSchema.optional().describe("Candidat visé (relation `dependsOn`, type candidate)."),
+    validatorId: EntityIdSchema.optional().describe("Ressource qui validera le formulaire (`validator`)."),
+    recipientId: EntityIdSchema.optional().describe("Ressource destinataire (`recipient`)."),
+    validateDate: isoDate("Date de validation souhaitée (YYYY-MM-DD).").optional(),
+    remindDate: isoDate("Date de rappel (YYYY-MM-DD).").optional(),
+})
+    .strict();
+export const GroupmentDefaultSchema = z
+    .object({
+    projectId: EntityIdSchema.describe("ID du projet (requis par `GET /groupments/default`)."),
+})
+    .strict();
+const groupmentWritableShape = {
+    title: z.string().optional().describe("Titre du regroupement."),
+    startDate: isoDate("Date de début (YYYY-MM-DD).").optional(),
+    endDate: isoDate("Date de fin (YYYY-MM-DD).").optional(),
+    averageDailyPriceExcludingTax: z.number().optional().describe("Prix journalier HT du regroupement."),
+    forceAverageDailyPriceExcludingTax: z.boolean().optional().describe("Forcer le prix journalier."),
+    averageDailyCost: z.number().optional().describe("Coût journalier moyen."),
+    numberOfDaysInvoicedOrQuantity: z.number().optional().describe("Jours / quantité facturés."),
+    numberOfDaysFree: z.number().optional().describe("Jours offerts."),
+    deliveryIds: z.array(EntityIdSchema).optional().describe("Prestations regroupées (relation `deliveries`)."),
+    note: z.string().optional().describe("Commentaires (`informationComments`)."),
+};
+export const GroupmentCreateSchema = z
+    .object({
+    projectId: EntityIdSchema.describe("ID du projet (relation `project`, requise)."),
+    ...groupmentWritableShape,
+})
+    .strict();
+export const GroupmentUpdateSchema = z
+    .object({
+    id: EntityIdSchema.describe("ID du regroupement à modifier."),
+    ...groupmentWritableShape,
+})
+    .strict();
+// ---- Alerts (issue #255) ----
+// `GET /alerts` ("Search alerts for user dashboard") documents no parameter at
+// all — not even the searchable / paginable traits — so the tool takes only
+// the client-side projection.
+export const AlertSearchSchema = z.object({ fields: fieldsField }).strict();
 // ---- Application schemas ----
 // ---- Validation schemas ----
 // `/validations` requires `startMonth` + `endMonth` (YYYY-MM). Optional filters
@@ -1339,15 +1982,7 @@ export const ValidationSearchSchema = z
         .optional()
         .describe("États de validation."),
     validationAlerts: z.boolean().optional().describe("Filtrer sur les validations avec alertes."),
-    page: z.number().int().min(1).max(MAX_SEARCH_PAGE).default(1).describe(`Numéro de page (max: ${MAX_SEARCH_PAGE})`),
-    pageSize: z
-        .number()
-        .int()
-        .min(1)
-        .max(MAX_PAGE_SIZE)
-        .default(DEFAULT_PAGE_SIZE)
-        .describe(`Nombre de résultats par page (max: ${MAX_PAGE_SIZE}, défaut: ${DEFAULT_PAGE_SIZE})`),
-    fields: fieldsField,
+    ...paginationShape,
 })
     .strict();
 // ---- Notification schemas ----
@@ -1364,15 +1999,7 @@ export const NotificationSearchSchema = z
         .array(z.string())
         .optional()
         .describe("Types de modules parents (ex: 'contract', 'global', 'project'...)."),
-    page: z.number().int().min(1).max(MAX_SEARCH_PAGE).default(1).describe(`Numéro de page (max: ${MAX_SEARCH_PAGE})`),
-    pageSize: z
-        .number()
-        .int()
-        .min(1)
-        .max(MAX_PAGE_SIZE)
-        .default(DEFAULT_PAGE_SIZE)
-        .describe(`Nombre de résultats par page (max: ${MAX_PAGE_SIZE}, défaut: ${DEFAULT_PAGE_SIZE})`),
-    fields: fieldsField,
+    ...paginationShape,
 })
     .strict();
 // ---- Reporting schemas ----
@@ -1546,14 +2173,16 @@ export const DictionaryGetSchema = z
     dictionaryType: z
         .string()
         .min(1)
-        .describe("Type de dictionnaire (ex: typeOf/actions, typeOf/absences, states/candidates, states/resources, states/opportunities, states/projects, states/invoices, countries, currencies, languages...)"),
+        .describe("Chemin dotté relatif à `data` de /application/dictionary (ex: setting.state.resource, setting.typeOf.project, setting.action.candidate, setting.tool, country, languages). La forme « states/resources » (slash) n'est pas valide."),
 })
     .strict();
 // ---- Documents ----
 // Source: https://doc.boondmanager.com/api-externe/raml-build/resources/documents/search.raml
-// L'upload passe par `fileUrl` uniquement : l'API BoondManager télécharge le
-// fichier elle-même, le serveur MCP ne bufferise jamais d'octets de fichier
-// (et n'expose pas de lecture du système de fichiers local).
+// Trois sources, exactement une par appel (vérifié par le handler, un JSON
+// Schema ne sait pas l'exprimer lisiblement) : `fileUrl` (BoondManager
+// télécharge lui-même), `filePath` (fichier local, stdio uniquement, désactivé
+// tant que `BOOND_MCP_UPLOAD_DIRS` n'est pas défini) et `fileContent` + `fileName`
+// (base64 inline, plafonné). Garde-fous : `services/upload-source.ts`.
 export const DocumentParentTypes = [
     "action",
     "resourceResume",
@@ -1589,7 +2218,27 @@ export const DocumentCreateSchema = z
     fileUrl: z
         .string()
         .url()
+        .optional()
         .describe("URL (https) du fichier à téléverser — BoondManager télécharge le fichier depuis cette URL."),
+    filePath: z
+        .string()
+        .min(1)
+        .max(4096)
+        .optional()
+        .describe("Chemin absolu d'un fichier local, lu par le serveur MCP (transport stdio uniquement, sous un répertoire " +
+        "de BOOND_MCP_UPLOAD_DIRS)."),
+    fileContent: z
+        .string()
+        .min(1)
+        .max(Math.ceil(INLINE_UPLOAD_MAX_BYTES / 3) * 4 + 256)
+        .optional()
+        .describe("Contenu du fichier en base64 (préfixe data: URI accepté), petits fichiers uniquement. Exige fileName."),
+    fileName: z
+        .string()
+        .min(1)
+        .max(255)
+        .optional()
+        .describe("Nom du fichier avec son extension (ex. cv.pdf), requis avec fileContent."),
     parsing: z
         .boolean()
         .optional()