boondmanager-mcp-server 2.9.0 → 2.11.0

package/dist/icons.js

@@ -0,0 +1,169 @@
+import { ListPromptsRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { PROMPTS } from "./prompts/index.js";
+import { isFeatureDisabled } from "./config/env-flags.js";
+/**
+ * Mid-grey: legible on both light and dark client themes. A data-URI SVG can't
+ * inherit `currentColor` from the host UI, so a single neutral tone beats
+ * shipping a light/dark pair (which would double the payload).
+ */
+const ICON_COLOR = "%237d8794";
+/**
+ * `BOOND_MCP_ICONS=0|false|no|off` drops icons everywhere. Measured cost of the
+ * full set: ~40 KiB, i.e. ~14% of the 295 KiB `tools/list` payload (180 tools ×
+ * ~230 B). Worth it for a client that renders them, pure overhead for a gateway
+ * that doesn't — hence the switch.
+ */
+function iconsDisabled() {
+    return isFeatureDisabled(process.env.BOOND_MCP_ICONS);
+}
+/**
+ * Build the data URI for a single-path 16×16 glyph.
+ *
+ * Path data uses `,` as its number separator rather than a space: both are
+ * valid SVG, and a comma needs no percent-encoding inside a `data:` URI (a
+ * space does). The markup's own spaces are written as `%20` so the URI stays
+ * valid unquoted.
+ */
+function glyph(path) {
+    return {
+        src: `data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%2016%2016'` +
+            `%20fill='${ICON_COLOR}'%3E%3Cpath%20d='${path.replace(/ /g, ",")}'/%3E%3C/svg%3E`,
+    };
+}
+// ---- Glyph vocabulary (reused across domains) ----
+const PERSON = glyph("M8 3a2.5 2.5 0 100 5 2.5 2.5 0 000-5zM3 14v-1c0-1.7 2.2-3 5-3s5 1.3 5 3v1z");
+const PEOPLE = glyph("M5 4a2 2 0 100 4 2 2 0 000-4zm6 0a2 2 0 100 4 2 2 0 000-4zM1 14v-1c0-1.4 1.8-2.5 4-2.5s4 1.1 4 2.5v1zm8 0v-1c0-1 .7-1.9 1.9-2.4 1.8.2 3.1 1.2 3.1 2.4v1z");
+const BUILDING = glyph("M3 2h10v12H3zm2 2h2v2H5zm4 0h2v2H9zM5 8h2v2H5zm4 0h2v2H9zm-2 4h2v2H7z");
+const TARGET = glyph("M8 2a6 6 0 100 12A6 6 0 008 2zm0 4a2 2 0 100 4 2 2 0 000-4z");
+const BRIEFCASE = glyph("M6 2h4v2h3v9H3V4h3zm1 1v1h2V3z");
+const DOCUMENT = glyph("M4 1h5l3 3v11H4zm1 5h6v1H5zm0 3h6v1H5zm0 3h4v1H5z");
+const CALENDAR = glyph("M3 3h10v11H3zm2-2h1v3H5zm5 0h1v3h-1zM4 6h8v1H4z");
+const CLOCK = glyph("M8 2a6 6 0 100 12A6 6 0 008 2zm-.5 2h1v3.7l2.3 1.4-.5.9L7.5 8.4z");
+const MONEY = glyph("M2 4h12v8H2zm6 1.5A2.5 2.5 0 118 10.5a2.5 2.5 0 010-5z");
+const CART = glyph("M1 2h2l2 8h8l1-5H5v-1h10l-2 8H4L2 3H1zm4 10h1.5v1.5H5zm6 0h1.5v1.5H11z");
+const BOX = glyph("M8 1l6 3-6 3-6-3zM2 6l6 3v6l-6-3zm12 0v6l-6 3V9z");
+const CHART = glyph("M2 13h12v1H2zm1-5h2v4H3zm4-4h2v8H7zm4 2h2v6h-2z");
+const LIST = glyph("M2 3h12v2H2zm0 4h12v2H2zm0 4h12v2H2z");
+const CHECK = glyph("M6.5 13L2 8.5l1.4-1.4 3.1 3.1L12.6 4l1.4 1.4z");
+const TAG = glyph("M2 2h6l6 6-6 6-6-6zm2 2v2h2V4z");
+const GEAR = glyph("M7 1h2v2H7zm0 12h2v2H7zM1 7h2v2H1zm12 0h2v2h-2zM8 4.5a3.5 3.5 0 100 7 3.5 3.5 0 000-7zm0 2a1.5 1.5 0 110 3 1.5 1.5 0 010-3z");
+const BELL = glyph("M8 1a4 4 0 00-4 4v4l-1 2h10l-1-2V5a4 4 0 00-4-4zm-1.5 12h3a1.5 1.5 0 01-3 0z");
+const CHAT = glyph("M2 3h12v8H7l-3 3v-3H2z");
+const PLUG = glyph("M4 1h2v4H4zm6 0h2v4h-2zM3 6h10v2a5 5 0 01-4 4.9V15H7v-2.1A5 5 0 013 8z");
+const KEY = glyph("M10 2a4 4 0 00-3.9 5L2 11.1V14h3v-2h2v-1.2l.9-.9A4 4 0 1010 2zm1 2.2a1.2 1.2 0 110 2.4 1.2 1.2 0 010-2.4z");
+const PIN = glyph("M8 1a4.5 4.5 0 00-4.5 4.5C3.5 9 8 15 8 15s4.5-6 4.5-9.5A4.5 4.5 0 008 1zm0 2.8a1.8 1.8 0 110 3.6 1.8 1.8 0 010-3.6z");
+const PLANE = glyph("M8 1l1.2 5.5L15 8l-5.8 1.5L8 15l-1.2-5.5L1 8l5.8-1.5z");
+/**
+ * Domain → icons. Every entry of `REGISTERED_DOMAINS` must be present
+ * (asserted in `icons.test.ts`), so adding a domain without an icon fails CI
+ * rather than shipping a half-iconified catalogue.
+ */
+export const DOMAIN_ICONS = {
+    candidates: [PERSON],
+    resources: [PEOPLE],
+    contacts: [PERSON],
+    companies: [BUILDING],
+    opportunities: [TARGET],
+    actions: [CHAT],
+    timesheets: [CLOCK],
+    projects: [BRIEFCASE],
+    invoices: [DOCUMENT],
+    orders: [DOCUMENT],
+    deliveries: [BRIEFCASE],
+    absences: [PLANE],
+    expenses: [MONEY],
+    products: [BOX],
+    positionings: [TARGET],
+    payments: [MONEY],
+    advantages: [MONEY],
+    application: [GEAR],
+    contracts: [DOCUMENT],
+    purchases: [CART],
+    "provider-invoices": [DOCUMENT],
+    accounts: [KEY],
+    agencies: [BUILDING],
+    "business-units": [BUILDING],
+    roles: [KEY],
+    logs: [LIST],
+    notifications: [BELL],
+    threads: [CHAT],
+    todolists: [CHECK],
+    flags: [TAG],
+    calendars: [CALENDAR],
+    webhooks: [PLUG],
+    validations: [CHECK],
+    poles: [PIN],
+    reporting: [CHART],
+    "planning-absences": [CALENDAR],
+    documents: [DOCUMENT],
+    workflows: [LIST],
+};
+/**
+ * Icons for the dictionary / reference resources (`boond://…`). Resolved
+ * through a function, not a constant, because `registerAllResources` runs at
+ * startup and must honour `BOOND_MCP_ICONS` too.
+ */
+export function referenceIcons() {
+    return iconsDisabled() ? undefined : [LIST];
+}
+/** Icons for the `current-user` resource. */
+export function identityIcons() {
+    return iconsDisabled() ? undefined : [PERSON];
+}
+export function iconsForDomain(domain) {
+    if (domain === undefined || iconsDisabled())
+        return undefined;
+    return DOMAIN_ICONS[domain];
+}
+/**
+ * Prompt → icons, from the first domain the prompt orchestrates (its subject:
+ * `factures_a_relancer` → invoices, `synthese_equipe` → resources).
+ */
+export function iconsForPrompt(name) {
+    const prompt = PROMPTS.find((p) => p.name === name);
+    return iconsForDomain(prompt?.domains[0]);
+}
+/** Total byte cost of an icon payload, for the cap test and the docs. */
+export function iconsByteSize(icons) {
+    return icons === undefined ? 0 : JSON.stringify(icons).length;
+}
+function withIcons(entry, icons) {
+    return icons === undefined || icons.length === 0 ? entry : { ...entry, icons };
+}
+/**
+ * Attach domain icons to `tools/list` and `prompts/list` responses.
+ *
+ * MUST be called before the first `registerTool` / `registerPrompt` on this
+ * server: it works by intercepting the `setRequestHandler` calls the SDK makes
+ * when it lazily installs those handlers. `index` is read at request time, so
+ * it can still be empty at install time.
+ */
+export function installProtocolIcons(server, index) {
+    // `Server.setRequestHandler` is generic over the request schema; the shim is
+    // schema-agnostic, hence the single cast at the boundary.
+    const underlying = server.server;
+    const original = underlying.setRequestHandler.bind(underlying);
+    underlying.setRequestHandler = (schema, handler) => {
+        if (schema === ListToolsRequestSchema) {
+            return original(schema, async (...args) => {
+                const result = (await handler(...args));
+                if (!Array.isArray(result?.tools))
+                    return result;
+                return {
+                    ...result,
+                    tools: result.tools.map((t) => withIcons(t, iconsForDomain(index.toolDomains.get(t.name)))),
+                };
+            });
+        }
+        if (schema === ListPromptsRequestSchema) {
+            return original(schema, async (...args) => {
+                const result = (await handler(...args));
+                if (!Array.isArray(result?.prompts))
+                    return result;
+                return { ...result, prompts: result.prompts.map((p) => withIcons(p, iconsForPrompt(p.name))) };
+            });
+        }
+        return original(schema, handler);
+    };
+}
+//# sourceMappingURL=icons.js.map

package/dist/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../src/icons.ts"],"names":[],"mappings":"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"}

package/dist/instructions.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Server-level instructions advertised to the client in the `initialize`
+ * result (`ServerOptions.instructions`, MCP 2025-11-25).
+ *
+ * Scope: **cross-cutting rules only**. With ~180 tools, anything that applies
+ * to every search tool belongs here once instead of being duplicated in each
+ * description (which the model pays for in the tools[] list on every turn).
+ * Per-tool specifics stay in the tool descriptions and in `src/schemas/index.ts`.
+ *
+ * Rule of thumb when editing: a statement belongs here only if it is true of
+ * *every* tool it appears to cover. A filter that exists on six endpoints and
+ * not on the other thirty-two is a per-tool fact — stating it here as universal
+ * makes the model emit calls that either get a Zod rejection or, worse, come
+ * back empty and read as a real answer.
+ *
+ * Budget: capped and tested in `src/tools/descriptions.test.ts`
+ * (`MAX_SERVER_INSTRUCTIONS_LENGTH`) — these instructions compete with the
+ * tool catalogue for the same context window.
+ */
+export declare const SERVER_INSTRUCTIONS = "Acc\u00E8s aux donn\u00E9es ERP/CRM BoondManager (API JSON:API) : candidats, ressources (consultants), contacts, soci\u00E9t\u00E9s, opportunit\u00E9s, projets, CRA, factures, achats\u2026\n\n## Nommage des outils\n\n`boond_{domaine}_{op\u00E9ration}` \u2014 op\u00E9rations : `search`, `get`, `create`, `update`, `delete`. Les onglets d'une fiche sont des outils distincts : `boond_{domaine}_{onglet}` (ex. `boond_resources_technical_data`). Workflow habituel : un `search` pour obtenir l'id, puis `get` ou l'onglet voulu pour le d\u00E9tail.\n\n## Les filtres sont propres \u00E0 chaque endpoint\n\nLe sch\u00E9ma de chaque outil est la r\u00E9f\u00E9rence : **ne pas transposer un filtre d'un endpoint \u00E0 un autre**. Les sch\u00E9mas sont `.strict()`, donc un nom inconnu est rejet\u00E9 par une erreur de validation \u2014 mais ce rejet a deux causes possibles : mauvais nom de filtre, **ou** filtre non support\u00E9 par cet endpoint. Dans le second cas, ne pas r\u00E9essayer avec des variantes : reprendre la recherche avec les filtres que le sch\u00E9ma expose (souvent `keywords` seul), ou filtrer c\u00F4t\u00E9 client apr\u00E8s lecture.\n\n## P\u00E9rim\u00E8tre (les 6 recherches principales + `boond_reporting_*`)\n\nSur `resources`, `candidates`, `contacts`, `companies`, `opportunities`, `projects` et le reporting \u2014 pas sur les domaines de r\u00E9f\u00E9rence/administration :\n\n- \u00AB mes donn\u00E9es / mon \u00E9quipe / mon agence \u00BB \u2192 `perimeterDynamic` : `[\"data\"]` (mes donn\u00E9es), `[\"managers\"]` (mon N-1), `[\"agencies\"]`, `[\"poles\"]`, `[\"businessUnits\"]`\n- \u00AB l'\u00E9quipe de X \u00BB \u2192 `perimeterManagers: [<id de X>]`\n- p\u00E9rim\u00E8tre organisationnel explicite \u2192 `perimeterAgencies` / `perimeterPoles` / `perimeterBusinessUnits`, \u00E0 combiner avec `narrowPerimeter: true` pour un ET logique\n\n`mainManagers`, `agencies`, `poles`, `businessUnits` n'existent sur aucun endpoint.\n\n## Cibler une entit\u00E9 li\u00E9e\n\nVocabulaire des pr\u00E9fixes de `keywords` : `CSOC<id>` (soci\u00E9t\u00E9), `CCON<id>` (contact), `CAND<id>` (candidat), `COMP<id>` (ressource), `AO<id>` (opportunit\u00E9), `PRJ<id>` (projet), `MIS<id>` (mission), `PROD<id>` (produit), `CTR<id>` (contrat) \u2014 ex. `keywords: \"CSOC42\"`.\n\n**Chaque endpoint n'en accepte qu'un sous-ensemble, \u00E9num\u00E9r\u00E9 dans la description de l'outil.** `keywords` \u00E9tant du texte libre, un pr\u00E9fixe non support\u00E9 n'est pas rejet\u00E9 : il part en recherche plein texte et renvoie 0 r\u00E9sultat. Une page vide apr\u00E8s un pr\u00E9fixe hors liste ne veut donc pas dire \u00AB aucune entit\u00E9 li\u00E9e \u00BB \u2014 v\u00E9rifier la description de l'outil avant de conclure.\n\n`keywordsType` (recherches `resources`, `candidates`, `contacts`, `companies` uniquement) restreint `keywords` \u00E0 un champ ; les valeurs admises diff\u00E8rent par endpoint (`lastName`/`fullName`/`titleSkills`\u2026 sur les personnes, `name`/`phones`/`emails` sur les soci\u00E9t\u00E9s) \u2014 lire l'\u00E9num\u00E9ration du sch\u00E9ma. Sans lui, la recherche porte sur le champ par d\u00E9faut de l'endpoint (CV ou texte int\u00E9gral).\n\n## \u00C9conomie de contexte\n\n- `pageSize` : d\u00E9faut 30, maximum 500. `page` est plafonn\u00E9 \u00E0 100 : au-del\u00E0, affiner les filtres plut\u00F4t que paginer.\n- `fields: [\"title\", \"updateDate\", \u2026]` remplace le r\u00E9sum\u00E9 d'une ligne par les seuls attributs demand\u00E9s \u2014 \u00E0 utiliser d\u00E8s qu'une page de r\u00E9sultats est large. Disponible sur les outils de recherche, sauf `boond_timesheets_search` et `boond_reporting_*`.\n\n## \u00C9tats et types\n\nCes filtres attendent des identifiants **entiers** et leur nom est propre \u00E0 l'endpoint : `resourceStates`, `candidateStates`, `opportunityStates`, `projectStates`, `states` + `typesOf` (contacts), `states` seul (soci\u00E9t\u00E9s \u2014 il n'y a pas de filtre de type sur `/companies`). Pour les traduire en libell\u00E9s, lire les ressources `boond://dictionary/*` (states, typeOf, countries, currencies, languages) plut\u00F4t que d'appeler `boond_application_dictionary` : m\u00EAme contenu, sans consommer un appel d'outil.";
+//# sourceMappingURL=instructions.d.ts.map

package/dist/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,+oIAmCue,CAAC"}

package/dist/instructions.js

@@ -0,0 +1,56 @@
+/**
+ * Server-level instructions advertised to the client in the `initialize`
+ * result (`ServerOptions.instructions`, MCP 2025-11-25).
+ *
+ * Scope: **cross-cutting rules only**. With ~180 tools, anything that applies
+ * to every search tool belongs here once instead of being duplicated in each
+ * description (which the model pays for in the tools[] list on every turn).
+ * Per-tool specifics stay in the tool descriptions and in `src/schemas/index.ts`.
+ *
+ * Rule of thumb when editing: a statement belongs here only if it is true of
+ * *every* tool it appears to cover. A filter that exists on six endpoints and
+ * not on the other thirty-two is a per-tool fact — stating it here as universal
+ * makes the model emit calls that either get a Zod rejection or, worse, come
+ * back empty and read as a real answer.
+ *
+ * Budget: capped and tested in `src/tools/descriptions.test.ts`
+ * (`MAX_SERVER_INSTRUCTIONS_LENGTH`) — these instructions compete with the
+ * tool catalogue for the same context window.
+ */
+export const SERVER_INSTRUCTIONS = `Accès aux données ERP/CRM BoondManager (API JSON:API) : candidats, ressources (consultants), contacts, sociétés, opportunités, projets, CRA, factures, achats…
+
+## Nommage des outils
+
+\`boond_{domaine}_{opération}\` — opérations : \`search\`, \`get\`, \`create\`, \`update\`, \`delete\`. Les onglets d'une fiche sont des outils distincts : \`boond_{domaine}_{onglet}\` (ex. \`boond_resources_technical_data\`). Workflow habituel : un \`search\` pour obtenir l'id, puis \`get\` ou l'onglet voulu pour le détail.
+
+## Les filtres sont propres à chaque endpoint
+
+Le schéma de chaque outil est la référence : **ne pas transposer un filtre d'un endpoint à un autre**. Les schémas sont \`.strict()\`, donc un nom inconnu est rejeté par une erreur de validation — mais ce rejet a deux causes possibles : mauvais nom de filtre, **ou** filtre non supporté par cet endpoint. Dans le second cas, ne pas réessayer avec des variantes : reprendre la recherche avec les filtres que le schéma expose (souvent \`keywords\` seul), ou filtrer côté client après lecture.
+
+## Périmètre (les 6 recherches principales + \`boond_reporting_*\`)
+
+Sur \`resources\`, \`candidates\`, \`contacts\`, \`companies\`, \`opportunities\`, \`projects\` et le reporting — pas sur les domaines de référence/administration :
+
+- « mes données / mon équipe / mon agence » → \`perimeterDynamic\` : \`["data"]\` (mes données), \`["managers"]\` (mon N-1), \`["agencies"]\`, \`["poles"]\`, \`["businessUnits"]\`
+- « l'équipe de X » → \`perimeterManagers: [<id de X>]\`
+- périmètre organisationnel explicite → \`perimeterAgencies\` / \`perimeterPoles\` / \`perimeterBusinessUnits\`, à combiner avec \`narrowPerimeter: true\` pour un ET logique
+
+\`mainManagers\`, \`agencies\`, \`poles\`, \`businessUnits\` n'existent sur aucun endpoint.
+
+## Cibler une entité liée
+
+Vocabulaire des préfixes de \`keywords\` : \`CSOC<id>\` (société), \`CCON<id>\` (contact), \`CAND<id>\` (candidat), \`COMP<id>\` (ressource), \`AO<id>\` (opportunité), \`PRJ<id>\` (projet), \`MIS<id>\` (mission), \`PROD<id>\` (produit), \`CTR<id>\` (contrat) — ex. \`keywords: "CSOC42"\`.
+
+**Chaque endpoint n'en accepte qu'un sous-ensemble, énuméré dans la description de l'outil.** \`keywords\` étant du texte libre, un préfixe non supporté n'est pas rejeté : il part en recherche plein texte et renvoie 0 résultat. Une page vide après un préfixe hors liste ne veut donc pas dire « aucune entité liée » — vérifier la description de l'outil avant de conclure.
+
+\`keywordsType\` (recherches \`resources\`, \`candidates\`, \`contacts\`, \`companies\` uniquement) restreint \`keywords\` à un champ ; les valeurs admises diffèrent par endpoint (\`lastName\`/\`fullName\`/\`titleSkills\`… sur les personnes, \`name\`/\`phones\`/\`emails\` sur les sociétés) — lire l'énumération du schéma. Sans lui, la recherche porte sur le champ par défaut de l'endpoint (CV ou texte intégral).
+
+## Économie de contexte
+
+- \`pageSize\` : défaut 30, maximum 500. \`page\` est plafonné à 100 : au-delà, affiner les filtres plutôt que paginer.
+- \`fields: ["title", "updateDate", …]\` remplace le résumé d'une ligne par les seuls attributs demandés — à utiliser dès qu'une page de résultats est large. Disponible sur les outils de recherche, sauf \`boond_timesheets_search\` et \`boond_reporting_*\`.
+
+## États et types
+
+Ces filtres attendent des identifiants **entiers** et leur nom est propre à l'endpoint : \`resourceStates\`, \`candidateStates\`, \`opportunityStates\`, \`projectStates\`, \`states\` + \`typesOf\` (contacts), \`states\` seul (sociétés — il n'y a pas de filtre de type sur \`/companies\`). Pour les traduire en libellés, lire les ressources \`boond://dictionary/*\` (states, typeOf, countries, currencies, languages) plutôt que d'appeler \`boond_application_dictionary\` : même contenu, sans consommer un appel d'outil.`;
+//# sourceMappingURL=instructions.js.map

package/dist/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ugBAmCoe,CAAC"}

package/dist/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2KzE,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB;;;;GAQhC,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuF5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4KzE,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB;;;;GAQhC,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4F5D"}

package/dist/resources/index.js

@@ -1,6 +1,7 @@
 import { apiRequest } from "../services/boond-client.js";
 import { getDictionary, resolveDictionaryPath } from "../services/dictionary.js";
 import { getDictionaryOverrides } from "../config/dictionary-overrides.js";
+import { identityIcons, referenceIcons } from "../icons.js";
 /**
  * Curated dictionaries surfaced as static MCP resources. Slugs follow the
  * historical "kind/entity" naming for backward compatibility with client URIs;
@@ -152,6 +153,9 @@ export function registerAllResources(server) {
             title: dict.title,
             description: dict.description,
             mimeType: "application/json",
+            // SEP-973. Unlike tools/prompts, the SDK's resource listing spreads the
+            // whole config, so `icons` reaches the client with no shim needed.
+            icons: referenceIcons(),
         }, async () => {
             const { payload } = await getDictionary();
             const node = resolveDictionaryPath(payload, dict.path);
@@ -180,6 +184,7 @@ export function registerAllResources(server) {
         description: "Mapping libellé→ID configuré via BOOND_DICTIONARY_OVERRIDES (types d'action et états). " +
             'Renvoie { "configured": false } si aucun override n\'est configuré.',
         mimeType: "application/json",
+        icons: referenceIcons(),
     }, () => {
         const overrides = getDictionaryOverrides();
         return Promise.resolve({
@@ -200,6 +205,7 @@ export function registerAllResources(server) {
         description: "Profil de l'utilisateur authentifié auprès de l'API BoondManager (id, agence, permissions). " +
             "Utile pour résoudre 'mon ID' avant un appel filtré par perimeterManagers.",
         mimeType: "application/json",
+        icons: identityIcons(),
     }, async () => {
         const response = await apiRequest("/application/current-user");
         return {

package/dist/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"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"}

package/dist/schemas/filter-aliases.d.ts

@@ -0,0 +1,69 @@
+import type { DomainName } from "../constants.js";
+/**
+ * Wrong-filter-name → correction table, used to turn a `.strict()` schema
+ * rejection into something the model can act on in one turn (SEP-1303: input
+ * validation failures must surface as *tool* errors so the model can
+ * self-correct, not as opaque protocol errors).
+ *
+ * Why this exists: the six main search endpoints take filter names that must
+ * match the BoondManager API query parameters verbatim (see CLAUDE.md
+ * §*Search Filter Naming*). The schemas are `.strict()`, so a wrong name is
+ * rejected rather than silently ignored — but "Unrecognized key:
+ * \"mainManagers\"" tells the model *that* it was wrong, never *what to use
+ * instead*. Every entry below is a confusion we have actually seen (or that
+ * the API's own naming invites), mapped to the correct name plus the one-line
+ * reason the correct name behaves differently.
+ *
+ * The messages are consumed by `unknownFilterMessage()`, which the search
+ * schemas install as their unrecognized-key error (see
+ * `src/tools/validation-wrapper.ts`). Keep them short: they are read by a
+ * model mid-call, not by a human reading docs.
+ */
+export interface FilterAlias {
+    /** Input name to use instead. Absent when the filter simply does not exist on that endpoint. */
+    correct?: string;
+    /** One-line reason / usage note. Should say what the correct filter *does*, not just its name. */
+    hint: string;
+    /** Dictionary resource URI to read when the value is a state/type id. */
+    dictionary?: string;
+}
+/**
+ * Endpoints whose filter vocabulary differs (states/types are named after the
+ * entity). Everything else only gets the global table.
+ */
+export type SearchEndpoint = Extract<DomainName, "resources" | "candidates" | "contacts" | "companies" | "opportunities" | "projects">;
+/** Confusions that are wrong on every endpoint. */
+export declare const GLOBAL_FILTER_ALIASES: Readonly<Record<string, FilterAlias>>;
+/**
+ * Endpoint-specific confusions. `states` and `typeOf` are the two names the
+ * model reaches for by default; on four of the six endpoints they are prefixed
+ * with the entity, on `/contacts` it is `typesOf` (with the s), and
+ * `/companies` has no type filter at all.
+ */
+export declare const ENDPOINT_FILTER_ALIASES: Readonly<Record<SearchEndpoint, Readonly<Record<string, FilterAlias>>>>;
+/** Resolve a wrong filter name to its correction, endpoint-specific table first. */
+export declare function resolveFilterAlias(key: string, endpoint?: SearchEndpoint): FilterAlias | undefined;
+/**
+ * Closest accepted key within 2 edits (case/separator-insensitive), for typos
+ * the alias table doesn't know about (`pagesize`, `keywordType`, …).
+ */
+export declare function closestKey(key: string, validKeys: readonly string[]): string | undefined;
+/**
+ * Build the text returned to the model when a search call carries unknown
+ * filter names. Shape, per unknown key:
+ *
+ *   Filtre inconnu « mainManagers » → utiliser `perimeterManagers` (…).
+ *
+ * plus, when the correction is a state/type filter, the dictionary resource to
+ * read for the ids. Ends with the accepted filter list so the model can retry
+ * from the error alone rather than re-reading the whole tool schema.
+ *
+ * A correction is only printed when the replacement is **actually accepted by
+ * this endpoint**. The wrapper runs on every search tool, not just the six
+ * perimeter-aware ones, and the global table is written for those: telling
+ * `boond_invoices_search` to use `perimeterAgencies` (which it does not accept)
+ * sends the model into a second rejection, after which it typically drops the
+ * filter and reports a company-wide list as if it were scoped.
+ */
+export declare function unknownFilterMessage(keys: readonly string[], validKeys: readonly string[], endpoint?: SearchEndpoint): string;
+//# sourceMappingURL=filter-aliases.d.ts.map

package/dist/schemas/filter-aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-aliases.d.ts","sourceRoot":"","sources":["../../src/schemas/filter-aliases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,WAAW;IAC1B,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAClC,UAAU,EACV,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,eAAe,GAAG,UAAU,CACrF,CAAC;AAIF,mDAAmD;AACnD,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAuCvE,CAAC;AAKF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CA2D3G,CAAC;AAqBF,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,WAAW,GAAG,SAAS,CAOlG;AAgBD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAUxF;AAaD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,QAAQ,CAAC,EAAE,cAAc,GACxB,MAAM,CAkCR"}

package/dist/schemas/filter-aliases.js

@@ -0,0 +1,225 @@
+const PERIMETER_DYNAMIC_NOTE = 'pour « mes données / mon équipe », `perimeterDynamic: ["data"|"managers"]`';
+/** Confusions that are wrong on every endpoint. */
+export const GLOBAL_FILTER_ALIASES = {
+    mainmanagers: {
+        correct: "perimeterManagers",
+        hint: `IDs des managers dont on veut l'équipe (${PERIMETER_DYNAMIC_NOTE})`,
+    },
+    managers: {
+        correct: "perimeterManagers",
+        hint: `IDs des managers dont on veut l'équipe (${PERIMETER_DYNAMIC_NOTE})`,
+    },
+    agencies: { correct: "perimeterAgencies", hint: "IDs d'agences ; combiner avec `narrowPerimeter: true` pour un ET" },
+    poles: { correct: "perimeterPoles", hint: "IDs de pôles" },
+    businessunits: { correct: "perimeterBusinessUnits", hint: "IDs de business units" },
+    // Pagination: `maxResults` is the *API* name; the tools expose `pageSize`.
+    maxresults: { correct: "pageSize", hint: "le nom API `maxResults` est dérivé côté serveur" },
+    limit: { correct: "pageSize", hint: "nombre de résultats par page" },
+    perpage: { correct: "pageSize", hint: "nombre de résultats par page" },
+    offset: { correct: "page", hint: "pagination par numéro de page, pas par offset" },
+    start: { correct: "page", hint: "pagination par numéro de page, pas par offset" },
+    sortby: { correct: "sort", hint: "nom du champ de tri" },
+    orderby: { correct: "order", hint: '"asc" ou "desc"' },
+    q: { correct: "keywords", hint: "recherche plein texte" },
+    query: { correct: "keywords", hint: "recherche plein texte" },
+    search: { correct: "keywords", hint: "recherche plein texte" },
+    name: { correct: "keywords", hint: 'cibler un champ précis via `keywordsType` (ex: "lastName", "fullName")' },
+    fullname: { correct: "keywords", hint: '`keywordsType: "fullName"` avec `keywords: "NOM#PRENOM"`' },
+    lastname: { correct: "keywords", hint: '`keywordsType: "lastName"`' },
+    firstname: { correct: "keywords", hint: '`keywordsType: "firstName"`' },
+    email: { correct: "keywords", hint: '`keywordsType: "emails"`' },
+    emails: { correct: "keywords", hint: '`keywordsType: "emails"`' },
+    // Linked-entity lookups go through the `keywords` prefix syntax.
+    companyid: {
+        correct: "keywords",
+        hint: 'entité liée : `keywords: "CSOC<id>"` (projets : filtre `companies: [<id>]`)',
+    },
+    contactid: { correct: "keywords", hint: 'entité liée : `keywords: "CCON<id>"`' },
+    candidateid: { correct: "keywords", hint: 'entité liée : `keywords: "CAND<id>"`' },
+    resourceid: { correct: "keywords", hint: 'entité liée : `keywords: "COMP<id>"`' },
+    opportunityid: { correct: "keywords", hint: 'entité liée : `keywords: "AO<id>"`' },
+    projectid: { correct: "keywords", hint: 'entité liée : `keywords: "PRJ<id>"`' },
+};
+const STATES_URI = (entity) => `boond://dictionary/states/${entity}`;
+const TYPEOF_URI = (entity) => `boond://dictionary/typeOf/${entity}`;
+/**
+ * Endpoint-specific confusions. `states` and `typeOf` are the two names the
+ * model reaches for by default; on four of the six endpoints they are prefixed
+ * with the entity, on `/contacts` it is `typesOf` (with the s), and
+ * `/companies` has no type filter at all.
+ */
+export const ENDPOINT_FILTER_ALIASES = {
+    resources: {
+        states: { correct: "resourceStates", hint: "IDs d'états (entiers)", dictionary: STATES_URI("resources") },
+        excludestates: {
+            correct: "excludeResourceStates",
+            hint: "IDs d'états à exclure",
+            dictionary: STATES_URI("resources"),
+        },
+        typeof: { correct: "resourceTypes", hint: "IDs de types (entiers)", dictionary: TYPEOF_URI("resources") },
+        types: { correct: "resourceTypes", hint: "IDs de types (entiers)", dictionary: TYPEOF_URI("resources") },
+        typesof: { correct: "resourceTypes", hint: "IDs de types (entiers)", dictionary: TYPEOF_URI("resources") },
+    },
+    candidates: {
+        states: { correct: "candidateStates", hint: "IDs d'états (entiers)", dictionary: STATES_URI("candidates") },
+        typeof: { correct: "candidateTypes", hint: "IDs de types (entiers)", dictionary: TYPEOF_URI("resources") },
+        types: { correct: "candidateTypes", hint: "IDs de types (entiers)", dictionary: TYPEOF_URI("resources") },
+        typesof: { correct: "candidateTypes", hint: "IDs de types (entiers)", dictionary: TYPEOF_URI("resources") },
+    },
+    contacts: {
+        typeof: {
+            correct: "typesOf",
+            hint: "avec un `s` : `typesOf` (IDs entiers)",
+            dictionary: TYPEOF_URI("contacts"),
+        },
+        types: { correct: "typesOf", hint: "IDs de types de contact (entiers)", dictionary: TYPEOF_URI("contacts") },
+        contactstates: {
+            correct: "states",
+            hint: "sur /contacts le filtre s'appelle `states`",
+            dictionary: STATES_URI("contacts"),
+        },
+    },
+    companies: {
+        typeof: {
+            hint: "/companies n'expose aucun filtre de type — filtrer sur `states`, `activityAreas` ou après lecture",
+        },
+        types: {
+            hint: "/companies n'expose aucun filtre de type — filtrer sur `states`, `activityAreas` ou après lecture",
+        },
+        // `typesOf` is the correct name on /contacts, so the model transfers it here.
+        typesof: {
+            hint: "/companies n'expose aucun filtre de type (`typesOf` n'existe que sur /contacts) — filtrer sur `states` ou `activityAreas`",
+        },
+        companystates: {
+            correct: "states",
+            hint: "sur /companies le filtre s'appelle `states`",
+            dictionary: STATES_URI("companies"),
+        },
+    },
+    opportunities: {
+        states: { correct: "opportunityStates", hint: "IDs d'états (entiers)", dictionary: STATES_URI("opportunities") },
+        typeof: { correct: "opportunityTypes", hint: "IDs de types", dictionary: TYPEOF_URI("projects") },
+        types: { correct: "opportunityTypes", hint: "IDs de types", dictionary: TYPEOF_URI("projects") },
+    },
+    projects: {
+        states: { correct: "projectStates", hint: "IDs d'états (entiers)", dictionary: STATES_URI("projects") },
+        typeof: { correct: "projectTypes", hint: "IDs de types (entiers)", dictionary: TYPEOF_URI("projects") },
+        types: { correct: "projectTypes", hint: "IDs de types (entiers)", dictionary: TYPEOF_URI("projects") },
+        company: { correct: "companies", hint: "tableau d'IDs de sociétés, ex: `companies: [42]`" },
+    },
+};
+/**
+ * Lookup key: lowercase, separators stripped. So `max_results`, `maxResults`
+ * and `MAXRESULTS` all resolve to the same entry — the model's mistakes are
+ * about the *word*, not its casing.
+ */
+function normalizeKey(key) {
+    return key.toLowerCase().replace(/[-_\s]/g, "");
+}
+/**
+ * Own-property lookup. The tables are object literals, so a plain `table[norm]`
+ * happily returns `Object.prototype.constructor` / `toString` / `hasOwnProperty`
+ * for a filter named after them — a truthy value with no `.correct`/`.hint`,
+ * which used to print "Filtre inconnu « constructor » : undefined.".
+ */
+function lookupAlias(table, norm) {
+    return Object.hasOwn(table, norm) ? table[norm] : undefined;
+}
+/** Resolve a wrong filter name to its correction, endpoint-specific table first. */
+export function resolveFilterAlias(key, endpoint) {
+    const norm = normalizeKey(key);
+    if (endpoint !== undefined && Object.hasOwn(ENDPOINT_FILTER_ALIASES, endpoint)) {
+        const specific = lookupAlias(ENDPOINT_FILTER_ALIASES[endpoint], norm);
+        if (specific)
+            return specific;
+    }
+    return lookupAlias(GLOBAL_FILTER_ALIASES, norm);
+}
+/** Levenshtein distance, capped: we only care about "is it within 2 edits". */
+function editDistance(a, b, max) {
+    if (Math.abs(a.length - b.length) > max)
+        return max + 1;
+    let prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i++) {
+        const row = [i];
+        for (let j = 1; j <= b.length; j++) {
+            row[j] = Math.min(prev[j] + 1, row[j - 1] + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+        }
+        prev = row;
+    }
+    return prev[b.length];
+}
+/**
+ * Closest accepted key within 2 edits (case/separator-insensitive), for typos
+ * the alias table doesn't know about (`pagesize`, `keywordType`, …).
+ */
+export function closestKey(key, validKeys) {
+    const norm = normalizeKey(key);
+    let best;
+    for (const candidate of validKeys) {
+        const distance = editDistance(norm, normalizeKey(candidate), 2);
+        if (distance <= 2 && (best === undefined || distance < best.distance)) {
+            best = { key: candidate, distance };
+        }
+    }
+    return best?.key;
+}
+/** Cap the accepted-filters list so one bad key can't produce a wall of text. */
+const MAX_ACCEPTED_KEYS_LISTED = 25;
+/**
+ * Cap the number of per-key correction lines, for the same reason: the message
+ * is read by a model mid-call. A stray 40-key filter object would otherwise emit
+ * 40 lines (and 40 full Levenshtein scans) — several thousand characters on a
+ * path whose whole point is a short, actionable correction.
+ */
+const MAX_UNKNOWN_KEYS_EXPLAINED = 6;
+/**
+ * Build the text returned to the model when a search call carries unknown
+ * filter names. Shape, per unknown key:
+ *
+ *   Filtre inconnu « mainManagers » → utiliser `perimeterManagers` (…).
+ *
+ * plus, when the correction is a state/type filter, the dictionary resource to
+ * read for the ids. Ends with the accepted filter list so the model can retry
+ * from the error alone rather than re-reading the whole tool schema.
+ *
+ * A correction is only printed when the replacement is **actually accepted by
+ * this endpoint**. The wrapper runs on every search tool, not just the six
+ * perimeter-aware ones, and the global table is written for those: telling
+ * `boond_invoices_search` to use `perimeterAgencies` (which it does not accept)
+ * sends the model into a second rejection, after which it typically drops the
+ * filter and reports a company-wide list as if it were scoped.
+ */
+export function unknownFilterMessage(keys, validKeys, endpoint) {
+    const lines = [];
+    const explained = keys.slice(0, MAX_UNKNOWN_KEYS_EXPLAINED);
+    for (const key of explained) {
+        const alias = resolveFilterAlias(key, endpoint);
+        if (alias?.correct !== undefined && validKeys.includes(alias.correct)) {
+            const dict = alias.dictionary ? ` — IDs via ${alias.dictionary}` : "";
+            lines.push(`Filtre inconnu « ${key} » → utiliser \`${alias.correct}\` : ${alias.hint}${dict}.`);
+            continue;
+        }
+        // An endpoint-specific entry without `correct` says "this filter does not
+        // exist here" — that hint is always safe to print. A global correction whose
+        // replacement this endpoint doesn't accept is not, so it falls through.
+        if (alias !== undefined && alias.correct === undefined) {
+            lines.push(`Filtre inconnu « ${key} » : ${alias.hint}.`);
+            continue;
+        }
+        const near = closestKey(key, validKeys);
+        lines.push(near !== undefined
+            ? `Filtre inconnu « ${key} » → vouliez-vous dire \`${near}\` ?`
+            : `Filtre inconnu « ${key} » : non supporté par cet endpoint (ne pas le renvoyer).`);
+    }
+    if (keys.length > explained.length) {
+        lines.push(`… et ${keys.length - explained.length} autre(s) filtre(s) inconnu(s) à retirer.`);
+    }
+    const listed = validKeys.slice(0, MAX_ACCEPTED_KEYS_LISTED);
+    const suffix = validKeys.length > listed.length ? `, … (${validKeys.length} au total)` : "";
+    if (listed.length > 0) {
+        lines.push(`Filtres acceptés : ${listed.join(", ")}${suffix}.`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=filter-aliases.js.map