@ignfab/geocontext 0.9.0 → 0.9.1

package/dist/tools/CadastreTool.js

@@ -1,22 +1,44 @@
-import { logger, MCPTool } from "mcp-framework";
+import { MCPTool } from "mcp-framework";
 import { z } from "zod";
 import { getParcellaireExpress, PARCELLAIRE_EXPRESS_TYPES, PARCELLAIRE_EXPRESS_SOURCE } from "../gpf/parcellaire-express.js";
+import logger from "../logger.js";
+import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "./toolAnnotations.js";
+const cadastreInputSchema = z.object({
+    lon: z
+        .number()
+        .min(-180)
+        .max(180)
+        .describe("La longitude du point."),
+    lat: z
+        .number()
+        .min(-90)
+        .max(90)
+        .describe("La latitude du point."),
+});
+const cadastreResultSchema = z
+    .object({
+    type: z.string().describe(`Le type d'objet cadastral (${PARCELLAIRE_EXPRESS_TYPES.join(", ")}).`),
+    id: z.string().describe("L'identifiant de l'objet cadastral."),
+    bbox: z.array(z.number()).describe("La boîte englobante de l'objet cadastral.").optional(),
+    distance: z.number().describe("La distance entre le point demandé et l'objet cadastral retenu."),
+    source: z.string().describe("La source des données cadastrales."),
+})
+    .catchall(z.unknown());
+const cadastreOutputSchema = z.object({
+    results: z.array(cadastreResultSchema).describe("La liste des objets cadastraux les plus proches du point demandé."),
+});
 class CadastreTool extends MCPTool {
     name = "cadastre";
-    description = `Renvoie les informations cadastrales (${PARCELLAIRE_EXPRESS_TYPES.join(', ')}) pour une position donnée par sa longitude et sa latitude (source :${PARCELLAIRE_EXPRESS_SOURCE}).`;
-    schema = {
-        lon: {
-            type: z.number(),
-            description: "La longitude du point",
-        },
-        lat: {
-            type: z.number(),
-            description: "La latitude du point",
-        },
-    };
+    title = "Informations cadastrales";
+    annotations = READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS;
+    description = `Renvoie, pour un point donné par sa longitude et sa latitude, la liste des objets cadastraux (${PARCELLAIRE_EXPRESS_TYPES.join(', ')}) les plus proches, avec leurs informations associées. Les résultats sont retournés au plus une fois par type lorsqu'ils sont disponibles. (source : ${PARCELLAIRE_EXPRESS_SOURCE}).`;
+    outputSchemaShape = cadastreOutputSchema;
+    schema = cadastreInputSchema;
     async execute(input) {
         logger.info(`cadastre(${input.lon},${input.lat})...`);
-        return getParcellaireExpress(input.lon, input.lat);
+        return {
+            results: await getParcellaireExpress(input.lon, input.lat),
+        };
     }
 }
 export default CadastreTool;

package/dist/tools/CadastreTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"CadastreTool.js","sourceRoot":"","sources":["../../src/tools/CadastreTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAO7H,MAAM,YAAa,SAAQ,OAAsB;IAC/C,IAAI,GAAG,UAAU,CAAC;IAClB,WAAW,GAAG,yCAAyC,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,uEAAuE,0BAA0B,IAAI,CAAC;IAEjM,MAAM,GAAG;QACP,GAAG,EAAE;YACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,WAAW,EAAE,uBAAuB;SACrC;QACD,GAAG,EAAE;YACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,WAAW,EAAE,sBAAsB;SACpC;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAAoB;QAChC,MAAM,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC;QACtD,OAAO,qBAAqB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC;CACF;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"CadastreTool.js","sourceRoot":"","sources":["../../src/tools/CadastreTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC7H,OAAO,MAAM,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,qCAAqC,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,GAAG,CAAC;SACT,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,wBAAwB,CAAC;IACrC,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,CAAC;SACR,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,uBAAuB,CAAC;CACrC,CAAC,CAAC;AAIH,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACjG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC,CAAC,QAAQ,EAAE;IAC1F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;IAChG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CAClE,CAAC;KACD,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAEzB,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,mEAAmE,CAAC;CACrH,CAAC,CAAC;AAEH,MAAM,YAAa,SAAQ,OAAsB;IAC/C,IAAI,GAAG,UAAU,CAAC;IAClB,KAAK,GAAG,0BAA0B,CAAC;IACnC,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG,iGAAiG,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,wJAAwJ,0BAA0B,IAAI,CAAC;IAChU,iBAAiB,GAAG,oBAAoB,CAAC;IAEnD,MAAM,GAAG,mBAAmB,CAAC;IAE7B,KAAK,CAAC,OAAO,CAAC,KAAoB;QAChC,MAAM,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC;QACtD,OAAO;YACL,OAAO,EAAE,MAAM,qBAAqB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC;SAC3D,CAAC;IACJ,CAAC;CACF;AAED,eAAe,YAAY,CAAC"}

package/dist/tools/GeocodeTool.d.ts

@@ -1,17 +1,80 @@
 import { MCPTool } from "mcp-framework";
 import { z } from "zod";
-interface GeocodeInput {
-    text: string;
-}
+declare const geocodeInputSchema: z.ZodObject<{
+    text: z.ZodString;
+    maximumResponses: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    text?: string;
+    maximumResponses?: number;
+}, {
+    text?: string;
+    maximumResponses?: number;
+}>;
+type GeocodeInput = z.infer<typeof geocodeInputSchema>;
 declare class GeocodeTool extends MCPTool<GeocodeInput> {
     name: string;
-    description: string;
-    schema: {
-        text: {
-            type: z.ZodString;
-            description: string;
-        };
+    title: string;
+    annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
     };
-    execute(input: GeocodeInput): Promise<any>;
+    description: string;
+    protected outputSchemaShape: z.ZodObject<{
+        results: z.ZodArray<z.ZodObject<{
+            lon: z.ZodNumber;
+            lat: z.ZodNumber;
+            fulltext: z.ZodString;
+            kind: z.ZodOptional<z.ZodString>;
+            city: z.ZodOptional<z.ZodString>;
+            zipcode: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            lon?: number;
+            lat?: number;
+            fulltext?: string;
+            kind?: string;
+            city?: string;
+            zipcode?: string;
+        }, {
+            lon?: number;
+            lat?: number;
+            fulltext?: string;
+            kind?: string;
+            city?: string;
+            zipcode?: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        results?: {
+            lon?: number;
+            lat?: number;
+            fulltext?: string;
+            kind?: string;
+            city?: string;
+            zipcode?: string;
+        }[];
+    }, {
+        results?: {
+            lon?: number;
+            lat?: number;
+            fulltext?: string;
+            kind?: string;
+            city?: string;
+            zipcode?: string;
+        }[];
+    }>;
+    schema: z.ZodObject<{
+        text: z.ZodString;
+        maximumResponses: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        text?: string;
+        maximumResponses?: number;
+    }, {
+        text?: string;
+        maximumResponses?: number;
+    }>;
+    execute(input: GeocodeInput): Promise<{
+        results: any;
+    }>;
 }
 export default GeocodeTool;

package/dist/tools/GeocodeTool.js

@@ -2,18 +2,44 @@ import { MCPTool } from "mcp-framework";
 import { z } from "zod";
 import { geocode, GEOCODE_SOURCE } from "../gpf/geocode.js";
 import logger from "../logger.js";
+import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "./toolAnnotations.js";
+const geocodeInputSchema = z.object({
+    text: z
+        .string()
+        .trim()
+        .min(1, "le texte ne doit pas être vide")
+        .describe("Le texte devant être completé et géocodé"),
+    maximumResponses: z
+        .number()
+        .int()
+        .min(1)
+        .max(10)
+        .optional()
+        .describe("Le nombre maximum de résultats à retourner (entre 1 et 10). Défaut : 3."),
+});
+const geocodeResultSchema = z.object({
+    lon: z.number().describe("La longitude du résultat."),
+    lat: z.number().describe("La latitude du résultat."),
+    fulltext: z.string().describe("Le libellé complet du résultat."),
+    kind: z.string().describe("La nature du résultat géocodé.").optional(),
+    city: z.string().describe("La commune du résultat.").optional(),
+    zipcode: z.string().describe("Le code postal du résultat.").optional(),
+});
+const geocodeOutputSchema = z.object({
+    results: z.array(geocodeResultSchema).describe("La liste ordonnée des résultats géocodés."),
+});
 class GeocodeTool extends MCPTool {
     name = "geocode";
-    description = `Renvoie les coordonnées (lon,lat) d'un lieu en complétant les informations (source : ${GEOCODE_SOURCE}).`;
-    schema = {
-        text: {
-            type: z.string(),
-            description: "Le texte devant être completé et géocodé",
-        },
-    };
+    title = "Géocodage de lieux et d’adresses";
+    annotations = READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS;
+    description = `Renvoie des résultats d'autocomplétion géocodés à partir d'un texte libre (lieu, adresse, POI), avec coordonnées, libellé complet et informations de localisation (kind, city, zipcode). (source : ${GEOCODE_SOURCE}).`;
+    outputSchemaShape = geocodeOutputSchema;
+    schema = geocodeInputSchema;
     async execute(input) {
-        logger.info(`geocode(${input.text})...`);
-        return geocode(input.text);
+        logger.info(`geocode(${input.text}, ${input.maximumResponses ?? 3})...`);
+        return {
+            results: await geocode(input.text, input.maximumResponses),
+        };
     }
 }
 export default GeocodeTool;

package/dist/tools/GeocodeTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeocodeTool.js","sourceRoot":"","sources":["../../src/tools/GeocodeTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,MAAM,MAAM,cAAc,CAAC;AAMlC,MAAM,WAAY,SAAQ,OAAqB;IAC7C,IAAI,GAAG,SAAS,CAAC;IACjB,WAAW,GAAG,wFAAwF,cAAc,IAAI,CAAC;IAEzH,MAAM,GAAG;QACP,IAAI,EAAE;YACJ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,WAAW,EAAE,0CAA0C;SACxD;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAAmB;QAC/B,MAAM,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC;QACzC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"GeocodeTool.js","sourceRoot":"","sources":["../../src/tools/GeocodeTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,MAAM,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,qCAAqC,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;SACxC,QAAQ,CAAC,0CAA0C,CAAC;IACvD,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,yEAAyE,CAAC;CACvF,CAAC,CAAC;AAIH,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACrD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAChE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CAAC,QAAQ,EAAE;IACtE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC,QAAQ,EAAE;IAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAAC,QAAQ,EAAE;CACvE,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CAC5F,CAAC,CAAC;AAEH,MAAM,WAAY,SAAQ,OAAqB;IAC7C,IAAI,GAAG,SAAS,CAAC;IACjB,KAAK,GAAG,kCAAkC,CAAC;IAC3C,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG,sMAAsM,cAAc,IAAI,CAAC;IAC7N,iBAAiB,GAAG,mBAAmB,CAAC;IAElD,MAAM,GAAG,kBAAkB,CAAC;IAE5B,KAAK,CAAC,OAAO,CAAC,KAAmB;QAC/B,MAAM,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,gBAAgB,IAAI,CAAC,MAAM,CAAC,CAAC;QACzE,OAAO;YACL,OAAO,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,gBAAgB,CAAC;SAC3D,CAAC;IACJ,CAAC;CACF;AAED,eAAe,WAAW,CAAC"}

package/dist/tools/GpfWfsDescribeTypeTool.d.ts

@@ -1,21 +1,124 @@
 import { MCPTool } from "mcp-framework";
 import { z } from "zod";
-interface GpfWfsDescribeTypeInput {
-    typename: string;
-}
+import type { Collection } from "@ignfab/gpf-schema-store";
+declare const gpfWfsDescribeTypeInputSchema: z.ZodObject<{
+    typename: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    typename?: string;
+}, {
+    typename?: string;
+}>;
+type GpfWfsDescribeTypeInput = z.infer<typeof gpfWfsDescribeTypeInputSchema>;
 declare class GpfWfsDescribeTypeTool extends MCPTool<GpfWfsDescribeTypeInput> {
     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;
+    protected outputSchemaShape: z.ZodObject<{
+        result: z.ZodObject<{
+            id: z.ZodString;
+            namespace: z.ZodString;
+            name: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            properties: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodString;
+                title: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                enum: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                defaultCrs: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type?: string;
+                name?: string;
+                title?: string;
+                description?: string;
+                enum?: string[];
+                defaultCrs?: string;
+            }, {
+                type?: string;
+                name?: string;
+                title?: string;
+                description?: string;
+                enum?: string[];
+                defaultCrs?: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            id?: string;
+            namespace?: string;
+            name?: string;
+            title?: string;
+            description?: string;
+            properties?: {
+                type?: string;
+                name?: string;
+                title?: string;
+                description?: string;
+                enum?: string[];
+                defaultCrs?: string;
+            }[];
+        }, {
+            id?: string;
+            namespace?: string;
+            name?: string;
+            title?: string;
+            description?: string;
+            properties?: {
+                type?: string;
+                name?: string;
+                title?: string;
+                description?: string;
+                enum?: string[];
+                defaultCrs?: string;
+            }[];
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        result?: {
+            id?: string;
+            namespace?: string;
+            name?: string;
+            title?: string;
+            description?: string;
+            properties?: {
+                type?: string;
+                name?: string;
+                title?: string;
+                description?: string;
+                enum?: string[];
+                defaultCrs?: string;
+            }[];
         };
-    };
-    execute(input: GpfWfsDescribeTypeInput): Promise<import("@ignfab/gpf-schema-store/dist/types.js").Collection | {
-        type: string;
-        message: any;
-        help: string;
+    }, {
+        result?: {
+            id?: string;
+            namespace?: string;
+            name?: string;
+            title?: string;
+            description?: string;
+            properties?: {
+                type?: string;
+                name?: string;
+                title?: string;
+                description?: string;
+                enum?: string[];
+                defaultCrs?: string;
+            }[];
+        };
+    }>;
+    schema: z.ZodObject<{
+        typename: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        typename?: string;
+    }, {
+        typename?: string;
+    }>;
+    execute(input: GpfWfsDescribeTypeInput): Promise<{
+        result: Collection;
     }>;
 }
 export default GpfWfsDescribeTypeTool;

package/dist/tools/GpfWfsDescribeTypeTool.js

@@ -1,28 +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 {
-            return await wfsClient.getFeatureType(input.typename);
-        }
-        catch (e) {
+            const featureType = await wfsClient.getFeatureType(input.typename);
             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,OAAO,MAAM,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxD,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>;