@ignfab/geocontext 0.8.2 → 0.9.1

package/dist/tools/AssietteSupTool.d.ts

@@ -1,22 +1,70 @@
 import { MCPTool } from "mcp-framework";
 import { z } from "zod";
-interface SupInput {
-    lon: number;
-    lat: number;
-}
-declare class AssietteSupTool extends MCPTool<SupInput> {
+declare const assietteSupInputSchema: z.ZodObject<{
+    lon: z.ZodNumber;
+    lat: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    lon?: number;
+    lat?: number;
+}, {
+    lon?: number;
+    lat?: number;
+}>;
+type AssietteSupInput = z.infer<typeof assietteSupInputSchema>;
+declare class AssietteSupTool extends MCPTool<AssietteSupInput> {
     name: string;
-    description: string;
-    schema: {
-        lon: {
-            type: z.ZodNumber;
-            description: string;
-        };
-        lat: {
-            type: z.ZodNumber;
-            description: string;
-        };
+    title: string;
+    annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
     };
-    execute(input: SupInput): Promise<any>;
+    description: string;
+    protected outputSchemaShape: z.ZodObject<{
+        results: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            id: z.ZodString;
+            bbox: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            distance: z.ZodNumber;
+        }, "strip", z.ZodUnknown, z.objectOutputType<{
+            type: z.ZodString;
+            id: z.ZodString;
+            bbox: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            distance: z.ZodNumber;
+        }, z.ZodUnknown, "strip">, z.objectInputType<{
+            type: z.ZodString;
+            id: z.ZodString;
+            bbox: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            distance: z.ZodNumber;
+        }, z.ZodUnknown, "strip">>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        results?: z.objectOutputType<{
+            type: z.ZodString;
+            id: z.ZodString;
+            bbox: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            distance: z.ZodNumber;
+        }, z.ZodUnknown, "strip">[];
+    }, {
+        results?: z.objectInputType<{
+            type: z.ZodString;
+            id: z.ZodString;
+            bbox: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            distance: z.ZodNumber;
+        }, z.ZodUnknown, "strip">[];
+    }>;
+    schema: z.ZodObject<{
+        lon: z.ZodNumber;
+        lat: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        lon?: number;
+        lat?: number;
+    }, {
+        lon?: number;
+        lat?: number;
+    }>;
+    execute(input: AssietteSupInput): Promise<{
+        results: any;
+    }>;
 }
 export default AssietteSupTool;

package/dist/tools/AssietteSupTool.js

@@ -1,22 +1,43 @@
-import { logger, MCPTool } from "mcp-framework";
+import { MCPTool } from "mcp-framework";
 import { z } from "zod";
 import { getAssiettesServitudes, URBANISME_SOURCE } from "../gpf/urbanisme.js";
+import logger from "../logger.js";
+import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "./toolAnnotations.js";
+const assietteSupInputSchema = 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 assietteSupResultSchema = z
+    .object({
+    type: z.string().describe("Le type d'assiette de servitude d'utilité publique renvoyé."),
+    id: z.string().describe("L'identifiant de l'assiette."),
+    bbox: z.array(z.number()).describe("La boîte englobante de l'assiette.").optional(),
+    distance: z.number().describe("La distance entre le point demandé et l'assiette retenue."),
+})
+    .catchall(z.unknown());
+const assietteSupOutputSchema = z.object({
+    results: z.array(assietteSupResultSchema).describe("La liste des assiettes de servitudes d'utilité publique pertinentes pour le point demandé."),
+});
 class AssietteSupTool extends MCPTool {
     name = "assiette_sup";
-    description = `Renvoie les assiettes des servitudes d'utilité publique (SUP) pour une position donnée par sa longitude et sa latitude (source: ${URBANISME_SOURCE}).`;
-    schema = {
-        lon: {
-            type: z.number(),
-            description: "La longitude du point",
-        },
-        lat: {
-            type: z.number(),
-            description: "La latitude du point",
-        },
-    };
+    title = "Servitudes d’utilité publique";
+    annotations = READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS;
+    description = `Renvoie, pour un point donné par sa longitude et sa latitude, la liste des assiettes de servitudes d'utilité publique (SUP) pertinentes à proximité, avec leurs propriétés associées. Les résultats peuvent inclure des assiettes ponctuelles, linéaires ou surfaciques. (source : ${URBANISME_SOURCE}).`;
+    outputSchemaShape = assietteSupOutputSchema;
+    schema = assietteSupInputSchema;
     async execute(input) {
         logger.info(`assiette_sup(${input.lon},${input.lat})...`);
-        return getAssiettesServitudes(input.lon, input.lat);
+        return {
+            results: await getAssiettesServitudes(input.lon, input.lat),
+        };
     }
 }
 export default AssietteSupTool;

package/dist/tools/AssietteSupTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssietteSupTool.js","sourceRoot":"","sources":["../../src/tools/AssietteSupTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAO/E,MAAM,eAAgB,SAAQ,OAAiB;IAC7C,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAAG,mIAAmI,gBAAgB,IAAI,CAAC;IAEtK,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,KAAe;QAC3B,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC;QAC1D,OAAO,sBAAsB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;CACF;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"AssietteSupTool.js","sourceRoot":"","sources":["../../src/tools/AssietteSupTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,MAAM,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,qCAAqC,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,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,uBAAuB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;IACxF,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC,QAAQ,EAAE;IACnF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;CAC3F,CAAC;KACD,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAEzB,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,QAAQ,CAAC,4FAA4F,CAAC;CACjJ,CAAC,CAAC;AAEH,MAAM,eAAgB,SAAQ,OAAyB;IACrD,IAAI,GAAG,cAAc,CAAC;IACtB,KAAK,GAAG,+BAA+B,CAAC;IACxC,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG,sRAAsR,gBAAgB,IAAI,CAAC;IAC/S,iBAAiB,GAAG,uBAAuB,CAAC;IAEtD,MAAM,GAAG,sBAAsB,CAAC;IAEhC,KAAK,CAAC,OAAO,CAAC,KAAuB;QACnC,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC;QAC1D,OAAO;YACL,OAAO,EAAE,MAAM,sBAAsB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC;SAC5D,CAAC;IACJ,CAAC;CACF;AAED,eAAe,eAAe,CAAC"}

package/dist/tools/CadastreTool.d.ts

@@ -1,22 +1,75 @@
 import { MCPTool } from "mcp-framework";
 import { z } from "zod";
-interface CadastreInput {
-    lon: number;
-    lat: number;
-}
+declare const cadastreInputSchema: z.ZodObject<{
+    lon: z.ZodNumber;
+    lat: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    lon?: number;
+    lat?: number;
+}, {
+    lon?: number;
+    lat?: number;
+}>;
+type CadastreInput = z.infer<typeof cadastreInputSchema>;
 declare class CadastreTool extends MCPTool<CadastreInput> {
     name: string;
-    description: string;
-    schema: {
-        lon: {
-            type: z.ZodNumber;
-            description: string;
-        };
-        lat: {
-            type: z.ZodNumber;
-            description: string;
-        };
+    title: string;
+    annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
     };
-    execute(input: CadastreInput): Promise<array<object>>;
+    description: string;
+    protected outputSchemaShape: z.ZodObject<{
+        results: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            id: z.ZodString;
+            bbox: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            distance: z.ZodNumber;
+            source: z.ZodString;
+        }, "strip", z.ZodUnknown, z.objectOutputType<{
+            type: z.ZodString;
+            id: z.ZodString;
+            bbox: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            distance: z.ZodNumber;
+            source: z.ZodString;
+        }, z.ZodUnknown, "strip">, z.objectInputType<{
+            type: z.ZodString;
+            id: z.ZodString;
+            bbox: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            distance: z.ZodNumber;
+            source: z.ZodString;
+        }, z.ZodUnknown, "strip">>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        results?: z.objectOutputType<{
+            type: z.ZodString;
+            id: z.ZodString;
+            bbox: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            distance: z.ZodNumber;
+            source: z.ZodString;
+        }, z.ZodUnknown, "strip">[];
+    }, {
+        results?: z.objectInputType<{
+            type: z.ZodString;
+            id: z.ZodString;
+            bbox: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            distance: z.ZodNumber;
+            source: z.ZodString;
+        }, z.ZodUnknown, "strip">[];
+    }>;
+    schema: z.ZodObject<{
+        lon: z.ZodNumber;
+        lat: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        lon?: number;
+        lat?: number;
+    }, {
+        lon?: number;
+        lat?: number;
+    }>;
+    execute(input: CadastreInput): Promise<{
+        results: array<object>;
+    }>;
 }
 export default CadastreTool;

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,32 +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;
+            }[];
         };
-    };
+    }, {
+        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<{
-        name: string;
-        title?: string;
-        abstract?: string;
-        boundingBox?: import("@camptocamp/ogc-client").BoundingBox;
-        defaultCrs: import("@camptocamp/ogc-client").CrsCode;
-        properties: Record<string, import("@camptocamp/ogc-client").FeaturePropertyType>;
-        geometryName?: string;
-        geometryType?: import("@camptocamp/ogc-client").FeatureGeometryType;
-        objectCount?: number;
-        keywords?: string[];
-    } | {
-        type: string;
-        message: any;
-        help: string;
+        result: Collection;
     }>;
 }
 export default GpfWfsDescribeTypeTool;