boondmanager-mcp-server 2.15.2 → 2.17.0

package/dist/tools/flags.js

@@ -1,12 +1,127 @@
-import { registerSearchTool, registerGetTool } from "./crud-factory.js";
+import { z } from "zod";
+import { AttachedFlagSchema, AttachedFlagsListSchema, FlagCreateSchema } from "../schemas/index.js";
+import { apiRequest, formatListResponse } from "../services/boond-client.js";
+import { buildJsonApiBody, registerCreateTool, registerGetTool, registerSearchTool } from "./crud-factory.js";
+import { composeDescription } from "./description-builders.js";
 const OPTS = {
     entityName: "drapeau",
     entityNamePlural: "drapeaux",
     apiPath: "/flags",
     prefix: "boond_flags",
 };
+/** API collection of each entity `attachedFlags.raml` covers. */
+const ENTITY_PATH = {
+    candidate: "/candidates",
+    resource: "/resources",
+    contact: "/contacts",
+    company: "/companies",
+    opportunity: "/opportunities",
+    project: "/projects",
+    order: "/orders",
+    product: "/products",
+    purchase: "/purchases",
+    action: "/actions",
+    positioning: "/positionings",
+    invoice: "/invoices",
+};
+const AttachOutputSchema = z.object({
+    entity: z.string(),
+    id: z.string(),
+    flagId: z.string(),
+    attached: z.boolean(),
+});
+/** `/flags` payload (issue #254): `name` + optional `mainManager` relationship (`models.flag`). */
+export function buildFlagBody(params) {
+    const { mainManagerId, ...attrs } = params;
+    return buildJsonApiBody("flag", attrs, undefined, {
+        mainManager: mainManagerId ? { id: String(mainManagerId), type: "resource" } : undefined,
+    });
+}
+/** `POST /attached-flags` payload: the flag and the flagged record, both as relationships (`dependsOn` is the polymorphic pattern of `models.task`). */
+export function buildAttachedFlagBody(params) {
+    return buildJsonApiBody("attachedflag", {}, undefined, {
+        flag: { id: params.flagId, type: "flag" },
+        dependsOn: { id: params.id, type: params.entity },
+    });
+}
 export function registerFlagTools(server) {
     registerSearchTool(server, OPTS);
     registerGetTool(server, OPTS, { withTab: false });
+    // Issue #254: writes. `POST /flags` and `POST|DELETE /attached-flags` are
+    // documented in the RAML (flags/search.raml, attachedFlags/search.raml);
+    // the POST bodies are not, and neither was exercised (production tenant).
+    registerCreateTool(server, OPTS, FlagCreateSchema, buildFlagBody, {
+        title: "Créer un drapeau",
+        description: composeDescription({
+            purpose: "Crée un drapeau (tag) réutilisable — « vivier Java Q4 », « à rappeler », « VIP ».",
+            when: "avant `boond_flags_attach` quand aucun drapeau existant ne convient (`boond_flags_search` d'abord).",
+            instead: "`boond_flags_attach` pour poser un drapeau existant sur un enregistrement.",
+            behaviour: [
+                "Écriture non idempotente : deux appels créent deux drapeaux homonymes.",
+                "Corps déduit de `models.flag` (`name`, `mainManager`) — non éprouvé sur un tenant de test.",
+            ],
+            returns: "confirmation et ID du drapeau (`structuredContent.id`).",
+        }),
+    });
+    server.registerTool("boond_flags_attached", {
+        title: "Drapeaux posés sur un enregistrement",
+        description: composeDescription({
+            purpose: "Liste les drapeaux (tags) posés sur un candidat, une ressource, un contact, une société, une opportunité, un projet, une commande, un produit, un achat, une action, un positionnement ou une facture.",
+            when: "pour savoir comment un enregistrement est tagué avant d'ajouter ou retirer un drapeau.",
+            instead: "`boond_flags_search` pour le catalogue des drapeaux existants (pas leurs rattachements).",
+            returns: "une ligne par drapeau posé (`GET /{entité}/{id}/attached-flags`). Lecture seule.",
+        }),
+        inputSchema: AttachedFlagsListSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        const { entity, id } = params;
+        const response = await apiRequest(`${ENTITY_PATH[entity]}/${id}/attached-flags`);
+        return { content: [{ type: "text", text: formatListResponse(response, "drapeau posé") }] };
+    });
+    server.registerTool("boond_flags_attach", {
+        title: "Poser un drapeau sur un enregistrement",
+        description: composeDescription({
+            purpose: "Pose un drapeau existant sur un enregistrement (tagging) — `POST /attached-flags`.",
+            when: "pour marquer un lot de fiches après un tri (« ces 12 candidats → vivier Java Q4 ») : un appel par fiche.",
+            instead: "`boond_flags_create` si le drapeau n'existe pas encore ; `boond_flags_detach` pour le retirer.",
+            behaviour: [
+                "Corps JSON:API `{ relationships: { flag, dependsOn } }` déduit du modèle — la RAML ne documente que la route ; non éprouvé sur un tenant de test.",
+                "Idempotent côté intention : reposer un drapeau déjà présent ne doit rien changer.",
+            ],
+            returns: "`{ entity, id, flagId, attached: true }`.",
+        }),
+        inputSchema: AttachedFlagSchema,
+        outputSchema: AttachOutputSchema,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        const p = params;
+        await apiRequest("/attached-flags", "POST", buildAttachedFlagBody(p));
+        return {
+            content: [{ type: "text", text: `✅ Drapeau #${p.flagId} posé sur ${p.entity} #${p.id}.` }],
+            structuredContent: { entity: p.entity, id: p.id, flagId: p.flagId, attached: true },
+        };
+    });
+    server.registerTool("boond_flags_detach", {
+        title: "Retirer un drapeau d'un enregistrement",
+        description: composeDescription({
+            purpose: "Retire un drapeau d'un enregistrement — `DELETE /attached-flags?flag=&<entité>=` (route et paramètres documentés dans la RAML).",
+            when: "pour dé-taguer une fiche ; réversible par `boond_flags_attach`, le drapeau lui-même n'est pas supprimé.",
+            instead: "aucun outil ne supprime un drapeau du catalogue : un drapeau se retire fiche par fiche.",
+            behaviour: [
+                "Idempotent : retirer un drapeau absent n'échoue pas côté intention (l'erreur API éventuelle est remontée telle quelle).",
+            ],
+            returns: "`{ entity, id, flagId, attached: false }`.",
+        }),
+        inputSchema: AttachedFlagSchema,
+        outputSchema: AttachOutputSchema,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        const p = params;
+        await apiRequest("/attached-flags", "DELETE", undefined, { flag: p.flagId, [p.entity]: p.id });
+        return {
+            content: [{ type: "text", text: `✅ Drapeau #${p.flagId} retiré de ${p.entity} #${p.id}.` }],
+            structuredContent: { entity: p.entity, id: p.id, flagId: p.flagId, attached: false },
+        };
+    });
 }
 //# sourceMappingURL=flags.js.map

package/dist/tools/flags.js.map

@@ -1 +1 @@
-{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/tools/flags.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAExE,MAAM,IAAI,GAAG;IACX,UAAU,EAAE,SAAS;IACrB,gBAAgB,EAAE,UAAU;IAC5B,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,aAAa;CACtB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/tools/flags.ts"],"names":[],"mappings":"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"}

package/dist/tools/forms.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** `/forms` payload (issue #256): `template` (required), polymorphic `dependsOn`, `validator` / `recipient` (`models.form`). */
+export declare function buildFormBody(params: Record<string, unknown>): unknown;
+export declare function registerFormTools(server: McpServer): void;
+//# sourceMappingURL=forms.d.ts.map

package/dist/tools/forms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.d.ts","sourceRoot":"","sources":["../../src/tools/forms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,gIAAgI;AAChI,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAatE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoDzD"}

package/dist/tools/forms.js

@@ -0,0 +1,64 @@
+import { FormCreateSchema, FormDefaultSchema } from "../schemas/index.js";
+import { apiRequest, formatDetailResponse } from "../services/boond-client.js";
+import { buildJsonApiBody, registerCreateTool, registerGetTool } from "./crud-factory.js";
+import { composeDescription } from "./description-builders.js";
+const OPTS = { entityName: "formulaire", entityNamePlural: "formulaires", apiPath: "/forms", prefix: "boond_forms" };
+/** `/forms` payload (issue #256): `template` (required), polymorphic `dependsOn`, `validator` / `recipient` (`models.form`). */
+export function buildFormBody(params) {
+    const { templateId, resourceId, candidateId, validatorId, recipientId, ...attrs } = params;
+    const dependsOn = resourceId
+        ? { id: String(resourceId), type: "resource" }
+        : candidateId
+            ? { id: String(candidateId), type: "candidate" }
+            : undefined;
+    return buildJsonApiBody("form", attrs, undefined, {
+        template: { id: String(templateId), type: "formtemplate" },
+        dependsOn,
+        validator: validatorId ? { id: String(validatorId), type: "resource" } : undefined,
+        recipient: recipientId ? { id: String(recipientId), type: "resource" } : undefined,
+    });
+}
+export function registerFormTools(server) {
+    server.registerTool("boond_forms_default", {
+        title: "Référentiels d'un formulaire",
+        description: composeDescription({
+            purpose: "Renvoie un formulaire vide pré-rempli pour un modèle et une entité (questions du modèle, validateur et destinataire par défaut).",
+            when: "AVANT `boond_forms_create`, pour connaître les questions et les dates que le modèle attend.",
+            instead: "`boond_forms_get` pour un formulaire déjà créé.",
+            behaviour: ["Lecture seule (`GET /forms/default?template=&resource=`) ; la réponse est rendue telle quelle."],
+            returns: "JSON du formulaire vide (questions incluses).",
+        }),
+        inputSchema: FormDefaultSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        const response = await apiRequest("/forms/default", "GET", undefined, {
+            template: params.templateId,
+            resource: params.resourceId,
+        });
+        return { content: [{ type: "text", text: formatDetailResponse(response) }] };
+    });
+    registerGetTool(server, OPTS, {
+        withTab: false,
+        title: "Détails d'un formulaire",
+        description: composeDescription({
+            purpose: "Récupère un formulaire (entretien annuel, bilan de fin de mission, évaluation) par son ID : questions, réponses, état, validateur.",
+            when: "après `boond_forms_create`, ou depuis l'ID lu dans les relations d'une ressource / d'un candidat.",
+            instead: "il n'existe pas de liste des formulaires côté API (`GET /forms` n'est pas documenté) ; `boond_tasks_get` avec `entity: \"form\"` pour ses tâches.",
+            returns: "JSON du formulaire (attributs + relations). Lecture seule.",
+        }),
+    });
+    registerCreateTool(server, OPTS, FormCreateSchema, buildFormBody, {
+        title: "Créer un formulaire",
+        description: composeDescription({
+            purpose: "Instancie un formulaire à partir d'un modèle (entretien annuel, bilan de fin de mission, évaluation) pour une ressource ou un candidat.",
+            when: "pour lancer une campagne d'évaluation ou un bilan, formulaire par formulaire.",
+            instead: "`boond_forms_default` d'abord, pour les questions et les dates attendues par le modèle.",
+            behaviour: [
+                "Corps déduit de `models.form` (`template`, `dependsOn`, `validator`, `recipient`, `validateDate`, `remindDate`) — non éprouvé sur un tenant de test ; exactement une entité visée parmi `resourceId` / `candidateId`.",
+                "Écriture non idempotente.",
+            ],
+            returns: "confirmation et ID du formulaire (`structuredContent.id`).",
+        }),
+    });
+}
+//# sourceMappingURL=forms.js.map

package/dist/tools/forms.js.map

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

package/dist/tools/groupments.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** `/groupments` payload (issue #256): `project` relationship (create), `deliveryIds` → `deliveries`, `note` → `informationComments` (`models.groupment`). */
+export declare function buildGroupmentBody(params: Record<string, unknown>): unknown;
+export declare function registerGroupmentTools(server: McpServer): void;
+//# sourceMappingURL=groupments.d.ts.map

package/dist/tools/groupments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupments.d.ts","sourceRoot":"","sources":["../../src/tools/groupments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAczE,8JAA8J;AAC9J,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAe3E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuD9D"}

package/dist/tools/groupments.js

@@ -0,0 +1,68 @@
+import { GroupmentCreateSchema, GroupmentDefaultSchema, GroupmentUpdateSchema } from "../schemas/index.js";
+import { apiRequest, formatDetailResponse } from "../services/boond-client.js";
+import { buildJsonApiBody, registerCreateTool, registerGetTool, registerUpdateTool } from "./crud-factory.js";
+import { composeDescription } from "./description-builders.js";
+const OPTS = {
+    entityName: "regroupement de prestations",
+    entityNamePlural: "regroupements de prestations",
+    apiPath: "/groupments",
+    prefix: "boond_groupments",
+};
+/** `/groupments` payload (issue #256): `project` relationship (create), `deliveryIds` → `deliveries`, `note` → `informationComments` (`models.groupment`). */
+export function buildGroupmentBody(params) {
+    const { id, projectId, deliveryIds, note, ...attrs } = params;
+    const body = buildJsonApiBody("groupment", { ...attrs, ...(note !== undefined ? { informationComments: note } : {}) }, typeof id === "string" ? id : undefined, { project: projectId ? { id: String(projectId), type: "project" } : undefined });
+    if (Array.isArray(deliveryIds) && deliveryIds.length > 0) {
+        body.data.relationships = {
+            ...(body.data.relationships ?? {}),
+            deliveries: { data: deliveryIds.map((d) => ({ id: String(d), type: "delivery" })) },
+        };
+    }
+    return body;
+}
+export function registerGroupmentTools(server) {
+    server.registerTool("boond_groupments_default", {
+        title: "Référentiels d'un regroupement de prestations",
+        description: composeDescription({
+            purpose: "Renvoie un regroupement vide pré-rempli pour un projet : prestations regroupables, prix et coûts par défaut.",
+            when: "AVANT `boond_groupments_create`.",
+            instead: "`boond_projects_deliveries_groupments` pour les prestations et regroupements déjà en place sur le projet.",
+            behaviour: ["Lecture seule (`GET /groupments/default?project=`) ; la réponse est rendue telle quelle."],
+            returns: "JSON du regroupement vide, prestations incluses.",
+        }),
+        inputSchema: GroupmentDefaultSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        const response = await apiRequest("/groupments/default", "GET", undefined, { project: params.projectId });
+        return { content: [{ type: "text", text: formatDetailResponse(response) }] };
+    });
+    registerGetTool(server, OPTS, {
+        withTab: false,
+        title: "Détails d'un regroupement de prestations",
+        description: composeDescription({
+            purpose: "Récupère un regroupement de prestations (facturation multi-prestations) par son ID.",
+            when: "depuis l'ID lu dans `boond_projects_deliveries_groupments`.",
+            instead: "`boond_projects_deliveries_groupments` pour la liste des regroupements d'un projet — il n'y a pas de liste globale.",
+            returns: "JSON du regroupement (attributs + relations `project`, `deliveries`). Lecture seule.",
+        }),
+    });
+    registerCreateTool(server, OPTS, GroupmentCreateSchema, buildGroupmentBody, {
+        title: "Créer un regroupement de prestations",
+        description: composeDescription({
+            purpose: "Regroupe plusieurs prestations d'un projet sous un même prix et une même période, pour les facturer ensemble.",
+            when: "pour la facturation multi-prestations (forfait sur plusieurs consultants, lot).",
+            instead: "`boond_groupments_default` d'abord ; `boond_groupments_update` pour ajuster un regroupement existant.",
+            behaviour: [
+                "Corps déduit de `models.groupment` (`title`, dates, prix / coûts journaliers, relations `project` / `deliveries`) — non éprouvé sur un tenant de test.",
+                "Écriture non idempotente.",
+            ],
+            returns: "confirmation et ID du regroupement (`structuredContent.id`).",
+        }),
+    });
+    // PUT /groupments/{id} — no information.raml, base resource like /deliveries/{id} (#252).
+    registerUpdateTool(server, OPTS, GroupmentUpdateSchema, buildGroupmentBody, {
+        method: "PUT",
+        title: "Modifier un regroupement de prestations",
+    });
+}
+//# sourceMappingURL=groupments.js.map

package/dist/tools/groupments.js.map

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

package/dist/tools/inactivities.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** `/inactivities` payload (issue #256): `resource` (required) / `contract` relationships, `note` → `informationComments` (`models.inactivity`). */
+export declare function buildInactivityBody(params: Record<string, unknown>): unknown;
+export declare function registerInactivityTools(server: McpServer): void;
+//# sourceMappingURL=inactivities.d.ts.map

package/dist/tools/inactivities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inactivities.d.ts","sourceRoot":"","sources":["../../src/tools/inactivities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAczE,oJAAoJ;AACpJ,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAW5E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkD/D"}

package/dist/tools/inactivities.js

@@ -0,0 +1,59 @@
+import { InactivityCreateSchema, InactivityDefaultSchema } from "../schemas/index.js";
+import { apiRequest, formatDetailResponse } from "../services/boond-client.js";
+import { buildJsonApiBody, registerCreateTool, registerGetTool } from "./crud-factory.js";
+import { composeDescription } from "./description-builders.js";
+const OPTS = {
+    entityName: "période d'inactivité",
+    entityNamePlural: "périodes d'inactivité",
+    apiPath: "/inactivities",
+    prefix: "boond_inactivities",
+};
+/** `/inactivities` payload (issue #256): `resource` (required) / `contract` relationships, `note` → `informationComments` (`models.inactivity`). */
+export function buildInactivityBody(params) {
+    const { resourceId, contractId, note, ...attrs } = params;
+    return buildJsonApiBody("inactivity", { ...attrs, ...(note !== undefined ? { informationComments: note } : {}) }, undefined, {
+        resource: { id: String(resourceId), type: "resource" },
+        contract: contractId ? { id: String(contractId), type: "contract" } : undefined,
+    });
+}
+export function registerInactivityTools(server) {
+    server.registerTool("boond_inactivities_default", {
+        title: "Référentiels d'une période d'inactivité",
+        description: composeDescription({
+            purpose: "Renvoie les valeurs par défaut d'une période d'inactivité (intercontrat, formation, congé sans solde…) pour une ressource : types d'inactivité, coût journalier retenu, contrat en cours.",
+            when: "AVANT `boond_inactivities_create` — le type d'inactivité n'est publié que là.",
+            instead: "`boond_resources_get` pour la fiche de la ressource ; `boond_reporting_resources` pour le taux d'occupation agrégé.",
+            behaviour: ["Lecture seule (`GET /inactivities/default?resource=`) ; la réponse est rendue telle quelle."],
+            returns: "JSON de l'inactivité vide pré-remplie, avec les types inclus.",
+        }),
+        inputSchema: InactivityDefaultSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        const response = await apiRequest("/inactivities/default", "GET", undefined, { resource: params.resourceId });
+        return { content: [{ type: "text", text: formatDetailResponse(response) }] };
+    });
+    registerGetTool(server, OPTS, {
+        withTab: false,
+        title: "Détails d'une période d'inactivité",
+        description: composeDescription({
+            purpose: "Récupère une période d'inactivité (intercontrat, formation…) par son ID.",
+            when: "après `boond_inactivities_create`, ou depuis l'ID lu dans les relations d'une ressource.",
+            instead: "il n'existe pas de liste des inactivités côté API (`GET /inactivities` n'est pas documenté) : `boond_reporting_resources` donne l'occupation, `boond_resources_get` la fiche.",
+            returns: "JSON de la période (attributs + relations). Lecture seule.",
+        }),
+    });
+    registerCreateTool(server, OPTS, InactivityCreateSchema, buildInactivityBody, {
+        title: "Créer une période d'inactivité",
+        description: composeDescription({
+            purpose: "Déclare une période d'inactivité (intercontrat, formation interne, congé sans solde…) pour une ressource, entre deux prestations.",
+            when: "quand une ressource sort de mission sans relais immédiat — c'est ce qui rend le taux d'occupation et le coût de l'intercontrat justes.",
+            instead: "`boond_absences_create` pour une absence (congés, maladie) ; `boond_deliveries_create` pour une nouvelle prestation.",
+            behaviour: [
+                "Corps déduit de `models.inactivity` (`title`, `startDate`, `endDate`, `inactivityType`, coûts, relations `resource` / `contract`) — non éprouvé sur un tenant de test.",
+                "Écriture non idempotente.",
+            ],
+            returns: "confirmation et ID de la période (`structuredContent.id`).",
+        }),
+    });
+}
+//# sourceMappingURL=inactivities.js.map

package/dist/tools/inactivities.js.map

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

package/dist/tools/index.d.ts

@@ -34,6 +34,10 @@ export { registerValidationTools } from "./validations.js";
 export { registerPoleTools } from "./poles.js";
 export { registerReportingTools } from "./reporting.js";
 export { registerPlanningAbsenceTools } from "./planning-absences.js";
+export { registerInactivityTools } from "./inactivities.js";
+export { registerFormTools } from "./forms.js";
+export { registerGroupmentTools } from "./groupments.js";
+export { registerAlertTools } from "./alerts.js";
 export { registerDocumentTools } from "./documents.js";
 export { registerWorkflowTools } from "./workflows.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tools/index.js

@@ -34,6 +34,10 @@ export { registerValidationTools } from "./validations.js";
 export { registerPoleTools } from "./poles.js";
 export { registerReportingTools } from "./reporting.js";
 export { registerPlanningAbsenceTools } from "./planning-absences.js";
+export { registerInactivityTools } from "./inactivities.js";
+export { registerFormTools } from "./forms.js";
+export { registerGroupmentTools } from "./groupments.js";
+export { registerAlertTools } from "./alerts.js";
 export { registerDocumentTools } from "./documents.js";
 export { registerWorkflowTools } from "./workflows.js";
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tools/invoices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invoices.d.ts","sourceRoot":"","sources":["../../src/tools/invoices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8DzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiD5D"}
+{"version":3,"file":"invoices.d.ts","sourceRoot":"","sources":["../../src/tools/invoices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuFzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqD5D"}

package/dist/tools/invoices.js

@@ -1,13 +1,35 @@
+import { toKeywordReferences } from "./linked-entity-filters.js";
 import { InvoiceSearchSchema, InvoiceCreateSchema, InvoiceUpdateSchema } from "../schemas/index.js";
 import { apiRequest, buildSearchQuery, formatListResponse } from "../services/boond-client.js";
 import { buildJsonApiBody, buildListStructured, SearchOutputSchema, registerGetTool, registerCreateTool, registerUpdateTool, registerDeleteTool, } from "./crud-factory.js";
 import { defaultDeleteDescription } from "./description-builders.js";
+import { registerTabTools } from "./tab-tools.js";
 const OPTS = {
     entityName: "facture",
     entityNamePlural: "factures",
     apiPath: "/invoices",
     prefix: "boond_invoices",
 };
+// `ENTITY_TABS.invoices` — verified live on 2026-09-26 (issue #258).
+const INVOICE_TABS = [
+    {
+        name: "information",
+        tab: "information",
+        title: "Informations complètes d'une facture",
+        subject: "les informations complètes",
+        content: "lignes facturées, coordonnées de facturation et bancaires, échéance, état d'envoi, commande et projet liés",
+        returns: "Fiche complète de la facture (relations société, contact, commande, projet, prestation incluses).",
+    },
+    {
+        name: "actions",
+        tab: "actions",
+        title: "Actions liées à une facture",
+        subject: "les actions",
+        content: "envois, relances, notes",
+        returns: "Liste des actions rattachées à la facture, la plus récente en premier.",
+        behaviour: ["Un envoi de facture par e-mail apparaît ici comme une action, avec ses destinataires dans `text`."],
+    },
+];
 /** Maps convenience inputs and simple amount fields to the Boond JSON:API body. */
 function buildInvoiceBody(params) {
     const { id, orderId, companyId, projectId, ...rest } = params;
@@ -48,7 +70,9 @@ export function registerInvoiceTools(server) {
     // search does not model.
     server.registerTool("boond_invoices_search", {
         title: "Rechercher des factures",
-        description: `Liste et recherche les factures client, par société, projet, état ou période.
+        description: `Liste et recherche les factures client, par société, projet, état (\`states\`), période (\`period\` + dates, ou \`periodDynamic\`), périmètre (\`perimeter*\`) ou avoir / facture (\`creditNote\`).
+
+\`companyId\` / \`projectId\` sont convertis en références \`keywords\` (\`CSOC<id>\`, \`PRJ<id>\`) — l'API n'a pas de paramètre dédié et ignorerait un \`companyId\` brut.
 
 Returns : page de résumés (référence, date, montants HT/TTC, état). Lecture seule.`,
         inputSchema: InvoiceSearchSchema,
@@ -60,7 +84,7 @@ Returns : page de résumés (référence, date, montants HT/TTC, état). Lecture
             openWorldHint: true,
         },
     }, async (params) => {
-        const query = buildSearchQuery(params);
+        const query = buildSearchQuery(toKeywordReferences(params));
         if (params.startDate)
             query["startDate"] = params.startDate;
         if (params.endDate)
@@ -88,5 +112,6 @@ Returns : page de résumés (référence, date, montants HT/TTC, état). Lecture
             prefix: "boond_invoices",
         }),
     });
+    registerTabTools(server, OPTS, INVOICE_TABS);
 }
 //# sourceMappingURL=invoices.js.map

package/dist/tools/invoices.js.map

@@ -1 +1 @@
-{"version":3,"file":"invoices.js","sourceRoot":"","sources":["../../src/tools/invoices.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAC/F,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,MAAM,IAAI,GAAG;IACX,UAAU,EAAE,SAAS;IACrB,gBAAgB,EAAE,UAAU;IAC5B,OAAO,EAAE,WAAW;IACpB,MAAM,EAAE,gBAAgB;CACzB,CAAC;AAEF,mFAAmF;AACnF,SAAS,gBAAgB,CAAC,MAA+B;IACvD,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAC9D,OAAO,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAwB,EAAE;QACpF,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;QACnE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;QAC3E,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;KAC5E,CAAC,CAAC;AACL,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAc,EAAE,OAAgB,EAAE,IAAa;IAC9E,OAAO;QACL,iBAAiB,EAAE,IAAI;QACvB,WAAW,EAAE,IAAI,IAAI,YAAY;QACjC,kBAAkB,EAAE,MAAM;QAC1B,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC;QACxB,KAAK,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,MAA+B;IACxD,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;IAC5E,OAAO;QACL,GAAG,KAAK;QACR,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,kBAAkB,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;YAC1E,CAAC,CAAC;gBACE,cAAc,EAAE;oBACd,uBAAuB,CACrB,MAAM,CAAC,kBAAkB,CAAC,EAC1B,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EACjD,IAA0B,CAC3B;iBACF;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,wEAAwE;IACxE,0EAA0E;IAC1E,yBAAyB;IACzB,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE;;mFAEgE;QAC7E,WAAW,EAAE,mBAAmB;QAChC,YAAY,EAAE,kBAAkB;QAChC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,SAAS;YAAE,KAAK,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC;QAC5D,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;QACtD,KAAK,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACxE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kBAAkB,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAClG,iBAAiB,EAAE,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;SAChE,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,gBAAgB,CAAC,CAAC;IACxE,wEAAwE;IACxE,8DAA8D;IAC9D,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,gBAAgB,EAAE;QACtE,MAAM,EAAE,KAAK;QACb,UAAU,EAAE,aAAa;KAC1B,CAAC,CAAC;IACH,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE;QAC/B,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,wBAAwB,CAAC;YACpC,UAAU,EAAE,SAAS;YACrB,gBAAgB,EAAE,UAAU;YAC5B,MAAM,EAAE,gBAAgB;SACzB,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"invoices.js","sourceRoot":"","sources":["../../src/tools/invoices.ts"],"names":[],"mappings":"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"}

package/dist/tools/linked-entity-filters.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Linked-entity filters → `keywords` references (issue #247).
+ *
+ * BoondManager's list endpoints have **no** `companyId` / `projectId` /
+ * `resourceId` query parameters. A related entity is selected through a
+ * prefixed reference inside `keywords` — `CSOC<id>` (company), `PRJ<id>`
+ * (project), `COMP<id>` (resource), `CAND<id>` (candidate), `CCON<id>`
+ * (contact), `AO<id>` (opportunity), `ACH<id>` (purchase), `BDC<id>` (order),
+ * `FACT<id>` (invoice), `MIS<id>` (delivery), `PROD<id>` (product),
+ * `CTR<id>` (contract) — documented per endpoint in the RAML and verified
+ * against the live API on 2026-09-25: `GET /invoices?companyId=6221` returned
+ * the whole table (29 893 rows, same as with no filter at all), while
+ * `keywords=CSOC6221` returned 2. An unknown query parameter is ignored
+ * silently, so a tool that forwarded `companyId` verbatim answered "the
+ * invoices of X" with *every* invoice, presented as filtered.
+ *
+ * The search schemas keep the `*Id` fields — they are what a model reaches
+ * for — and every search handler runs its params through `toKeywordReferences`
+ * before building the query, so the conversion cannot be forgotten per domain.
+ * Not every endpoint honours every prefix (the RAML lists them); a prefix an
+ * endpoint does not know simply matches nothing, which is still a visible
+ * "0 results", never a silently unfiltered page.
+ */
+export declare const KEYWORD_PREFIX_BY_FILTER: {
+    readonly candidateId: "CAND";
+    readonly resourceId: "COMP";
+    readonly contactId: "CCON";
+    readonly companyId: "CSOC";
+    readonly projectId: "PRJ";
+    readonly opportunityId: "AO";
+    readonly purchaseId: "ACH";
+    readonly orderId: "BDC";
+    readonly invoiceId: "FACT";
+    readonly deliveryId: "MIS";
+    readonly productId: "PROD";
+    readonly contractId: "CTR";
+};
+export type LinkedEntityFilter = keyof typeof KEYWORD_PREFIX_BY_FILTER;
+/**
+ * Move every linked-entity `*Id` filter present in `params` into `keywords`
+ * as `<PREFIX><id>` (appended after the caller's own keywords, space
+ * separated) and drop the `*Id` keys. Keys that are absent or `undefined` are
+ * left alone; other keys pass through untouched.
+ */
+export declare function toKeywordReferences<T extends Record<string, unknown>>(params: T): Omit<T, LinkedEntityFilter> & {
+    keywords?: string;
+};
+//# sourceMappingURL=linked-entity-filters.d.ts.map

package/dist/tools/linked-entity-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-entity-filters.d.ts","sourceRoot":"","sources":["../../src/tools/linked-entity-filters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;CAa3B,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,wBAAwB,CAAC;AAIvE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,MAAM,EAAE,CAAC,GACR,IAAI,CAAC,CAAC,EAAE,kBAAkB,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAcrD"}