@ignfab/geocontext 0.8.2 → 0.9.1

package/dist/tools/GpfWfsDescribeTypeTool.js

@@ -1,31 +1,54 @@
 import { MCPTool } from "mcp-framework";
 import { z } from "zod";
 import { wfsClient } from "../gpf/wfs.js";
+import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "./toolAnnotations.js";
+const gpfWfsDescribeTypeInputSchema = z.object({
+    typename: z
+        .string()
+        .trim()
+        .min(1, "le nom du type ne doit pas être vide")
+        .describe("Le nom du type (ex : BDTOPO_V3:batiment)"),
+});
+const gpfWfsPropertySchema = z.object({
+    name: z.string().describe("Le nom de la propriété."),
+    type: z.string().describe("Le type de la propriété."),
+    title: z.string().describe("Le titre lisible de la propriété.").optional(),
+    description: z.string().describe("La description de la propriété.").optional(),
+    enum: z.array(z.string()).describe("Les valeurs possibles de la propriété.").optional(),
+    defaultCrs: z.string().describe("Le système de coordonnées par défaut si la propriété est géométrique.").optional(),
+});
+const gpfWfsDescribeTypeOutputSchema = z.object({
+    result: z.object({
+        id: z.string().describe("L'identifiant complet du type WFS."),
+        namespace: z.string().describe("L'espace de nommage du type WFS."),
+        name: z.string().describe("Le nom court du type WFS."),
+        title: z.string().describe("Le titre lisible du type WFS."),
+        description: z.string().describe("La description du type WFS."),
+        properties: z.array(gpfWfsPropertySchema).describe("La liste des propriétés du type WFS."),
+    }).describe("La description détaillée du type WFS."),
+});
 class GpfWfsDescribeTypeTool extends MCPTool {
     name = "gpf_wfs_describe_type";
+    title = "Description d’un type WFS";
+    annotations = READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS;
     description = [
-        "Renvoie la description détaillée d'un type WFS donné par son nom fourni par gpf_wfs_search_types.",
+        "Renvoie le schéma détaillé d'un type WFS à partir de son identifiant (`typename`) : identifiants, description et liste des propriétés.",
+        "Utiliser ce tool après `gpf_wfs_search_types` pour inspecter les propriétés disponibles avant d'appeler `gpf_wfs_get_features`.",
+        "La sortie inclut notamment le type des propriétés, leur description, et leurs valeurs possibles (`enum`) lorsqu'elles existent.",
     ].join("\r\n");
-    schema = {
-        typename: {
-            type: z.string(),
-            description: "Le nom du type (ex : BDTOPO_V3:batiment)",
-        },
-    };
+    outputSchemaShape = gpfWfsDescribeTypeOutputSchema;
+    schema = gpfWfsDescribeTypeInputSchema;
     async execute(input) {
         try {
             const featureType = await wfsClient.getFeatureType(input.typename);
-            // remove useless fields outputFormats and otherCrs
-            const { outputFormats, otherCrs, ...result } = featureType;
-            return result;
-        }
-        catch (e) {
             return {
-                type: "error",
-                message: e.message,
-                help: `Utiliser gpf_get_feature_types pour trouver les types disponibles`
+                result: featureType,
             };
         }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            throw new Error(`${message}. Utiliser gpf_wfs_search_types pour trouver un type valide.`);
+        }
     }
 }
 export default GpfWfsDescribeTypeTool;

package/dist/tools/GpfWfsDescribeTypeTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"GpfWfsDescribeTypeTool.js","sourceRoot":"","sources":["../../src/tools/GpfWfsDescribeTypeTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAM1C,MAAM,sBAAuB,SAAQ,OAAgC;IACnE,IAAI,GAAG,uBAAuB,CAAC;IAC/B,WAAW,GAAG;QACZ,mGAAmG;KACpG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEf,MAAM,GAAG;QACP,QAAQ,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,WAAW,EAAE,0CAA0C;SACxD;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAA8B;QAC1C,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACnE,mDAAmD;YACnD,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,GAAG,WAAW,CAAC;YAC3D,OAAO,MAAM,CAAC;QAChB,CAAC;QAAA,OAAM,CAAC,EAAC,CAAC;YACR,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,IAAI,EAAE,mEAAmE;aAC1E,CAAA;QACH,CAAC;IACH,CAAC;CACF;AAED,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"GpfWfsDescribeTypeTool.js","sourceRoot":"","sources":["../../src/tools/GpfWfsDescribeTypeTool.ts"],"names":[],"mappings":"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"}

package/dist/tools/GpfWfsGetFeaturesTool.d.ts

@@ -1,40 +1,77 @@
 import { MCPTool } from "mcp-framework";
 import { z } from "zod";
-interface GpfWfsGetFeaturesInput {
-    typename: string;
+declare const gpfWfsGetFeaturesInputSchema: z.ZodObject<{
+    typename: z.ZodString;
+    property_names: z.ZodOptional<z.ZodString>;
+    sort_by: z.ZodOptional<z.ZodString>;
+    count: z.ZodOptional<z.ZodNumber>;
+    cql_filter: z.ZodOptional<z.ZodString>;
+    result_type: z.ZodOptional<z.ZodEnum<["results", "hits", "url"]>>;
+}, "strip", z.ZodTypeAny, {
+    cql_filter?: string;
+    typename?: string;
     property_names?: string;
-    count?: number;
     sort_by?: string;
+    count?: number;
+    result_type?: "results" | "hits" | "url";
+}, {
     cql_filter?: string;
-    result_type?: 'results' | 'hits' | 'url';
-}
+    typename?: string;
+    property_names?: string;
+    sort_by?: string;
+    count?: number;
+    result_type?: "results" | "hits" | "url";
+}>;
+type GpfWfsGetFeaturesInput = z.infer<typeof gpfWfsGetFeaturesInputSchema>;
 declare class GpfWfsGetFeaturesTool extends MCPTool<GpfWfsGetFeaturesInput> {
     name: string;
+    title: string;
+    annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
     description: string;
-    schema: {
-        typename: {
-            type: z.ZodString;
-            description: string;
-        };
-        property_names: {
-            type: z.ZodOptional<z.ZodString>;
-            description: string;
-        };
-        sort_by: {
-            type: z.ZodOptional<z.ZodString>;
-            description: string;
-        };
-        count: {
-            type: z.ZodOptional<z.ZodNumber>;
-            description: string;
-        };
-        cql_filter: {
-            type: z.ZodOptional<z.ZodString>;
-            description: string;
+    schema: z.ZodObject<{
+        typename: z.ZodString;
+        property_names: z.ZodOptional<z.ZodString>;
+        sort_by: z.ZodOptional<z.ZodString>;
+        count: z.ZodOptional<z.ZodNumber>;
+        cql_filter: z.ZodOptional<z.ZodString>;
+        result_type: z.ZodOptional<z.ZodEnum<["results", "hits", "url"]>>;
+    }, "strip", z.ZodTypeAny, {
+        cql_filter?: string;
+        typename?: string;
+        property_names?: string;
+        sort_by?: string;
+        count?: number;
+        result_type?: "results" | "hits" | "url";
+    }, {
+        cql_filter?: string;
+        typename?: string;
+        property_names?: string;
+        sort_by?: string;
+        count?: number;
+        result_type?: "results" | "hits" | "url";
+    }>;
+    protected createSuccessResponse(data: unknown): import("mcp-framework").ToolResponse | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        structuredContent: {
+            result_type?: "hits";
+            totalFeatures?: number;
         };
-        result_type: {
-            type: z.ZodOptional<z.ZodEnum<["results", "hits", "url"]>>;
-            description: string;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        structuredContent: {
+            url?: string;
+            result_type?: "url";
         };
     };
     execute(input: GpfWfsGetFeaturesInput): Promise<any>;

package/dist/tools/GpfWfsGetFeaturesTool.js

@@ -1,41 +1,111 @@
-import { logger, MCPTool } from "mcp-framework";
+import { MCPTool } from "mcp-framework";
 import { z } from "zod";
 import { GPF_WFS_URL } from "../gpf/wfs.js";
 import { fetchJSON } from "../helpers/http.js";
+import logger from "../logger.js";
+import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "./toolAnnotations.js";
+// This tool intentionally does not expose a single outputSchemaShape.
+// - `result_type="results"` can return a large FeatureCollection, and we
+// avoid duplicating that payload into structuredContent. 
+// - Compact modes (`hits`, `url`) are handled explicitly in createSuccessResponse().
+const gpfWfsGetFeaturesInputSchema = z.object({
+    typename: z
+        .string()
+        .trim()
+        .min(1, "le nom du type ne doit pas être vide")
+        .describe("L'identifiant exact du type WFS à interroger (ex : `BDTOPO_V3:batiment`). Ce paramètre détermine la collection interrogée et doit correspondre à un type valide. Utiliser `gpf_wfs_search_types` pour trouver un `typename` pertinent, puis `gpf_wfs_describe_type` pour inspecter ses propriétés avant la requête."),
+    property_names: z
+        .string()
+        .optional()
+        .describe("La liste des propriétés à inclure dans chaque objet renvoyé, séparées par des virgules (ex : \"code_insee,nom_officiel,geometrie\"). Ce paramètre limite les champs présents dans la réponse, sans filtrer les objets eux-mêmes. Les noms doivent correspondre exactement aux propriétés du type WFS ; utiliser `gpf_wfs_describe_type` pour les connaître."),
+    sort_by: z
+        .string()
+        .optional()
+        .describe("Les propriétés à utiliser pour trier les objets renvoyés, avec la syntaxe `field [A|D]` où `A` signifie tri ascendant et `D` tri descendant. Plusieurs critères peuvent être séparés par des virgules (ex : `nom_officiel A, population D`). Les noms doivent correspondre exactement aux propriétés du type WFS ; utiliser `gpf_wfs_describe_type` pour les connaître."),
+    count: z
+        .number()
+        .int()
+        .min(1)
+        .max(1000)
+        .optional()
+        .describe("Le nombre maximum d'objets à retourner dans la réponse (entre 1 et 1000). Ce paramètre limite les résultats renvoyés, sans modifier le nombre total d'objets correspondant à la requête. Il est surtout utile avec `result_type=\"results\"`."),
+    cql_filter: z
+        .string()
+        .optional()
+        .describe([
+        "Un filtre `cql_filter` GeoServer pour restreindre les objets renvoyés par la requête.",
+        "Il faut utiliser les noms exacts des propriétés du type WFS ; utiliser `gpf_wfs_describe_type` pour les connaître.",
+        "Attention : en `EPSG:4326`, les coordonnées des géométries doivent être exprimées en `lat lon` (y x), y compris pour les points, lignes et polygones.",
+        "Exemples :",
+        "- filtre attributaire : `code_insee = '75056'`",
+        "- filtre spatial point : `DWITHIN(geom,Point(48.8566 2.3522),100,meters)`",
+        "- filtre spatial polygone : `INTERSECTS(geom,POLYGON((48.85 2.34,48.86 2.34,48.86 2.36,48.85 2.36,48.85 2.34)))`",
+    ].join("\r\n")),
+    result_type: z
+        .enum(["results", "hits", "url"])
+        .optional()
+        .describe([
+        "Choisit le type de résultat renvoyé par le tool :",
+        "- `results` : retourne les objets trouvés sous forme de `FeatureCollection` GeoJSON complète (défaut)",
+        "- `hits` : retourne uniquement le nombre total d'objets correspondant à la requête",
+        "- `url` : retourne uniquement l'URL WFS construite pour la requête, utile pour inspection, débogage ou réutilisation côté client",
+    ].join("\r\n"))
+});
+const gpfWfsGetFeaturesHitsOutputSchema = z.object({
+    result_type: z.literal("hits").describe("Indique que la réponse contient uniquement un comptage."),
+    totalFeatures: z.number().describe("Le nombre total d'objets correspondant à la requête."),
+});
+const gpfWfsGetFeaturesUrlOutputSchema = z.object({
+    result_type: z.literal("url").describe("Indique que la réponse contient uniquement l'URL de la requête."),
+    url: z.string().describe("L'URL WFS générée pour la requête."),
+});
 class GpfWfsGetFeaturesTool extends MCPTool {
     name = "gpf_wfs_get_features";
-    description = "Permet de récupérer les objets pour un type WFS.";
-    schema = {
-        typename: {
-            type: z.string(),
-            description: "Le nom du type (ex : BDTOPO_V3:batiment). Important : Utiliser gpf_wfs_search_types pour trouver les types disponibles."
-        },
-        property_names: {
-            type: z.string().optional(),
-            description: 'La liste des propriétés séparées par des virgules (ex : "code_insee,nom_officiel,geometrie"). NB : adapter geometrie avec geometryName au niveau du type WFS. '
-        },
-        sort_by: {
-            type: z.string().optional(),
-            description: 'Trier selon une propriété (syntaxe : field1 [A|D], field2 [A|D], ... , fieldN [A|D])'
-        },
-        count: {
-            type: z.number().optional(),
-            description: "Le nombre d'objets à récupérer (ex : 10)"
-        },
-        cql_filter: {
-            type: z.string().optional(),
-            description: "Le filtre au format cql_filter de GeoServer. ATTENTION : il faut permuter les coordonnées pour EPSG:4326 (ex : 'DWITHIN(geom,Point(${lat} ${lon}),10,meters)')"
-        },
-        result_type: {
-            type: z.enum(['results', 'hits', 'url']).optional(),
-            description: [
-                "Type de résultat : ",
-                "- 'results' pour les données complètes (défaut)",
-                "- 'hits' pour le comptage uniquement",
-                "- 'url' pour récupérer l'URL de la requête (ex : affichage des données côté client dans une carte)"
-            ].join("\r\n")
+    title = "Lecture d’objets WFS";
+    annotations = READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS;
+    description = [
+        "Récupère les objets d'un type WFS à partir d'un `typename` valide, avec filtres, tri et sélection de propriétés optionnels.",
+        "Exécute une requête WFS sur un type connu (`typename`) et renvoie soit les objets trouvés, soit leur nombre total, soit l'URL WFS correspondante.",
+        "Utiliser `gpf_wfs_search_types` puis `gpf_wfs_describe_type` avant ce tool lorsque le type ou ses propriétés ne sont pas connus.",
+        "Le paramètre `result_type` permet de récupérer soit les données complètes (`results`), soit uniquement le comptage (`hits`), soit l'URL WFS générée (`url`).",
+        "Les paramètres optionnels permettent de filtrer, trier ou restreindre les champs et le nombre d'objets renvoyés.",
+    ].join("\r\n");
+    schema = gpfWfsGetFeaturesInputSchema;
+    createSuccessResponse(data) {
+        if (typeof data === "object" &&
+            data !== null &&
+            "result_type" in data &&
+            data.result_type === "hits" &&
+            "totalFeatures" in data &&
+            typeof data.totalFeatures === "number") {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(data.totalFeatures),
+                    },
+                ],
+                structuredContent: gpfWfsGetFeaturesHitsOutputSchema.parse(data),
+            };
+        }
+        if (typeof data === "object" &&
+            data !== null &&
+            "result_type" in data &&
+            data.result_type === "url" &&
+            "url" in data &&
+            typeof data.url === "string") {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: data.url,
+                    },
+                ],
+                structuredContent: gpfWfsGetFeaturesUrlOutputSchema.parse(data),
+            };
         }
-    };
+        return super.createSuccessResponse(data);
+    }
     async execute(input) {
         const params = {
             service: 'WFS',
@@ -48,7 +118,7 @@ class GpfWfsGetFeaturesTool extends MCPTool {
             params.cql_filter = input.cql_filter;
         }
         if (input.count) {
-            params.count = input.count;
+            params.count = String(input.count);
         }
         if (input.sort_by) {
             params.sortBy = input.sort_by;
@@ -57,32 +127,32 @@ class GpfWfsGetFeaturesTool extends MCPTool {
             params.propertyName = input.property_names;
         }
         // Si result_type est 'hits', on utilise count=1 pour récupérer juste le totalFeatures
+        // On fait cela parce que Geoserver ne renvoie pas de json avec resultType=hits
+        // On est obligé de faire une requete getfeature pour récupérer le totalFeatures...
         if (input.result_type === 'hits') {
-            params.count = 1;
+            params.count = "1";
             // On n'a pas besoin des propriétés détaillées pour un comptage
             delete params.propertyName;
         }
         const url = `${GPF_WFS_URL}?` + new URLSearchParams(params).toString();
         logger.info(`[gpf_wfs_get_features] ${url}`);
         if (input.result_type === 'url') {
-            return url;
+            return {
+                result_type: "url",
+                url,
+            };
         }
-        try {
-            const featureCollection = await fetchJSON(url);
-            // Si result_type est 'hits', on retourne juste le comptage
-            if (input.result_type === 'hits') {
-                return featureCollection.totalFeatures;
+        const featureCollection = await fetchJSON(url);
+        if (input.result_type === 'hits') {
+            if (typeof featureCollection?.totalFeatures !== "number") {
+                throw new Error("Le service WFS n'a pas retourné de comptage exploitable");
             }
-            return featureCollection;
-        }
-        catch (e) {
-            logger.error(`[gpf_wfs_get_features] ${e}`);
             return {
-                type: "error",
-                message: "Une erreur est survenue lors de la récupération des objets (utiliser gpf_wfs_describe_type pour lister les types disponibles avant d'appeler gpf_wfs_get_features)",
-                details: `${e}`
+                result_type: "hits",
+                totalFeatures: featureCollection.totalFeatures,
             };
         }
+        return featureCollection;
     }
 }
 export default GpfWfsGetFeaturesTool;

package/dist/tools/GpfWfsGetFeaturesTool.js.map

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

package/dist/tools/GpfWfsListTypesTool.d.ts

@@ -1,10 +1,22 @@
 import { MCPTool } from "mcp-framework";
-interface WfsTypesInput {
-}
-declare class GpfWfsListTypesTools extends MCPTool<WfsTypesInput> {
+import { z } from "zod";
+declare const gpfWfsListTypesInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+type GpfWfsListTypesInput = z.infer<typeof gpfWfsListTypesInputSchema>;
+declare class GpfWfsListTypesTool extends MCPTool<GpfWfsListTypesInput> {
     name: string;
+    title: string;
+    annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
     description: string;
-    schema: {};
-    execute(input: WfsTypesInput): Promise<string[]>;
+    schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    execute(input: GpfWfsListTypesInput): Promise<{
+        id: string;
+        title: string;
+        description: string;
+    }[]>;
 }
-export default GpfWfsListTypesTools;
+export default GpfWfsListTypesTool;

package/dist/tools/GpfWfsListTypesTool.js

@@ -1,18 +1,26 @@
 import { MCPTool } from "mcp-framework";
+import { z } from "zod";
+import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "./toolAnnotations.js";
 import { wfsClient } from "../gpf/wfs.js";
-class GpfWfsListTypesTools extends MCPTool {
+const gpfWfsListTypesInputSchema = z.object({});
+class GpfWfsListTypesTool extends MCPTool {
     name = "gpf_wfs_list_types";
+    title = "Liste complète des types WFS";
+    annotations = READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS;
     description = [
-        "Renvoie la liste des types WFS de la Géoplateforme (GPF). ATTENTION :",
-        "- Il y a plus de 700 résultats possibles",
-        "- Il est conseillé d'utiliser de préférence gpf_wfs_search_types pour filtrer les résultats.",
+        "Renvoie la liste complète des types WFS de la Géoplateforme (GPF).",
+        "Utiliser ce tool pour un inventaire exhaustif ou une exploration globale du catalogue.",
+        "Pour trouver rapidement un type pertinent à partir de mots-clés, utiliser de préférence gpf_wfs_search_types.",
     ].join("\r\n");
-    schema = {};
+    schema = gpfWfsListTypesInputSchema;
     async execute(input) {
         const featureTypes = await wfsClient.getFeatureTypes();
-        const featureTypeNames = featureTypes.map((featureType) => featureType.name);
-        return featureTypeNames;
+        return featureTypes.map((featureType) => ({
+            id: featureType.id,
+            title: featureType.title,
+            description: featureType.description,
+        }));
     }
 }
-export default GpfWfsListTypesTools;
+export default GpfWfsListTypesTool;
 //# sourceMappingURL=GpfWfsListTypesTool.js.map

package/dist/tools/GpfWfsListTypesTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"GpfWfsListTypesTool.js","sourceRoot":"","sources":["../../src/tools/GpfWfsListTypesTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAK1C,MAAM,oBAAqB,SAAQ,OAAsB;IACvD,IAAI,GAAG,oBAAoB,CAAC;IAC5B,WAAW,GAAG;QACZ,uEAAuE;QACvE,0CAA0C;QAC1C,8FAA8F;KAC/F,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEf,MAAM,GAAG,EAER,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAAoB;QAChC,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,eAAe,EAAE,CAAC;QACvD,MAAM,gBAAgB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC7E,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF;AAED,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"GpfWfsListTypesTool.js","sourceRoot":"","sources":["../../src/tools/GpfWfsListTypesTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qCAAqC,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAIhD,MAAM,mBAAoB,SAAQ,OAA6B;IAC7D,IAAI,GAAG,oBAAoB,CAAC;IAC5B,KAAK,GAAG,8BAA8B,CAAC;IACvC,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG;QACZ,oEAAoE;QACpE,wFAAwF;QACxF,+GAA+G;KAChH,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACf,MAAM,GAAG,0BAA0B,CAAC;IAEpC,KAAK,CAAC,OAAO,CAAC,KAA2B;QACvC,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,eAAe,EAAE,CAAC;QACvD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACxC,EAAE,EAAE,WAAW,CAAC,EAAE;YAClB,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,WAAW,EAAE,WAAW,CAAC,WAAW;SACrC,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAED,eAAe,mBAAmB,CAAC"}

package/dist/tools/GpfWfsSearchTypesTool.d.ts

@@ -1,22 +1,69 @@
 import { MCPTool } from "mcp-framework";
 import { z } from "zod";
-interface GpfWfsSearchTypesInput {
-    query: string;
-    max_results: number;
-}
+declare const gpfWfsSearchTypesInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    max_results: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query?: string;
+    max_results?: number;
+}, {
+    query?: string;
+    max_results?: number;
+}>;
+type GpfWfsSearchTypesInput = z.infer<typeof gpfWfsSearchTypesInputSchema>;
 declare class GpfWfsSearchTypesTool extends MCPTool<GpfWfsSearchTypesInput> {
     name: string;
+    title: string;
+    annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
     description: string;
-    schema: {
-        query: {
-            type: z.ZodString;
+    protected outputSchemaShape: z.ZodObject<{
+        results: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id?: string;
+            title?: string;
+            description?: string;
+        }, {
+            id?: string;
+            title?: string;
+            description?: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        results?: {
+            id?: string;
+            title?: string;
+            description?: string;
+        }[];
+    }, {
+        results?: {
+            id?: string;
+            title?: string;
+            description?: string;
+        }[];
+    }>;
+    schema: z.ZodObject<{
+        query: z.ZodString;
+        max_results: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        query?: string;
+        max_results?: number;
+    }, {
+        query?: string;
+        max_results?: number;
+    }>;
+    execute(input: GpfWfsSearchTypesInput): Promise<{
+        results: {
+            id: string;
+            title: string;
             description: string;
-        };
-        max_results: {
-            type: z.ZodOptional<z.ZodNumber>;
-            description: string;
-        };
-    };
-    execute(input: GpfWfsSearchTypesInput): Promise<string[]>;
+        }[];
+    }>;
 }
 export default GpfWfsSearchTypesTool;

package/dist/tools/GpfWfsSearchTypesTool.js

@@ -1,30 +1,51 @@
 import { MCPTool } from "mcp-framework";
 import { z } from "zod";
+import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "./toolAnnotations.js";
 import { wfsClient } from "../gpf/wfs.js";
+const gpfWfsSearchTypesInputSchema = z.object({
+    query: z
+        .string()
+        .trim()
+        .min(1, "la requête de recherche ne doit pas être vide")
+        .describe("La requête de recherche"),
+    max_results: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .optional()
+        .describe("Le nombre maximum de résultats à retourner (entre 1 et 50). Défaut : 10."),
+});
+const gpfWfsSearchTypeResultSchema = z.object({
+    id: z.string().describe("L'identifiant complet du type WFS."),
+    title: z.string().describe("Le titre lisible du type WFS."),
+    description: z.string().describe("La description du type WFS."),
+});
+const gpfWfsSearchTypesOutputSchema = z.object({
+    results: z.array(gpfWfsSearchTypeResultSchema).describe("La liste ordonnée des types WFS trouvés."),
+});
 class GpfWfsSearchTypesTool extends MCPTool {
     name = "gpf_wfs_search_types";
+    title = "Recherche de types WFS";
+    annotations = READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS;
     description = [
-        "Recherche par mot clé dans la liste des types WFS de la Géoplateforme (GPF). Remarques :",
-        "- La recherche est une recherche textuelle simple (mini-search).",
-        "- Un LLM peut enrichir la recherche avec des mots clés supplémentaires.",
-        "- La recherche est limitée par défaut à 10 résultats",
-        "- Le paramètre max_results permet de changer le nombre de résultats (par exemple pour trouver toutes les tables BDTOPO ou toutes les tables communes)",
+        "Recherche des types WFS de la Géoplateforme (GPF) à partir de mots-clés afin de trouver un identifiant de type (`typename`) valide.",
+        "Utiliser ce tool avant `gpf_wfs_describe_type` ou `gpf_wfs_get_features` lorsque le nom exact du type n'est pas connu.",
+        "La recherche est textuelle (mini-search) et retourne une liste ordonnée de candidats avec leur identifiant, leur titre et leur description.",
+        "Le paramètre `max_results` permet d'élargir le nombre de candidats retournés (10 par défaut).",
     ].join("\r\n");
-    schema = {
-        query: {
-            type: z.string(),
-            description: "La requête de recherche",
-        },
-        max_results: {
-            type: z.number().optional(),
-            description: "Le nombre de résultats (10 par défaut)",
-        },
-    };
+    outputSchemaShape = gpfWfsSearchTypesOutputSchema;
+    schema = gpfWfsSearchTypesInputSchema;
     async execute(input) {
         const maxResults = input.max_results || 10;
         const featureTypes = await wfsClient.searchFeatureTypes(input.query, maxResults);
-        const featureTypeNames = featureTypes.map((featureType) => featureType.name);
-        return featureTypeNames;
+        return {
+            results: featureTypes.map((featureType) => ({
+                id: featureType.id,
+                title: featureType.title,
+                description: featureType.description,
+            })),
+        };
     }
 }
 export default GpfWfsSearchTypesTool;