@ignfab/geocontext 0.9.5 → 0.9.7

package/dist/tools/GpfWfsSearchTypesTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"GpfWfsSearchTypesTool.js","sourceRoot":"","sources":["../../src/tools/GpfWfsSearchTypesTool.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,+BAA+B,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,EAAE,+CAA+C,CAAC;SACvD,QAAQ,CAAC,yBAAyB,CAAC;IACtC,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,0EAA0E,CAAC;CACxF,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC7D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC3D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC/D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC,CAAC,QAAQ,EAAE;CACjF,CAAC,CAAC;AAEH,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CACpG,CAAC,CAAC;AAEH,MAAM,qBAAsB,SAAQ,OAA+B;IACjE,IAAI,GAAG,sBAAsB,CAAC;IAC9B,KAAK,GAAG,wBAAwB,CAAC;IACjC,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG;QACZ,qIAAqI;QACrI,8KAA8K;QAC9K,+FAA+F;QAC/F,wIAAwI;QACxI,8EAA8E;KAC/E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACH,iBAAiB,GAAG,6BAA6B,CAAC;IAE5D,MAAM,GAAG,4BAA4B,CAAC;IAEtC,KAAK,CAAC,OAAO,CAAC,KAA6B;QACzC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;QAC3C,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,4BAA4B,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC3F,OAAO;YACL,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;gBACpD,EAAE,EAAE,UAAU,CAAC,EAAE;gBACjB,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,WAAW,EAAE,UAAU,CAAC,WAAW;gBACnC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1C,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;CACF;AAED,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"GpfWfsSearchTypesTool.js","sourceRoot":"","sources":["../../src/tools/GpfWfsSearchTypesTool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qCAAqC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,MAAM,MAAM,cAAc,CAAC;AAElC,iBAAiB;AAEjB,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,EAAE,+CAA+C,CAAC;SACvD,QAAQ,CAAC,yBAAyB,CAAC;IACtC,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,0EAA0E,CAAC;CACxF,CAAC,CAAC,MAAM,EAAE,CAAC;AAMZ,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC7D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC3D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC/D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC,CAAC,QAAQ,EAAE;CACjF,CAAC,CAAC;AAEH,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CACpG,CAAC,CAAC;AAEH,eAAe;AAEf,MAAM,qBAAsB,SAAQ,QAAgC;IAClE,IAAI,GAAG,sBAAsB,CAAC;IAC9B,KAAK,GAAG,wBAAwB,CAAC;IACjC,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG;QACZ,qIAAqI;QACrI,8KAA8K;QAC9K,+FAA+F;QAC/F,wIAAwI;QACxI,8EAA8E;KAC/E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACH,iBAAiB,GAAG,6BAA6B,CAAC;IAE5D,MAAM,GAAG,4BAA4B,CAAC;IAEtC;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,KAA6B;QACzC,MAAM,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,MAAM,EAAE;YAC7C,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;QAC3C,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,4BAA4B,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC3F,OAAO;YACL,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;gBACpD,EAAE,EAAE,UAAU,CAAC,EAAE;gBACjB,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,WAAW,EAAE,UAAU,CAAC,WAAW;gBACnC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1C,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;CACF;AAED,eAAe,qBAAqB,CAAC"}

package/dist/tools/UrbanismeTool.d.ts

@@ -1,17 +1,20 @@
-import { MCPTool } from "mcp-framework";
+/**
+ * MCP tool exposing urban planning information around a given point.
+ */
+import BaseTool from "./BaseTool.js";
 import { z } from "zod";
 declare const urbanismeInputSchema: 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 UrbanismeInput = z.infer<typeof urbanismeInputSchema>;
-declare class UrbanismeTool extends MCPTool<UrbanismeInput> {
+declare class UrbanismeTool extends BaseTool<UrbanismeInput> {
     name: string;
     title: string;
     annotations: {
@@ -30,11 +33,11 @@ declare class UrbanismeTool extends MCPTool<UrbanismeInput> {
                 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 UrbanismeTool extends MCPTool<UrbanismeInput> {
                 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 UrbanismeTool extends MCPTool<UrbanismeInput> {
                 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 UrbanismeTool extends MCPTool<UrbanismeInput> {
                 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 UrbanismeTool extends MCPTool<UrbanismeInput> {
                 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,14 +110,20 @@ declare class UrbanismeTool extends MCPTool<UrbanismeInput> {
         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 urban planning objects relevant to the requested point.
+     *
+     * @param input Normalized tool input.
+     * @returns The relevant urban planning objects, including reusable `feature_ref` metadata when available.
+     */
     execute(input: UrbanismeInput): Promise<{
-        results: {}[];
+        results: Record<string, unknown>[];
     }>;
 }
 export default UrbanismeTool;

package/dist/tools/UrbanismeTool.js

@@ -1,8 +1,13 @@
-import { MCPTool } from "mcp-framework";
+/**
+ * MCP tool exposing urban planning information around a given point.
+ */
+import BaseTool from "./BaseTool.js";
 import { z } from "zod";
 import { getUrbanisme, 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 urbanismeInputSchema = z.object({
     lon: lonSchema,
     lat: latSchema,
@@ -24,19 +29,30 @@ const URBANISME_TOOL_DESCRIPTION = [
     "Les résultats peuvent notamment inclure le document d'urbanisme applicable ainsi que des éléments réglementaires associés à proximité du point.",
     "Quand un objet correspond à une couche WFS réutilisable, il expose aussi un `feature_ref` compatible avec `gpf_wfs_get_features` et `spatial_operator=\"intersects_feature\"`.",
     "Le zonage PLU (zone U, AU, A, N...) est inclus dans les zones retournées et constitue souvent l'information principale recherchée.",
+    "Pour récupérer exactement l'objet correspondant au `feature_ref`, utiliser `gpf_wfs_get_feature_by_id`.",
     "Modèles d'URL Géoportail de l'Urbanisme :",
     "- fiche document: https://www.geoportail-urbanisme.gouv.fr/document/by-id/{gpu_doc_id}",
     "- carte: https://www.geoportail-urbanisme.gouv.fr/map/?documentId={gpu_doc_id}",
     "- fichier: https://www.geoportail-urbanisme.gouv.fr/api/document/{gpu_doc_id}/files/{nomfic}",
 ].join("\n");
-class UrbanismeTool extends MCPTool {
+// --- Tool ---
+class UrbanismeTool extends BaseTool {
     name = "urbanisme";
     title = "Informations d’urbanisme";
     annotations = READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS;
     description = URBANISME_TOOL_DESCRIPTION;
     outputSchemaShape = urbanismeOutputSchema;
     schema = urbanismeInputSchema;
+    /**
+     * Returns the urban planning objects relevant to the requested point.
+     *
+     * @param input Normalized tool input.
+     * @returns The relevant urban planning objects, including reusable `feature_ref` metadata when available.
+     */
     async execute(input) {
+        logger.info(`[tool] execute ${this.name} ...`, {
+            input: input
+        });
         return {
             results: await getUrbanisme(input.lon, input.lat),
         };

package/dist/tools/UrbanismeTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"UrbanismeTool.js","sourceRoot":"","sources":["../../src/tools/UrbanismeTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,qCAAqC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,qBAAqB,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACjE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAChE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC,CAAC,QAAQ,EAAE;IAC5F,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC,mHAAmH,CAAC,CAAC,QAAQ,EAAE;IACtK,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6EAA6E,CAAC;CAC7G,CAAC;KACD,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAEzB,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,CAAC,mEAAmE,CAAC;CACtH,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG;IACjC,kPAAkP,gBAAgB,IAAI;IACtQ,iJAAiJ;IACjJ,gLAAgL;IAChL,oIAAoI;IACpI,2CAA2C;IAC3C,wFAAwF;IACxF,gFAAgF;IAChF,8FAA8F;CAC/F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAGb,MAAM,aAAc,SAAQ,OAAuB;IACjD,IAAI,GAAG,WAAW,CAAC;IACnB,KAAK,GAAG,0BAA0B,CAAC;IACnC,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG,0BAA0B,CAAC;IAC/B,iBAAiB,GAAG,qBAAqB,CAAC;IAEpD,MAAM,GAAG,oBAAoB,CAAC;IAE9B,KAAK,CAAC,OAAO,CAAC,KAAqB;QACjC,OAAO;YACL,OAAO,EAAE,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC;SAClD,CAAC;IACJ,CAAC;CACF;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"UrbanismeTool.js","sourceRoot":"","sources":["../../src/tools/UrbanismeTool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACrE,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,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC,CAAC,MAAM,EAAE,CAAC;AAMZ,MAAM,qBAAqB,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACjE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAChE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC,CAAC,QAAQ,EAAE;IAC5F,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC,mHAAmH,CAAC,CAAC,QAAQ,EAAE;IACtK,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6EAA6E,CAAC;CAC7G,CAAC;KACD,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAEzB,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,CAAC,mEAAmE,CAAC;CACtH,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG;IACjC,kPAAkP,gBAAgB,IAAI;IACtQ,iJAAiJ;IACjJ,gLAAgL;IAChL,oIAAoI;IACpI,yGAAyG;IACzG,2CAA2C;IAC3C,wFAAwF;IACxF,gFAAgF;IAChF,8FAA8F;CAC/F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,eAAe;AAEf,MAAM,aAAc,SAAQ,QAAwB;IAClD,IAAI,GAAG,WAAW,CAAC;IACnB,KAAK,GAAG,0BAA0B,CAAC;IACnC,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG,0BAA0B,CAAC;IAC/B,iBAAiB,GAAG,qBAAqB,CAAC;IAEpD,MAAM,GAAG,oBAAoB,CAAC;IAE9B;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,KAAqB;QACjC,MAAM,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,MAAM,EAAE;YAC7C,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC;SAClD,CAAC;IACJ,CAAC;CACF;AAED,eAAe,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ignfab/geocontext",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "description": "An experimental MCP server providing access to the services and data of the french Geoplateform",
   "type": "module",
   "bin": {
@@ -28,42 +28,69 @@
   "homepage": "https://github.com/ignfab/geocontext#readme",
   "scripts": {
     "clean:dist": "node scripts/dist-clean.js",
-    "build": "npm run clean:dist && tsc && npx mcp-build",
+    "clean:coverage": "rm -rf coverage",
+    "clean:deps": "rm -rf node_modules",
+    "clean": "npm run clean:dist && npm run clean:coverage",
+    "reset:local": "npm run clean && npm run clean:deps",
+    "build": "npm run clean:dist && mcp-build",
+    "docs:mcp": "npm run build && node --no-warnings scripts/generate-mcp-docs.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck:test": "tsc -p tsconfig.test.json --noEmit",
     "watch": "tsc --watch",
-    "start": "node dist/index.js",
-    "test": "node --no-warnings --experimental-vm-modules ./node_modules/jest/bin/jest.js",
-    "coverage": "node --no-warnings --experimental-vm-modules ./node_modules/jest/bin/jest.js --coverage",
-    "reset": "rm -rf node_modules package-lock.json dist build .next .turbo coverage",
-    "fresh": "npm run reset && npm cache verify && npm install && npm run build && npm test"
+    "start": "node --use-env-proxy dist/index.js",
+    "test": "npm run test:unit",
+    "test:unit": "vitest run",
+    "test:integration": "vitest run --config vitest.integration.config.mts",
+    "test:e2e": "vitest run --config vitest.e2e.config.mts",
+    "test:coverage": "vitest run --coverage",
+    "verify:fast": "npm run typecheck && npm run typecheck:test && npm run build && npm run test:unit",
+    "verify": "npm run verify:fast && npm run test:integration",
+    "verify:full": "npm run verify && npm run test:e2e",
+    "fresh": "npm run reset:local && npm ci && npm run verify",
+    "deps:outdated": "npm outdated",
+    "deps:audit": "npm audit",
+    "inspect:mcp": "mcp-inspector -- node --use-env-proxy dist/index.js",
+    "inspect:mcp:cli": "mcp-inspector --cli node --use-env-proxy dist/index.js"
   },
   "dependencies": {
     "@ignfab/gpf-schema-store": "^0.1.5",
     "@rgrove/parse-xml": "^4.2.0",
-    "@turf/distance": "^7.3.4",
-    "@turf/helpers": "^7.3.4",
-    "https-proxy-agent": "^7.0.6",
+    "@turf/distance": "^7.3.5",
+    "@turf/helpers": "^7.3.5",
     "jsts": "^2.12.1",
-    "lodash": "^4.17.21",
     "mcp-framework": "^0.2.22",
     "node-fetch": "^3.3.2",
-    "winston": "^3.18.3",
+    "winston": "^3.19.0",
     "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@types/cors": "^2.8.19",
+    "@langchain/anthropic": "^1.3.28",
+    "@langchain/core": "^1.1.44",
+    "@langchain/langgraph": "^1.3.0",
+    "@langchain/mcp-adapters": "^1.1.3",
+    "@langchain/ollama": "^1.2.7",
+    "@modelcontextprotocol/inspector": "^0.21.2",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@types/geojson": "^7946.0.16",
-    "@types/jest": "^30.0.0",
-    "@types/lodash": "^4.17.21",
-    "@types/node": "^24.10.1",
-    "@types/supertest": "^6.0.3",
-    "geojson": "^0.5.0",
-    "jest": "^30.2.0",
-    "supertest": "^7.1.4",
-    "ts-jest": "^29.4.5",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
+    "@types/node": "^25.6.0",
+    "@vitest/coverage-v8": "^4.1.5",
+    "langchain": "^1.3.5",
+    "supertest": "^7.2.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
   },
   "engines": {
-    "node": ">=18.19.0"
+    "node": ">=22.21.0 <23 || >=24.5.0"
+  },
+  "devEngines": {
+    "runtime": {
+      "name": "node",
+      "version": ">=22.21.0 <23 || >=24.5.0",
+      "onFail": "error"
+    },
+    "packageManager": {
+      "name": "npm",
+      "onFail": "error"
+    }
   }
 }

package/dist/gpf/wfs.js.map

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

package/dist/helpers/wfs.d.ts

@@ -1,27 +0,0 @@
-/**
- * Fetch features from a GPF WFS endpoint.
- *
- * @param {string[]} typeNames - fully qualified WFS type names
- * @param {string} cqlFilter - CQL_FILTER value
- * @param {string} errorLabel - service label used in the error message
- * @param {(url: string) => Promise<any>} [fetcher]
- * @returns {Promise<any[]>} raw GeoJSON features array
- */
-export function fetchWfsFeatures(typeNames: string[], cqlFilter: string, errorLabel: string, fetcher?: (url: string) => Promise<any>): Promise<any[]>;
-/**
- * Builds a GeoJSON Point from longitude and latitude.
- *
- * @param {number} lon
- * @param {number} lat
- * @returns {object} GeoJSON Point
- */
-export function toGeoJsonPoint(lon: number, lat: number): object;
-/**
- * Maps a raw WFS feature into a flat result object, stripping geometry
- * and resolving a reusable feature_ref from the known type names.
- *
- * @param {object}  feature        - Raw GeoJSON feature from WFS
- * @param {string[]} knownTypeNames - Fully qualified WFS type names used for feature_ref resolution
- * @returns {object} Flat result with type, id, bbox, optional feature_ref, and spread properties
- */
-export function mapWfsFeature(feature: object, knownTypeNames: string[]): object;

package/dist/helpers/wfs.js

@@ -1,55 +0,0 @@
-import { fetchJSON } from './http.js';
-const GPF_WFS_BASE_URL = process.env.GPF_WFS_BASE_URL || 'https://data.geopf.fr/wfs';
-/**
- * Fetch features from a GPF WFS endpoint.
- *
- * @param {string[]} typeNames - fully qualified WFS type names
- * @param {string} cqlFilter - CQL_FILTER value
- * @param {string} errorLabel - service label used in the error message
- * @param {(url: string) => Promise<any>} [fetcher]
- * @returns {Promise<any[]>} raw GeoJSON features array
- */
-export async function fetchWfsFeatures(typeNames, cqlFilter, errorLabel, fetcher = fetchJSON) {
-    const url = GPF_WFS_BASE_URL + '?' + new URLSearchParams({
-        service: 'WFS',
-        request: 'GetFeature',
-        typeName: typeNames.join(','),
-        outputFormat: 'application/json',
-        cql_filter: cqlFilter,
-    }).toString();
-    const featureCollection = await fetcher(url);
-    if (!Array.isArray(featureCollection?.features)) {
-        throw new Error(`Le service ${errorLabel} n'a pas retourné de collection d'objets exploitable`);
-    }
-    return featureCollection.features;
-}
-/**
- * Builds a GeoJSON Point from longitude and latitude.
- *
- * @param {number} lon
- * @param {number} lat
- * @returns {object} GeoJSON Point
- */
-export function toGeoJsonPoint(lon, lat) {
-    return { type: "Point", coordinates: [lon, lat] };
-}
-/**
- * Maps a raw WFS feature into a flat result object, stripping geometry
- * and resolving a reusable feature_ref from the known type names.
- *
- * @param {object}  feature        - Raw GeoJSON feature from WFS
- * @param {string[]} knownTypeNames - Fully qualified WFS type names used for feature_ref resolution
- * @returns {object} Flat result with type, id, bbox, optional feature_ref, and spread properties
- */
-export function mapWfsFeature(feature, knownTypeNames) {
-    const type = feature.id.split('.')[0];
-    const typename = knownTypeNames.find((t) => t.endsWith(`:${type}`));
-    return {
-        ...feature.properties,
-        type,
-        id: feature.id,
-        bbox: feature.bbox,
-        ...(typename ? { feature_ref: { typename, feature_id: feature.id } } : {}),
-    };
-}
-//# sourceMappingURL=wfs.js.map

package/dist/helpers/wfs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wfs.js","sourceRoot":"","sources":["../../src/helpers/wfs.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,2BAA2B,CAAC;AAErF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,SAAS;IACxF,MAAM,GAAG,GAAG,gBAAgB,GAAG,GAAG,GAAG,IAAI,eAAe,CAAC;QACrD,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,YAAY;QACrB,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;QAC7B,YAAY,EAAE,kBAAkB;QAChC,UAAU,EAAE,SAAS;KACxB,CAAC,CAAC,QAAQ,EAAE,CAAC;IAEd,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,cAAc,UAAU,sDAAsD,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,iBAAiB,CAAC,QAAQ,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,GAAG,EAAE,GAAG;IACnC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;AACtD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,OAAO,EAAE,cAAc;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;IACpE,OAAO;QACH,GAAG,OAAO,CAAC,UAAU;QACrB,IAAI;QACJ,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7E,CAAC;AACN,CAAC"}

package/dist/helpers/wfs_internal/compile.d.ts

@@ -1,46 +0,0 @@
-import type { Collection, CollectionProperty } from "@ignfab/gpf-schema-store";
-import type { GpfWfsGetFeaturesInput, SpatialFilter } from "./schema.js";
-export type ResolvedFeatureGeometryRef = {
-    typename: string;
-    feature_id: string;
-    geometry_ewkt: string;
-};
-export type CompiledQuery = {
-    geometryProperty: CollectionProperty;
-    cqlFilter?: string;
-    propertyName?: string;
-    sortBy?: string;
-};
-/**
- * Resolves the single geometry property expected by the query compiler.
- *
- * @param featureType Feature type definition loaded from the embedded catalog.
- * @returns The unique geometry property for the feature type.
- */
-export declare function getGeometryProperty(featureType: Collection): CollectionProperty;
-/**
- * Serializes a GeoJSON-like geometry object into EWKT for CQL spatial predicates.
- *
- * @param geometry Geometry object exposing a GeoJSON `type` and `coordinates`.
- * @returns The EWKT representation of the geometry.
- */
-export declare function geometryToEwkt(geometry: {
-    type: string;
-    coordinates: unknown;
-}): string;
-/**
- * Normalizes the raw spatial input into a discriminated spatial filter object.
- *
- * @param input Normalized tool input.
- * @returns A normalized spatial filter, or `undefined` when no spatial filter is requested.
- */
-export declare function getSpatialFilter(input: GpfWfsGetFeaturesInput): SpatialFilter | undefined;
-/**
- * Compiles normalized tool input into query fragments ready to be turned into a WFS request.
- *
- * @param input Normalized tool input.
- * @param featureType Feature type definition loaded from the embedded catalog.
- * @param resolvedGeometryRef Optional resolved reference geometry for `intersects_feature`.
- * @returns Compiled query parts used by request builders.
- */
-export declare function compileQueryParts(input: GpfWfsGetFeaturesInput, featureType: Collection, resolvedGeometryRef?: ResolvedFeatureGeometryRef): CompiledQuery;