@ignfab/geocontext 0.9.5 → 0.9.7

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;AAExB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,qCAAqC,EAAE,MAAM,+BAA+B,CAAC;AAEtF,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,MAAM,EAAE,CAAC;AAIZ,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;QACZ,gMAAgM;QAChM,8LAA8L;QAC9L,aAAa,cAAc,IAAI;KAChC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACH,iBAAiB,GAAG,mBAAmB,CAAC;IAElD,MAAM,GAAG,kBAAkB,CAAC;IAE5B,KAAK,CAAC,OAAO,CAAC,KAAmB;QAC/B,OAAO;YACL,OAAO,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,gBAAgB,CAAC;SAC3D,CAAC;IACJ,CAAC;CACF;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"GeocodeTool.js","sourceRoot":"","sources":["../../src/tools/GeocodeTool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,qCAAqC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,MAAM,MAAM,cAAc,CAAC;AAElC,iBAAiB;AAEjB,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,MAAM,EAAE,CAAC;AAMZ,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,eAAe;AAEf,MAAM,WAAY,SAAQ,QAAsB;IAC9C,IAAI,GAAG,SAAS,CAAC;IACjB,KAAK,GAAG,kCAAkC,CAAC;IAC3C,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG;QACZ,gMAAgM;QAChM,8LAA8L;QAC9L,aAAa,cAAc,IAAI;KAChC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACH,iBAAiB,GAAG,mBAAmB,CAAC;IAElD,MAAM,GAAG,kBAAkB,CAAC;IAE5B;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,KAAmB;QAC/B,MAAM,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,MAAM,EAAE;YAC7C,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QAEH,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,15 +1,17 @@
-import { MCPTool } from "mcp-framework";
+/**
+ * MCP tool exposing detailed schema inspection for a single WFS type.
+ */
+import BaseTool from "./BaseTool.js";
 import { z } from "zod";
-import type { Collection } from "@ignfab/gpf-schema-store";
 declare const gpfWfsDescribeTypeInputSchema: z.ZodObject<{
     typename: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    typename?: string;
+    typename: string;
 }, {
-    typename?: string;
+    typename: string;
 }>;
 type GpfWfsDescribeTypeInput = z.infer<typeof gpfWfsDescribeTypeInputSchema>;
-declare class GpfWfsDescribeTypeTool extends MCPTool<GpfWfsDescribeTypeInput> {
+declare class GpfWfsDescribeTypeTool extends BaseTool<GpfWfsDescribeTypeInput> {
     name: string;
     title: string;
     annotations: {
@@ -20,105 +22,75 @@ declare class GpfWfsDescribeTypeTool extends MCPTool<GpfWfsDescribeTypeInput> {
     };
     description: string;
     protected outputSchemaShape: z.ZodObject<{
-        result: z.ZodObject<{
-            id: z.ZodString;
-            namespace: z.ZodString;
+        id: z.ZodString;
+        namespace: z.ZodString;
+        name: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        properties: z.ZodArray<z.ZodObject<{
             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">;
+            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, {
-            id?: string;
-            properties?: {
-                type?: string;
-                name?: string;
-                title?: string;
-                description?: string;
-                enum?: string[];
-                defaultCrs?: string;
-            }[];
-            namespace?: string;
-            name?: string;
-            title?: string;
-            description?: string;
+            name: string;
+            type: string;
+            title?: string | undefined;
+            description?: string | undefined;
+            enum?: string[] | undefined;
+            defaultCrs?: string | undefined;
         }, {
-            id?: string;
-            properties?: {
-                type?: string;
-                name?: string;
-                title?: string;
-                description?: string;
-                enum?: string[];
-                defaultCrs?: string;
-            }[];
-            namespace?: string;
-            name?: string;
-            title?: string;
-            description?: string;
-        }>;
+            name: string;
+            type: string;
+            title?: string | undefined;
+            description?: string | undefined;
+            enum?: string[] | undefined;
+            defaultCrs?: string | undefined;
+        }>, "many">;
     }, "strip", z.ZodTypeAny, {
-        result?: {
-            id?: string;
-            properties?: {
-                type?: string;
-                name?: string;
-                title?: string;
-                description?: string;
-                enum?: string[];
-                defaultCrs?: string;
-            }[];
-            namespace?: string;
-            name?: string;
-            title?: string;
-            description?: string;
-        };
+        name: string;
+        namespace: string;
+        title: string;
+        description: string;
+        properties: {
+            name: string;
+            type: string;
+            title?: string | undefined;
+            description?: string | undefined;
+            enum?: string[] | undefined;
+            defaultCrs?: string | undefined;
+        }[];
+        id: string;
     }, {
-        result?: {
-            id?: string;
-            properties?: {
-                type?: string;
-                name?: string;
-                title?: string;
-                description?: string;
-                enum?: string[];
-                defaultCrs?: string;
-            }[];
-            namespace?: string;
-            name?: string;
-            title?: string;
-            description?: string;
-        };
+        name: string;
+        namespace: string;
+        title: string;
+        description: string;
+        properties: {
+            name: string;
+            type: string;
+            title?: string | undefined;
+            description?: string | undefined;
+            enum?: string[] | undefined;
+            defaultCrs?: string | undefined;
+        }[];
+        id: string;
     }>;
     schema: z.ZodObject<{
         typename: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        typename?: string;
+        typename: string;
     }, {
-        typename?: string;
-    }>;
-    execute(input: GpfWfsDescribeTypeInput): Promise<{
-        result: Collection;
+        typename: string;
     }>;
+    /**
+     * Loads the detailed schema description for one WFS typename.
+     *
+     * @param input Normalized tool input.
+     * @returns The detailed feature type description from the embedded catalog.
+     */
+    execute(input: GpfWfsDescribeTypeInput): Promise<Collection>;
 }
 export default GpfWfsDescribeTypeTool;

package/dist/tools/GpfWfsDescribeTypeTool.js

@@ -1,7 +1,12 @@
-import { MCPTool } from "mcp-framework";
+/**
+ * MCP tool exposing detailed schema inspection for a single WFS type.
+ */
+import BaseTool from "./BaseTool.js";
 import { z } from "zod";
-import { wfsClient } from "../gpf/wfs.js";
+import { wfsClient } from "../gpf/wfs-schema-catalog.js";
 import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "../helpers/toolAnnotations.js";
+import logger from "../logger.js";
+// --- Schema ---
 const gpfWfsDescribeTypeInputSchema = z.object({
     typename: z
         .string()
@@ -18,16 +23,15 @@ const gpfWfsPropertySchema = z.object({
     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."),
+    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."),
 });
-class GpfWfsDescribeTypeTool extends MCPTool {
+// --- Tool ---
+class GpfWfsDescribeTypeTool extends BaseTool {
     name = "gpf_wfs_describe_type";
     title = "Description d’un type WFS";
     annotations = READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS;
@@ -35,16 +39,23 @@ class GpfWfsDescribeTypeTool extends MCPTool {
         "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, leurs valeurs possibles (`enum`) lorsqu'elles existent",
-        "**Appel fortement recommandé si les noms exacts des propriétés ne sont pas connus : un nom de propriété incorrect provoque une erreur**."
+        "**IMPORTANT: Appel fortement recommandé si les noms exacts des propriétés ne sont pas connus : un nom de propriété incorrect provoque une erreur**."
     ].join("\n");
     outputSchemaShape = gpfWfsDescribeTypeOutputSchema;
     schema = gpfWfsDescribeTypeInputSchema;
+    /**
+     * Loads the detailed schema description for one WFS typename.
+     *
+     * @param input Normalized tool input.
+     * @returns The detailed feature type description from the embedded catalog.
+     */
     async execute(input) {
+        logger.info(`[tool] execute ${this.name} ...`, {
+            input: input
+        });
         try {
             const featureType = await wfsClient.getFeatureType(input.typename);
-            return {
-                result: featureType,
-            };
+            return featureType;
         }
         catch (e) {
             const message = e instanceof Error ? e.message : String(e);

package/dist/tools/GpfWfsDescribeTypeTool.js.map

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

package/dist/tools/GpfWfsGetFeatureByIdTool.d.ts

@@ -0,0 +1,89 @@
+/**
+ * MCP tool exposing exact WFS feature lookup by `feature_id`.
+ *
+ * The tool keeps MCP-facing concerns such as schema exposure, compact response
+ * formatting, and request-preview output. The `results` execution flow itself
+ * is delegated to the structured WFS engine.
+ */
+import BaseTool from "./BaseTool.js";
+import { type GpfWfsGetFeatureByIdInput } from "../helpers/wfs_engine/schema.js";
+declare class GpfWfsGetFeatureByIdTool extends BaseTool<GpfWfsGetFeatureByIdInput> {
+    name: string;
+    title: string;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    description: string;
+    schema: import("zod").ZodObject<{
+        typename: import("zod").ZodString;
+        feature_id: import("zod").ZodString;
+        result_type: import("zod").ZodDefault<import("zod").ZodEnum<["results", "request"]>>;
+        select: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+    }, "strict", import("zod").ZodTypeAny, {
+        typename: string;
+        feature_id: string;
+        result_type: "request" | "results";
+        select?: string[] | undefined;
+    }, {
+        typename: string;
+        feature_id: string;
+        result_type?: "request" | "results" | undefined;
+        select?: string[] | undefined;
+    }>;
+    /**
+     * Exposes an input schema variant that stays compatible with most MCP integrations.
+     *
+     * @returns The published input schema exposed through the MCP tool definition.
+     */
+    get inputSchema(): import("../helpers/jsonSchema.js").PublishedInputSchema;
+    /**
+     * Formats compact responses (`request`, `results`) into `structuredContent`.
+     *
+     * We intentionally do not expose a single `outputSchemaShape` for the tool as
+     * a whole: the `results` path returns a generic FeatureCollection whose
+     * feature properties depend on the queried WFS layer, while `request` has a
+     * compact, closed shape that is worth validating explicitly.
+     *
+     * @param data Raw execution result returned by the tool implementation.
+     * @returns An MCP success response, optionally enriched with structured content.
+     */
+    protected createSuccessResponse(data: unknown): {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        structuredContent: {
+            url: string;
+            result_type: "request";
+            method: "POST";
+            query: Record<string, string>;
+            body: string;
+            get_url?: string | null | undefined;
+        };
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        structuredContent: Record<string, unknown>;
+    };
+    /**
+     * Orchestrates the by-id execution flow:
+     * schema lookup -> request compilation -> optional request output -> WFS execution -> cardinality validation.
+     *
+     * @param input Normalized tool input.
+     * @returns Either a compiled request or a transformed FeatureCollection containing one feature.
+     */
+    execute(input: GpfWfsGetFeatureByIdInput): Promise<import("../helpers/wfs_engine/request.js").WfsRequestPayload | (Record<string, unknown> & {
+        features?: (Record<string, unknown> & {
+            feature_ref?: {
+                typename: string | null;
+                feature_id: string;
+            };
+        })[];
+    })>;
+}
+export default GpfWfsGetFeatureByIdTool;

package/dist/tools/GpfWfsGetFeatureByIdTool.js

@@ -0,0 +1,99 @@
+/**
+ * MCP tool exposing exact WFS feature lookup by `feature_id`.
+ *
+ * The tool keeps MCP-facing concerns such as schema exposure, compact response
+ * formatting, and request-preview output. The `results` execution flow itself
+ * is delegated to the structured WFS engine.
+ */
+import BaseTool from "./BaseTool.js";
+import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "../helpers/toolAnnotations.js";
+import { buildPropertyName, executeGetFeatureById } from "../helpers/wfs_engine/byId.js";
+import { getFeatureType } from "../helpers/wfs_engine/execution.js";
+import { buildGetFeatureByIdRequest, toWfsRequestPayload, } from "../helpers/wfs_engine/request.js";
+import { gpfWfsGetFeatureByIdInputSchema, gpfWfsGetFeatureByIdPublishedInputSchema, gpfWfsGetFeatureByIdRequestOutputSchema, } from "../helpers/wfs_engine/schema.js";
+import logger from "../logger.js";
+// --- Tool ---
+class GpfWfsGetFeatureByIdTool extends BaseTool {
+    name = "gpf_wfs_get_feature_by_id";
+    title = "Lecture d’un objet WFS par identifiant";
+    annotations = READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS;
+    description = [
+        "Récupère exactement un objet WFS à partir de `typename` et `feature_id`, sans filtre attributaire ni spatial.",
+        "Ce tool est le chemin robuste quand vous disposez déjà d'une `feature_ref { typename, feature_id }` issue d'un autre tool (`adminexpress`, `cadastre`, `urbanisme`, `assiette_sup`, `gpf_wfs_get_features`).",
+        "Le contrat garantit une cardinalité stricte : 0 résultat ou plusieurs résultats provoquent une erreur explicite.",
+        "Utiliser `result_type=\"request\"` pour récupérer la requête WFS compilée (avec `get_url`) et l'utiliser ou la visualiser ailleurs."
+    ].join("\n");
+    // `schema` remains the runtime validation source, while `inputSchema`
+    // publishes the MCP-facing variant expected by clients.
+    schema = gpfWfsGetFeatureByIdInputSchema;
+    /**
+     * Exposes an input schema variant that stays compatible with most MCP integrations.
+     *
+     * @returns The published input schema exposed through the MCP tool definition.
+     */
+    get inputSchema() {
+        return gpfWfsGetFeatureByIdPublishedInputSchema;
+    }
+    /**
+     * Formats compact responses (`request`, `results`) into `structuredContent`.
+     *
+     * We intentionally do not expose a single `outputSchemaShape` for the tool as
+     * a whole: the `results` path returns a generic FeatureCollection whose
+     * feature properties depend on the queried WFS layer, while `request` has a
+     * compact, closed shape that is worth validating explicitly.
+     *
+     * @param data Raw execution result returned by the tool implementation.
+     * @returns An MCP success response, optionally enriched with structured content.
+     */
+    createSuccessResponse(data) {
+        if (typeof data === "object" &&
+            data !== null &&
+            "result_type" in data &&
+            data.result_type === "request") {
+            return {
+                content: [{ type: "text", text: JSON.stringify(data) }],
+                structuredContent: gpfWfsGetFeatureByIdRequestOutputSchema.parse(data),
+            };
+        }
+        if (typeof data === "object" &&
+            data !== null &&
+            "type" in data &&
+            data.type === "FeatureCollection") {
+            return {
+                content: [{ type: "text", text: JSON.stringify(data) }],
+                structuredContent: data,
+            };
+        }
+        throw new Error("Réponse interne inattendue pour gpf_wfs_get_feature_by_id : le résultat devrait être une requête WFS ou une FeatureCollection.");
+    }
+    /**
+     * Orchestrates the by-id execution flow:
+     * schema lookup -> request compilation -> optional request output -> WFS execution -> cardinality validation.
+     *
+     * @param input Normalized tool input.
+     * @returns Either a compiled request or a transformed FeatureCollection containing one feature.
+     */
+    async execute(input) {
+        logger.info(`[tool] execute ${this.name} ...`, {
+            input: input
+        });
+        if (input.result_type === "request") {
+            // The `request` mode is handled here because it returns a preview payload,
+            // not the actual by-id WFS result.
+            const featureType = await getFeatureType(input.typename);
+            const propertyName = buildPropertyName(featureType, {
+                includeGeometry: true,
+                select: input.select,
+            });
+            const request = buildGetFeatureByIdRequest(input.typename, input.feature_id, propertyName);
+            return toWfsRequestPayload(request);
+        }
+        return executeGetFeatureById({
+            typename: input.typename,
+            feature_id: input.feature_id,
+            select: input.select,
+        });
+    }
+}
+export default GpfWfsGetFeatureByIdTool;
+//# sourceMappingURL=GpfWfsGetFeatureByIdTool.js.map

package/dist/tools/GpfWfsGetFeatureByIdTool.js.map

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