@ignfab/geocontext 0.9.5 → 0.9.7

package/dist/tools/AltitudeTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"AltitudeTool.js","sourceRoot":"","sources":["../../src/tools/AltitudeTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,qCAAqC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAClD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACjD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;CACnF,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,qDAAqD,CAAC;CAC7F,CAAC,CAAC;AAEH,MAAM,YAAa,SAAQ,OAAsB;IAC/C,IAAI,GAAG,UAAU,CAAC;IAClB,KAAK,GAAG,yBAAyB,CAAC;IAClC,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG,wJAAwJ,eAAe,IAAI,CAAC;IAChL,iBAAiB,GAAG,oBAAoB,CAAC;IAEnD,MAAM,GAAG,mBAAmB,CAAC;IAE7B,KAAK,CAAC,OAAO,CAAC,KAAoB;QAChC,OAAO;YACL,MAAM,EAAE,MAAM,qBAAqB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC;SAC1D,CAAC;IACJ,CAAC;CACF;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"AltitudeTool.js","sourceRoot":"","sources":["../../src/tools/AltitudeTool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,qCAAqC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,MAAM,MAAM,cAAc,CAAC;AAElC,iBAAiB;AAEjB,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC,CAAC,MAAM,EAAE,CAAC;AAMZ,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAClD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACjD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;CACnF,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAElD,eAAe;AAEf,MAAM,YAAa,SAAQ,QAAuB;IAChD,IAAI,GAAG,UAAU,CAAC;IAClB,KAAK,GAAG,yBAAyB,CAAC;IAClC,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG,wJAAwJ,eAAe,IAAI,CAAC;IAChL,iBAAiB,GAAG,oBAAoB,CAAC;IAEnD,MAAM,GAAG,mBAAmB,CAAC;IAE7B;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,KAAoB;QAChC,MAAM,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,MAAM,EAAE;YAC7C,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QAEH,OAAO,MAAM,qBAAqB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;CACF;AAED,eAAe,YAAY,CAAC"}

package/dist/tools/AssietteSupTool.d.ts

@@ -1,17 +1,20 @@
-import { MCPTool } from "mcp-framework";
+/**
+ * MCP tool exposing nearby servitudes d'utilité publique for a given point.
+ */
+import BaseTool from "./BaseTool.js";
 import { z } from "zod";
 declare const assietteSupInputSchema: z.ZodObject<{
     lon: z.ZodNumber;
     lat: z.ZodNumber;
 }, "strict", z.ZodTypeAny, {
-    lon?: number;
-    lat?: number;
+    lon: number;
+    lat: number;
 }, {
-    lon?: number;
-    lat?: number;
+    lon: number;
+    lat: number;
 }>;
 type AssietteSupInput = z.infer<typeof assietteSupInputSchema>;
-declare class AssietteSupTool extends MCPTool<AssietteSupInput> {
+declare class AssietteSupTool extends BaseTool<AssietteSupInput> {
     name: string;
     title: string;
     annotations: {
@@ -30,11 +33,11 @@ declare class AssietteSupTool extends MCPTool<AssietteSupInput> {
                 typename: z.ZodString;
                 feature_id: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }>>;
             distance: z.ZodNumber;
         }, "strip", z.ZodUnknown, z.objectOutputType<{
@@ -45,11 +48,11 @@ declare class AssietteSupTool extends MCPTool<AssietteSupInput> {
                 typename: z.ZodString;
                 feature_id: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }>>;
             distance: z.ZodNumber;
         }, z.ZodUnknown, "strip">, z.objectInputType<{
@@ -60,16 +63,16 @@ declare class AssietteSupTool extends MCPTool<AssietteSupInput> {
                 typename: z.ZodString;
                 feature_id: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }>>;
             distance: z.ZodNumber;
         }, z.ZodUnknown, "strip">>, "many">;
     }, "strip", z.ZodTypeAny, {
-        results?: z.objectOutputType<{
+        results: z.objectOutputType<{
             type: z.ZodString;
             id: z.ZodString;
             bbox: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
@@ -77,16 +80,16 @@ declare class AssietteSupTool extends MCPTool<AssietteSupInput> {
                 typename: z.ZodString;
                 feature_id: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }>>;
             distance: z.ZodNumber;
         }, z.ZodUnknown, "strip">[];
     }, {
-        results?: z.objectInputType<{
+        results: z.objectInputType<{
             type: z.ZodString;
             id: z.ZodString;
             bbox: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
@@ -94,11 +97,11 @@ declare class AssietteSupTool extends MCPTool<AssietteSupInput> {
                 typename: z.ZodString;
                 feature_id: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }>>;
             distance: z.ZodNumber;
         }, z.ZodUnknown, "strip">[];
@@ -107,16 +110,30 @@ declare class AssietteSupTool extends MCPTool<AssietteSupInput> {
         lon: z.ZodNumber;
         lat: z.ZodNumber;
     }, "strict", z.ZodTypeAny, {
-        lon?: number;
-        lat?: number;
+        lon: number;
+        lat: number;
     }, {
-        lon?: number;
-        lat?: number;
+        lon: number;
+        lat: number;
     }>;
+    /**
+     * Looks up nearby SUP footprints relevant to the requested point.
+     *
+     * @param input Normalized tool input.
+     * @returns The list of nearby assiettes with optional reusable `feature_ref` metadata.
+     */
     execute(input: AssietteSupInput): Promise<{
-        results: {
+        results: (Record<string, unknown> & {
+            type: string;
+            id: string;
+            bbox?: number[];
+            feature_ref?: {
+                typename: string;
+                feature_id: string;
+            };
+        } & {
             distance: number;
-        }[];
+        })[];
     }>;
 }
 export default AssietteSupTool;

package/dist/tools/AssietteSupTool.js

@@ -1,8 +1,13 @@
-import { MCPTool } from "mcp-framework";
+/**
+ * MCP tool exposing nearby servitudes d'utilité publique for a given point.
+ */
+import BaseTool from "./BaseTool.js";
 import { z } from "zod";
 import { getAssiettesServitudes, URBANISME_SOURCE } from "../gpf/urbanisme.js";
 import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "../helpers/toolAnnotations.js";
 import { featureRefSchema, lonSchema, latSchema } from "../helpers/schemas.js";
+import logger from "../logger.js";
+// --- Schema ---
 const assietteSupInputSchema = z.object({
     lon: lonSchema,
     lat: latSchema,
@@ -19,7 +24,8 @@ const assietteSupResultSchema = z
 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 {
+// --- Tool ---
+class AssietteSupTool extends BaseTool {
     name = "assiette_sup";
     title = "Servitudes d’utilité publique";
     annotations = READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS;
@@ -27,11 +33,21 @@ class AssietteSupTool extends MCPTool {
         "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.",
         "Une SUP est une contrainte légale sur l'usage du sol liée à un équipement ou une infrastructure publique (ex : AC pour patrimoine, EL pour voirie, PT pour télécoms, I pour installations classées...).",
         "Les résultats peuvent inclure des assiettes ponctuelles, linéaires ou surfaciques et exposent un `feature_ref` WFS réutilisable quand il est disponible.",
+        "Pour récupérer exactement l'objet correspondant au `feature_ref`, utiliser `gpf_wfs_get_feature_by_id`.",
         `(source : ${URBANISME_SOURCE}).`
     ].join("\n");
     outputSchemaShape = assietteSupOutputSchema;
     schema = assietteSupInputSchema;
+    /**
+     * Looks up nearby SUP footprints relevant to the requested point.
+     *
+     * @param input Normalized tool input.
+     * @returns The list of nearby assiettes with optional reusable `feature_ref` metadata.
+     */
     async execute(input) {
+        logger.info(`[tool] execute ${this.name} ...`, {
+            input: input
+        });
         return {
             results: await getAssiettesServitudes(input.lon, input.lat),
         };

package/dist/tools/AssietteSupTool.js.map

@@ -1 +1 @@
-{"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,EAAE,qCAAqC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,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,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC,mHAAmH,CAAC,CAAC,QAAQ,EAAE;IACtK,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;CACrG,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;QACZ,uLAAuL;QACvL,yMAAyM;QACzM,0JAA0J;QAC1J,aAAa,gBAAgB,IAAI;KAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACH,iBAAiB,GAAG,uBAAuB,CAAC;IAEtD,MAAM,GAAG,sBAAsB,CAAC;IAEhC,KAAK,CAAC,OAAO,CAAC,KAAuB;QACnC,OAAO;YACL,OAAO,EAAE,MAAM,sBAAsB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC;SAC5D,CAAC;IACJ,CAAC;CACF;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"AssietteSupTool.js","sourceRoot":"","sources":["../../src/tools/AssietteSupTool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,qCAAqC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,MAAM,MAAM,cAAc,CAAC;AAElC,iBAAiB;AAEjB,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC,CAAC,MAAM,EAAE,CAAC;AAMZ,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,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC,mHAAmH,CAAC,CAAC,QAAQ,EAAE;IACtK,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;CACrG,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,eAAe;AAEf,MAAM,eAAgB,SAAQ,QAA0B;IACtD,IAAI,GAAG,cAAc,CAAC;IACtB,KAAK,GAAG,+BAA+B,CAAC;IACxC,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG;QACZ,uLAAuL;QACvL,yMAAyM;QACzM,0JAA0J;QAC1J,yGAAyG;QACzG,aAAa,gBAAgB,IAAI;KAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACH,iBAAiB,GAAG,uBAAuB,CAAC;IAEtD,MAAM,GAAG,sBAAsB,CAAC;IAEhC;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,KAAuB;QACnC,MAAM,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,MAAM,EAAE;YAC7C,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QAEH,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/BaseTool.d.ts

@@ -0,0 +1,17 @@
+import { MCPTool } from "mcp-framework";
+export default abstract class BaseTool<TInput extends Record<string, any> = any> extends MCPTool<TInput> {
+    toolCall(request: {
+        params: {
+            name: string;
+            arguments?: Record<string, unknown>;
+        };
+    }): Promise<import("mcp-framework").ToolResponse>;
+    protected createErrorResponse(error: unknown): {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        structuredContent: Record<string, unknown>;
+        isError: boolean;
+    };
+}

package/dist/tools/BaseTool.js

@@ -0,0 +1,41 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { MCPTool } from "mcp-framework";
+import { normalizeToolError } from "../helpers/errors/toolError.js";
+import logger from "../logger.js";
+const toolInputStorage = new AsyncLocalStorage();
+export default class BaseTool extends MCPTool {
+    async toolCall(request) {
+        return toolInputStorage.run(request.params.arguments || {}, () => super.toolCall(request));
+    }
+    createErrorResponse(error) {
+        const payload = normalizeToolError(error);
+        const metadata = {
+            tool: this.name,
+            problem_type: payload.type,
+            problem_title: payload.title,
+            error_codes: payload.errors.map((item) => item.code),
+        };
+        const toolInput = toolInputStorage.getStore();
+        if (toolInput !== undefined) {
+            metadata.input = toolInput;
+        }
+        if (payload.upstream?.status !== undefined) {
+            metadata.upstream_status = payload.upstream.status;
+        }
+        if (error instanceof Error && error.name && error.name !== "Error") {
+            metadata.error_name = error.name;
+        }
+        logger.error(`[tool] failed ${this.name}: ${payload.detail}`, metadata);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: payload.detail,
+                },
+            ],
+            structuredContent: payload,
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=BaseTool.js.map

package/dist/tools/BaseTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseTool.js","sourceRoot":"","sources":["../../src/tools/BaseTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,MAAM,MAAM,cAAc,CAAC;AAElC,MAAM,gBAAgB,GAAG,IAAI,iBAAiB,EAA2B,CAAC;AAE1E,MAAM,CAAC,OAAO,OAAgB,QAAmD,SAAQ,OAAe;IACtG,KAAK,CAAC,QAAQ,CAAC,OAKd;QACC,OAAO,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7F,CAAC;IAES,mBAAmB,CAAC,KAAc;QAC1C,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAA4B;YACxC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,OAAO,CAAC,IAAI;YAC1B,aAAa,EAAE,OAAO,CAAC,KAAK;YAC5B,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACrD,CAAC;QAEF,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAC;QAC9C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC;QAC7B,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;YAC3C,QAAQ,CAAC,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QACrD,CAAC;QAED,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACnE,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC;QACnC,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;QAExE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,OAAO,CAAC,MAAM;iBACrB;aACF;YACD,iBAAiB,EAAE,OAAkC;YACrD,OAAO,EAAE,IAAI;SACd,CAAC;IAEJ,CAAC;CACF"}

package/dist/tools/CadastreTool.d.ts

@@ -1,17 +1,20 @@
-import { MCPTool } from "mcp-framework";
+/**
+ * MCP tool exposing nearby cadastral objects for a given point.
+ */
+import BaseTool from "./BaseTool.js";
 import { z } from "zod";
 declare const cadastreInputSchema: z.ZodObject<{
     lon: z.ZodNumber;
     lat: z.ZodNumber;
 }, "strict", z.ZodTypeAny, {
-    lon?: number;
-    lat?: number;
+    lon: number;
+    lat: number;
 }, {
-    lon?: number;
-    lat?: number;
+    lon: number;
+    lat: number;
 }>;
 type CadastreInput = z.infer<typeof cadastreInputSchema>;
-declare class CadastreTool extends MCPTool<CadastreInput> {
+declare class CadastreTool extends BaseTool<CadastreInput> {
     name: string;
     title: string;
     annotations: {
@@ -30,11 +33,11 @@ declare class CadastreTool extends MCPTool<CadastreInput> {
                 typename: z.ZodString;
                 feature_id: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }>;
             distance: z.ZodNumber;
             source: z.ZodString;
@@ -46,11 +49,11 @@ declare class CadastreTool extends MCPTool<CadastreInput> {
                 typename: z.ZodString;
                 feature_id: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }>;
             distance: z.ZodNumber;
             source: z.ZodString;
@@ -62,17 +65,17 @@ declare class CadastreTool extends MCPTool<CadastreInput> {
                 typename: z.ZodString;
                 feature_id: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }>;
             distance: z.ZodNumber;
             source: z.ZodString;
         }, z.ZodUnknown, "strip">>, "many">;
     }, "strip", z.ZodTypeAny, {
-        results?: z.objectOutputType<{
+        results: z.objectOutputType<{
             type: z.ZodString;
             id: z.ZodString;
             bbox: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
@@ -80,17 +83,17 @@ declare class CadastreTool extends MCPTool<CadastreInput> {
                 typename: z.ZodString;
                 feature_id: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }>;
             distance: z.ZodNumber;
             source: z.ZodString;
         }, z.ZodUnknown, "strip">[];
     }, {
-        results?: z.objectInputType<{
+        results: z.objectInputType<{
             type: z.ZodString;
             id: z.ZodString;
             bbox: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
@@ -98,11 +101,11 @@ declare class CadastreTool extends MCPTool<CadastreInput> {
                 typename: z.ZodString;
                 feature_id: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }, {
-                typename?: string;
-                feature_id?: string;
+                typename: string;
+                feature_id: string;
             }>;
             distance: z.ZodNumber;
             source: z.ZodString;
@@ -112,14 +115,31 @@ declare class CadastreTool extends MCPTool<CadastreInput> {
         lon: z.ZodNumber;
         lat: z.ZodNumber;
     }, "strict", z.ZodTypeAny, {
-        lon?: number;
-        lat?: number;
+        lon: number;
+        lat: number;
     }, {
-        lon?: number;
-        lat?: number;
+        lon: number;
+        lat: number;
     }>;
+    /**
+     * Returns the nearest cadastral objects around the requested point.
+     *
+     * @param input Normalized tool input.
+     * @returns The nearest cadastral objects, at most one per cadastral type.
+     */
     execute(input: CadastreInput): Promise<{
-        results: array<object>;
+        results: (Record<string, unknown> & {
+            type: string;
+            id: string;
+            bbox?: number[];
+            feature_ref?: {
+                typename: string;
+                feature_id: string;
+            };
+        } & {
+            distance: number;
+            source: string;
+        })[];
     }>;
 }
 export default CadastreTool;

package/dist/tools/CadastreTool.js

@@ -1,8 +1,13 @@
-import { MCPTool } from "mcp-framework";
+/**
+ * MCP tool exposing nearby cadastral objects for a given point.
+ */
+import BaseTool from "./BaseTool.js";
 import { z } from "zod";
 import { getParcellaireExpress, PARCELLAIRE_EXPRESS_TYPES, PARCELLAIRE_EXPRESS_SOURCE } from "../gpf/parcellaire-express.js";
 import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "../helpers/toolAnnotations.js";
 import { featureRefSchema, lonSchema, latSchema } from "../helpers/schemas.js";
+import logger from "../logger.js";
+// --- Schema ---
 const cadastreInputSchema = z.object({
     lon: lonSchema,
     lat: latSchema,
@@ -20,7 +25,8 @@ const cadastreResultSchema = z
 const cadastreOutputSchema = z.object({
     results: z.array(cadastreResultSchema).describe("La liste des objets cadastraux les plus proches du point demandé."),
 });
-class CadastreTool extends MCPTool {
+// --- Tool ---
+class CadastreTool extends BaseTool {
     name = "cadastre";
     title = "Informations cadastrales";
     annotations = READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS;
@@ -29,11 +35,21 @@ class CadastreTool extends MCPTool {
         "Les résultats sont retournés au plus une fois par type lorsqu'ils sont disponibles et incluent un `feature_ref` WFS réutilisable.",
         "Le `feature_ref` est directement réutilisable dans `gpf_wfs_get_features` avec `spatial_operator=\"intersects_feature\"`.",
         "La distance de recherche est fixée à 10 mètres.  Si aucun objet n'est trouvé dans les 10 mètres, le résultat est vide.",
+        "Pour récupérer exactement l'objet correspondant au `feature_ref`, utiliser `gpf_wfs_get_feature_by_id`.",
         `(source : ${PARCELLAIRE_EXPRESS_SOURCE}).`
     ].join("\n");
     outputSchemaShape = cadastreOutputSchema;
     schema = cadastreInputSchema;
+    /**
+     * Returns the nearest cadastral objects around the requested point.
+     *
+     * @param input Normalized tool input.
+     * @returns The nearest cadastral objects, at most one per cadastral type.
+     */
     async execute(input) {
+        logger.info(`[tool] execute ${this.name} ...`, {
+            input: input
+        });
         return {
             results: await getParcellaireExpress(input.lon, input.lat),
         };

package/dist/tools/CadastreTool.js.map

@@ -1 +1 @@
-{"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,EAAE,qCAAqC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,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,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC,mHAAmH,CAAC;IAC3J,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2EAA2E,CAAC;IAC1G,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;AAGH,MAAM,YAAa,SAAQ,OAAsB;IAC/C,IAAI,GAAG,UAAU,CAAC;IAClB,KAAK,GAAG,0BAA0B,CAAC;IACnC,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG;QACZ,yGAAyG,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,wDAAwD;QACrM,mIAAmI;QACnI,2HAA2H;QAC3H,wHAAwH;QACxH,aAAa,0BAA0B,IAAI;KAC5C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACH,iBAAiB,GAAG,oBAAoB,CAAC;IAEnD,MAAM,GAAG,mBAAmB,CAAC;IAE7B,KAAK,CAAC,OAAO,CAAC,KAAoB;QAChC,OAAO;YACL,OAAO,EAAE,MAAM,qBAAqB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC;SAC3D,CAAC;IACJ,CAAC;CACF;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"CadastreTool.js","sourceRoot":"","sources":["../../src/tools/CadastreTool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC7H,OAAO,EAAE,qCAAqC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,MAAM,MAAM,cAAc,CAAC;AAElC,iBAAiB;AAEjB,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC,CAAC,MAAM,EAAE,CAAC;AAMZ,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,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC,mHAAmH,CAAC;IAC3J,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2EAA2E,CAAC;IAC1G,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,eAAe;AAEf,MAAM,YAAa,SAAQ,QAAuB;IAChD,IAAI,GAAG,UAAU,CAAC;IAClB,KAAK,GAAG,0BAA0B,CAAC;IACnC,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG;QACZ,yGAAyG,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,wDAAwD;QACrM,mIAAmI;QACnI,2HAA2H;QAC3H,wHAAwH;QACxH,yGAAyG;QACzG,aAAa,0BAA0B,IAAI;KAC5C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACH,iBAAiB,GAAG,oBAAoB,CAAC;IAEnD,MAAM,GAAG,mBAAmB,CAAC;IAE7B;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,KAAoB;QAChC,MAAM,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,MAAM,EAAE;YAC7C,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QAEH,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,20 @@
-import { MCPTool } from "mcp-framework";
+/**
+ * MCP tool exposing free-text geocoding and autocomplete.
+ */
+import BaseTool from "./BaseTool.js";
 import { z } from "zod";
 declare const geocodeInputSchema: z.ZodObject<{
     text: z.ZodString;
     maximumResponses: z.ZodOptional<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
-    text?: string;
-    maximumResponses?: number;
+    text: string;
+    maximumResponses?: number | undefined;
 }, {
-    text?: string;
-    maximumResponses?: number;
+    text: string;
+    maximumResponses?: number | undefined;
 }>;
 type GeocodeInput = z.infer<typeof geocodeInputSchema>;
-declare class GeocodeTool extends MCPTool<GeocodeInput> {
+declare class GeocodeTool extends BaseTool<GeocodeInput> {
     name: string;
     title: string;
     annotations: {
@@ -30,51 +33,64 @@ declare class GeocodeTool extends MCPTool<GeocodeInput> {
             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 | undefined;
+            city?: string | undefined;
+            zipcode?: string | undefined;
         }, {
-            lon?: number;
-            lat?: number;
-            fulltext?: string;
-            kind?: string;
-            city?: string;
-            zipcode?: string;
+            lon: number;
+            lat: number;
+            fulltext: string;
+            kind?: string | undefined;
+            city?: string | undefined;
+            zipcode?: string | undefined;
         }>, "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 | undefined;
+            city?: string | undefined;
+            zipcode?: string | undefined;
         }[];
     }, {
-        results?: {
-            lon?: number;
-            lat?: number;
-            fulltext?: string;
-            kind?: string;
-            city?: string;
-            zipcode?: string;
+        results: {
+            lon: number;
+            lat: number;
+            fulltext: string;
+            kind?: string | undefined;
+            city?: string | undefined;
+            zipcode?: string | undefined;
         }[];
     }>;
     schema: z.ZodObject<{
         text: z.ZodString;
         maximumResponses: z.ZodOptional<z.ZodNumber>;
     }, "strict", z.ZodTypeAny, {
-        text?: string;
-        maximumResponses?: number;
+        text: string;
+        maximumResponses?: number | undefined;
     }, {
-        text?: string;
-        maximumResponses?: number;
+        text: string;
+        maximumResponses?: number | undefined;
     }>;
+    /**
+     * Geocodes a free-text query and returns the ordered candidate list.
+     *
+     * @param input Normalized tool input.
+     * @returns The ordered list of geocoded candidates.
+     */
     execute(input: GeocodeInput): Promise<{
-        results: any;
+        results: {
+            lon: number;
+            lat: number;
+            fulltext: string;
+            kind: string;
+            city: string;
+            zipcode: string;
+        }[];
     }>;
 }
 export default GeocodeTool;

package/dist/tools/GeocodeTool.js

@@ -1,7 +1,12 @@
-import { MCPTool } from "mcp-framework";
+/**
+ * MCP tool exposing free-text geocoding and autocomplete.
+ */
+import BaseTool from "./BaseTool.js";
 import { z } from "zod";
 import { geocode, GEOCODE_SOURCE } from "../gpf/geocode.js";
 import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "../helpers/toolAnnotations.js";
+import logger from "../logger.js";
+// --- Schema ---
 const geocodeInputSchema = z.object({
     text: z
         .string()
@@ -27,7 +32,8 @@ const geocodeResultSchema = z.object({
 const geocodeOutputSchema = z.object({
     results: z.array(geocodeResultSchema).describe("La liste ordonnée des résultats géocodés."),
 });
-class GeocodeTool extends MCPTool {
+// --- Tool ---
+class GeocodeTool extends BaseTool {
     name = "geocode";
     title = "Géocodage de lieux et d’adresses";
     annotations = READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS;
@@ -38,7 +44,16 @@ class GeocodeTool extends MCPTool {
     ].join("\n");
     outputSchemaShape = geocodeOutputSchema;
     schema = geocodeInputSchema;
+    /**
+     * Geocodes a free-text query and returns the ordered candidate list.
+     *
+     * @param input Normalized tool input.
+     * @returns The ordered list of geocoded candidates.
+     */
     async execute(input) {
+        logger.info(`[tool] execute ${this.name} ...`, {
+            input: input
+        });
         return {
             results: await geocode(input.text, input.maximumResponses),
         };