@ignfab/geocontext 0.9.3 → 0.9.6

package/dist/tools/GpfWfsDescribeTypeTool.d.ts

@@ -3,7 +3,7 @@ import { z } from "zod";
 import type { Collection } from "@ignfab/gpf-schema-store";
 declare const gpfWfsDescribeTypeInputSchema: z.ZodObject<{
     typename: z.ZodString;
-}, "strip", z.ZodTypeAny, {
+}, "strict", z.ZodTypeAny, {
     typename?: string;
 }, {
     typename?: string;
@@ -50,10 +50,6 @@ declare class GpfWfsDescribeTypeTool extends MCPTool<GpfWfsDescribeTypeInput> {
             }>, "many">;
         }, "strip", z.ZodTypeAny, {
             id?: string;
-            namespace?: string;
-            name?: string;
-            title?: string;
-            description?: string;
             properties?: {
                 type?: string;
                 name?: string;
@@ -62,12 +58,12 @@ declare class GpfWfsDescribeTypeTool extends MCPTool<GpfWfsDescribeTypeInput> {
                 enum?: string[];
                 defaultCrs?: string;
             }[];
-        }, {
-            id?: string;
             namespace?: string;
             name?: string;
             title?: string;
             description?: string;
+        }, {
+            id?: string;
             properties?: {
                 type?: string;
                 name?: string;
@@ -76,14 +72,14 @@ declare class GpfWfsDescribeTypeTool extends MCPTool<GpfWfsDescribeTypeInput> {
                 enum?: string[];
                 defaultCrs?: string;
             }[];
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        result?: {
-            id?: string;
             namespace?: string;
             name?: string;
             title?: string;
             description?: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        result?: {
+            id?: string;
             properties?: {
                 type?: string;
                 name?: string;
@@ -92,14 +88,14 @@ declare class GpfWfsDescribeTypeTool extends MCPTool<GpfWfsDescribeTypeInput> {
                 enum?: string[];
                 defaultCrs?: string;
             }[];
-        };
-    }, {
-        result?: {
-            id?: string;
             namespace?: string;
             name?: string;
             title?: string;
             description?: string;
+        };
+    }, {
+        result?: {
+            id?: string;
             properties?: {
                 type?: string;
                 name?: string;
@@ -108,11 +104,15 @@ declare class GpfWfsDescribeTypeTool extends MCPTool<GpfWfsDescribeTypeInput> {
                 enum?: string[];
                 defaultCrs?: string;
             }[];
+            namespace?: string;
+            name?: string;
+            title?: string;
+            description?: string;
         };
     }>;
     schema: z.ZodObject<{
         typename: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
+    }, "strict", z.ZodTypeAny, {
         typename?: string;
     }, {
         typename?: string;

package/dist/tools/GpfWfsDescribeTypeTool.js

@@ -8,7 +8,7 @@ const gpfWfsDescribeTypeInputSchema = z.object({
         .trim()
         .min(1, "le nom du type ne doit pas être vide")
         .describe("Le nom du type (ex : BDTOPO_V3:batiment)"),
-});
+}).strict();
 const gpfWfsPropertySchema = z.object({
     name: z.string().describe("Le nom de la propriété."),
     type: z.string().describe("Le type de la propriété."),
@@ -34,8 +34,9 @@ class GpfWfsDescribeTypeTool extends MCPTool {
     description = [
         "Renvoie le schéma détaillé d'un type WFS à partir de son identifiant (`typename`) : identifiants, description et liste des propriétés.",
         "Utiliser ce tool après `gpf_wfs_search_types` pour inspecter les propriétés disponibles avant d'appeler `gpf_wfs_get_features`.",
-        "La sortie inclut notamment le type des propriétés, leur description, et leurs valeurs possibles (`enum`) lorsqu'elles existent.",
-    ].join("\r\n");
+        "La sortie inclut notamment le type des propriétés, leur description, leurs valeurs possibles (`enum`) lorsqu'elles existent",
+        "**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;
     async execute(input) {

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,110 @@
+import { MCPTool } from "mcp-framework";
+import type { Collection } from "@ignfab/gpf-schema-store";
+import { z } from "zod";
+import { type CompiledRequest } from "../helpers/wfs_internal/request.js";
+declare const gpfWfsGetFeatureByIdInputSchema: z.ZodObject<{
+    typename: z.ZodString;
+    feature_id: z.ZodString;
+    result_type: z.ZodDefault<z.ZodEnum<["results", "request"]>>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    typename?: string;
+    feature_id?: string;
+    result_type?: "request" | "results";
+    select?: string[];
+}, {
+    typename?: string;
+    feature_id?: string;
+    result_type?: "request" | "results";
+    select?: string[];
+}>;
+type GpfWfsGetFeatureByIdInput = z.infer<typeof gpfWfsGetFeatureByIdInputSchema>;
+type PublishedInputSchema = {
+    type: "object";
+    properties?: Record<string, object>;
+    required?: string[];
+};
+declare class GpfWfsGetFeatureByIdTool extends MCPTool<GpfWfsGetFeatureByIdInput> {
+    name: string;
+    title: string;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    description: string;
+    schema: z.ZodObject<{
+        typename: z.ZodString;
+        feature_id: z.ZodString;
+        result_type: z.ZodDefault<z.ZodEnum<["results", "request"]>>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        typename?: string;
+        feature_id?: string;
+        result_type?: "request" | "results";
+        select?: string[];
+    }, {
+        typename?: string;
+        feature_id?: string;
+        result_type?: "request" | "results";
+        select?: string[];
+    }>;
+    /**
+     * 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(): PublishedInputSchema;
+    /**
+     * Formats compact responses (`request`) into `structuredContent`.
+     *
+     * @param data Raw execution result returned by the tool implementation.
+     * @returns An MCP success response, optionally enriched with structured content.
+     */
+    protected createSuccessResponse(data: unknown): import("mcp-framework").ToolResponse | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        structuredContent: {
+            body?: string;
+            result_type?: "request";
+            method?: "POST";
+            url?: string;
+            query?: Record<string, string>;
+            get_url?: string;
+        };
+    };
+    /**
+     * Loads a WFS feature type description from the embedded catalog.
+     *
+     * @param typename Exact WFS typename to load from the embedded schema store.
+     * @returns The matching feature type description.
+     */
+    protected getFeatureType(typename: string): Promise<Collection>;
+    /**
+     * Executes a compiled WFS request as POST and returns the JSON FeatureCollection.
+     *
+     * @param request Compiled request split into query-string parameters and POST body.
+     * @returns The parsed JSON response returned by the WFS endpoint.
+     */
+    protected fetchFeatureCollection(request: CompiledRequest): Promise<any>;
+    /**
+     * Builds the optional `propertyName` request parameter from `select`.
+     *
+     * @param featureType Feature type definition loaded from the embedded catalog.
+     * @param input Normalized tool input.
+     * @returns A comma-separated property list, or `undefined` when all properties should be returned.
+     */
+    protected buildPropertyName(featureType: Collection, input: GpfWfsGetFeatureByIdInput): string;
+    /**
+     * 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<Record<string, unknown>>;
+}
+export default GpfWfsGetFeatureByIdTool;

package/dist/tools/GpfWfsGetFeatureByIdTool.js

@@ -0,0 +1,156 @@
+import { MCPTool } from "mcp-framework";
+import { z } from "zod";
+import { wfsClient } from "../gpf/wfs.js";
+import { fetchJSONPost } from "../helpers/http.js";
+import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "../helpers/toolAnnotations.js";
+import { generatePublishedInputSchema } from "../helpers/jsonSchema.js";
+import { compileSelectProperty, getGeometryProperty } from "../helpers/wfs_internal/compile.js";
+import { buildGetFeatureByIdRequest } from "../helpers/wfs_internal/request.js";
+import { attachFeatureRefs } from "../helpers/wfs_internal/response.js";
+import { gpfWfsGetFeaturesRequestOutputSchema } from "../helpers/wfs_internal/schema.js";
+const gpfWfsGetFeatureByIdInputSchema = z.object({
+    typename: z
+        .string()
+        .trim()
+        .min(1, "le nom du type ne doit pas être vide")
+        .describe("Nom exact du type WFS à interroger, par exemple `ADMINEXPRESS-COG.LATEST:commune`."),
+    feature_id: z
+        .string()
+        .trim()
+        .min(1, "le feature_id ne doit pas être vide")
+        .describe("Identifiant WFS exact de l'objet à récupérer, par exemple `commune.8952`."),
+    result_type: z
+        .enum(["results", "request"])
+        .default("results")
+        .describe("`results` renvoie une FeatureCollection normalisée avec exactement un objet. `request` renvoie la requête WFS compilée (`get_url`) à destination de `create_map` via `geojson_url`, ou pour déboguer."),
+    select: z
+        .array(z.string().trim().min(1))
+        .min(1)
+        .optional()
+        .describe("Liste des propriétés non géométriques à renvoyer. Quand `result_type=\"request\"`, la géométrie est automatiquement ajoutée."),
+}).strict();
+const gpfWfsGetFeatureByIdPublishedInputSchema = generatePublishedInputSchema(gpfWfsGetFeatureByIdInputSchema);
+class GpfWfsGetFeatureByIdTool extends MCPTool {
+    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 = 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`) into `structuredContent`.
+     *
+     * @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: gpfWfsGetFeaturesRequestOutputSchema.parse(data),
+            };
+        }
+        return super.createSuccessResponse(data);
+    }
+    /**
+     * Loads a WFS feature type description from the embedded catalog.
+     *
+     * @param typename Exact WFS typename to load from the embedded schema store.
+     * @returns The matching feature type description.
+     */
+    async getFeatureType(typename) {
+        return wfsClient.getFeatureType(typename);
+    }
+    /**
+     * Executes a compiled WFS request as POST and returns the JSON FeatureCollection.
+     *
+     * @param request Compiled request split into query-string parameters and POST body.
+     * @returns The parsed JSON response returned by the WFS endpoint.
+     */
+    async fetchFeatureCollection(request) {
+        const url = `${request.url}?${new URLSearchParams(request.query).toString()}`;
+        return fetchJSONPost(url, request.body, {
+            "Content-Type": "application/x-www-form-urlencoded",
+            "Accept": "application/json",
+        });
+    }
+    /**
+     * Builds the optional `propertyName` request parameter from `select`.
+     *
+     * @param featureType Feature type definition loaded from the embedded catalog.
+     * @param input Normalized tool input.
+     * @returns A comma-separated property list, or `undefined` when all properties should be returned.
+     */
+    buildPropertyName(featureType, input) {
+        if (!input.select || input.select.length === 0) {
+            return undefined;
+        }
+        const geometryProperty = getGeometryProperty(featureType);
+        const selectedProperties = input.select.map((propertyName) => compileSelectProperty(featureType, geometryProperty, propertyName));
+        if (input.result_type === "request") {
+            return [...selectedProperties, geometryProperty.name].join(",");
+        }
+        return selectedProperties.join(",");
+    }
+    /**
+     * 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) {
+        const featureType = await this.getFeatureType(input.typename);
+        const propertyName = this.buildPropertyName(featureType, input);
+        const request = buildGetFeatureByIdRequest(input.typename, input.feature_id, propertyName);
+        if (input.result_type === "request") {
+            return {
+                result_type: "request",
+                method: request.method,
+                url: request.url,
+                query: request.query,
+                body: request.body,
+                get_url: request.get_url ?? null,
+            };
+        }
+        const featureCollection = await this.fetchFeatureCollection(request);
+        if (!Array.isArray(featureCollection?.features)) {
+            throw new Error("Le service WFS n'a pas retourné de collection d'objets exploitable.");
+        }
+        if (featureCollection.features.length === 0) {
+            throw new Error(`Le feature '${input.feature_id}' est introuvable dans '${input.typename}'.`);
+        }
+        if (featureCollection.features.length > 1) {
+            throw new Error(`Le feature '${input.feature_id}' dans '${input.typename}' devrait être unique, mais ${featureCollection.features.length} objets ont été retournés.`);
+        }
+        const [firstFeature] = featureCollection.features;
+        if (firstFeature?.id !== input.feature_id) {
+            throw new Error(`Le service WFS a retourné l'identifiant '${String(firstFeature?.id)}' au lieu de '${input.feature_id}'.`);
+        }
+        const singleFeatureCollection = {
+            ...featureCollection,
+            features: [firstFeature],
+            totalFeatures: 1,
+            numberReturned: 1,
+            numberMatched: 1,
+        };
+        return attachFeatureRefs(singleFeatureCollection, input.typename);
+    }
+}
+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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"}

package/dist/tools/GpfWfsGetFeaturesTool.d.ts

@@ -1,28 +1,7 @@
 import { MCPTool } from "mcp-framework";
-import { z } from "zod";
-declare const gpfWfsGetFeaturesInputSchema: z.ZodObject<{
-    typename: z.ZodString;
-    property_names: z.ZodOptional<z.ZodString>;
-    sort_by: z.ZodOptional<z.ZodString>;
-    count: z.ZodOptional<z.ZodNumber>;
-    cql_filter: z.ZodOptional<z.ZodString>;
-    result_type: z.ZodOptional<z.ZodEnum<["results", "hits", "url"]>>;
-}, "strip", z.ZodTypeAny, {
-    cql_filter?: string;
-    typename?: string;
-    property_names?: string;
-    sort_by?: string;
-    count?: number;
-    result_type?: "results" | "hits" | "url";
-}, {
-    cql_filter?: string;
-    typename?: string;
-    property_names?: string;
-    sort_by?: string;
-    count?: number;
-    result_type?: "results" | "hits" | "url";
-}>;
-type GpfWfsGetFeaturesInput = z.infer<typeof gpfWfsGetFeaturesInputSchema>;
+import type { Collection } from "@ignfab/gpf-schema-store";
+import { type CompiledRequest } from "../helpers/wfs_internal/request.js";
+import { type GpfWfsGetFeaturesInput } from "../helpers/wfs_internal/schema.js";
 declare class GpfWfsGetFeaturesTool extends MCPTool<GpfWfsGetFeaturesInput> {
     name: string;
     title: string;
@@ -33,28 +12,121 @@ declare class GpfWfsGetFeaturesTool extends MCPTool<GpfWfsGetFeaturesInput> {
         openWorldHint: boolean;
     };
     description: string;
-    schema: z.ZodObject<{
-        typename: z.ZodString;
-        property_names: z.ZodOptional<z.ZodString>;
-        sort_by: z.ZodOptional<z.ZodString>;
-        count: z.ZodOptional<z.ZodNumber>;
-        cql_filter: z.ZodOptional<z.ZodString>;
-        result_type: z.ZodOptional<z.ZodEnum<["results", "hits", "url"]>>;
-    }, "strip", z.ZodTypeAny, {
-        cql_filter?: string;
+    schema: import("zod").ZodObject<{
+        typename: import("zod").ZodString;
+        limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        result_type: import("zod").ZodDefault<import("zod").ZodEnum<["results", "hits", "request"]>>;
+        select: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        order_by: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            property: import("zod").ZodString;
+            direction: import("zod").ZodDefault<import("zod").ZodEnum<["asc", "desc"]>>;
+        }, "strict", import("zod").ZodTypeAny, {
+            property?: string;
+            direction?: "asc" | "desc";
+        }, {
+            property?: string;
+            direction?: "asc" | "desc";
+        }>, "many">>;
+        where: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            property: import("zod").ZodString;
+            operator: import("zod").ZodEnum<["eq", "ne", "lt", "lte", "gt", "gte", "in", "is_null"]>;
+            value: import("zod").ZodOptional<import("zod").ZodString>;
+            values: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, "strict", import("zod").ZodTypeAny, {
+            values?: string[];
+            value?: string;
+            property?: string;
+            operator?: "gte" | "gt" | "lte" | "lt" | "eq" | "ne" | "in" | "is_null";
+        }, {
+            values?: string[];
+            value?: string;
+            property?: string;
+            operator?: "gte" | "gt" | "lte" | "lt" | "eq" | "ne" | "in" | "is_null";
+        }>, "many">>;
+        spatial_operator: import("zod").ZodOptional<import("zod").ZodEnum<["bbox", "intersects_point", "dwithin_point", "intersects_feature"]>>;
+        bbox_west: import("zod").ZodOptional<import("zod").ZodNumber>;
+        bbox_south: import("zod").ZodOptional<import("zod").ZodNumber>;
+        bbox_east: import("zod").ZodOptional<import("zod").ZodNumber>;
+        bbox_north: import("zod").ZodOptional<import("zod").ZodNumber>;
+        intersects_lon: import("zod").ZodOptional<import("zod").ZodNumber>;
+        intersects_lat: import("zod").ZodOptional<import("zod").ZodNumber>;
+        dwithin_lon: import("zod").ZodOptional<import("zod").ZodNumber>;
+        dwithin_lat: import("zod").ZodOptional<import("zod").ZodNumber>;
+        dwithin_distance_m: import("zod").ZodOptional<import("zod").ZodNumber>;
+        intersects_feature_typename: import("zod").ZodOptional<import("zod").ZodString>;
+        intersects_feature_id: import("zod").ZodOptional<import("zod").ZodString>;
+    }, "strict", import("zod").ZodTypeAny, {
         typename?: string;
-        property_names?: string;
-        sort_by?: string;
-        count?: number;
-        result_type?: "results" | "hits" | "url";
+        limit?: number;
+        result_type?: "request" | "results" | "hits";
+        select?: string[];
+        order_by?: {
+            property?: string;
+            direction?: "asc" | "desc";
+        }[];
+        where?: {
+            values?: string[];
+            value?: string;
+            property?: string;
+            operator?: "gte" | "gt" | "lte" | "lt" | "eq" | "ne" | "in" | "is_null";
+        }[];
+        spatial_operator?: "bbox" | "intersects_point" | "dwithin_point" | "intersects_feature";
+        bbox_west?: number;
+        bbox_south?: number;
+        bbox_east?: number;
+        bbox_north?: number;
+        intersects_lon?: number;
+        intersects_lat?: number;
+        dwithin_lon?: number;
+        dwithin_lat?: number;
+        dwithin_distance_m?: number;
+        intersects_feature_typename?: string;
+        intersects_feature_id?: string;
     }, {
-        cql_filter?: string;
         typename?: string;
-        property_names?: string;
-        sort_by?: string;
-        count?: number;
-        result_type?: "results" | "hits" | "url";
+        limit?: number;
+        result_type?: "request" | "results" | "hits";
+        select?: string[];
+        order_by?: {
+            property?: string;
+            direction?: "asc" | "desc";
+        }[];
+        where?: {
+            values?: string[];
+            value?: string;
+            property?: string;
+            operator?: "gte" | "gt" | "lte" | "lt" | "eq" | "ne" | "in" | "is_null";
+        }[];
+        spatial_operator?: "bbox" | "intersects_point" | "dwithin_point" | "intersects_feature";
+        bbox_west?: number;
+        bbox_south?: number;
+        bbox_east?: number;
+        bbox_north?: number;
+        intersects_lon?: number;
+        intersects_lat?: number;
+        dwithin_lon?: number;
+        dwithin_lat?: number;
+        dwithin_distance_m?: number;
+        intersects_feature_typename?: string;
+        intersects_feature_id?: string;
     }>;
+    /**
+     * 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(): {
+        type: "object";
+        properties?: Record<string, object>;
+        required?: string[];
+    };
+    /**
+     * Formats compact responses (`hits`, `request`) into `structuredContent`.
+     * Full result sets are still delegated to the framework default behavior.
+     *
+     * @param data Raw execution result returned by the tool implementation.
+     * @returns An MCP success response, optionally enriched with structured content.
+     */
     protected createSuccessResponse(data: unknown): import("mcp-framework").ToolResponse | {
         content: {
             type: "text";
@@ -70,10 +142,55 @@ declare class GpfWfsGetFeaturesTool extends MCPTool<GpfWfsGetFeaturesInput> {
             text: string;
         }[];
         structuredContent: {
+            body?: string;
+            result_type?: "request";
+            method?: "POST";
             url?: string;
-            result_type?: "url";
+            query?: Record<string, string>;
+            get_url?: string;
         };
     };
-    execute(input: GpfWfsGetFeaturesInput): Promise<any>;
+    /**
+     * Loads a WFS feature type description from the embedded catalog.
+     *
+     * @param typename Exact WFS typename to load from the embedded schema store.
+     * @returns The matching feature type description.
+     */
+    protected getFeatureType(typename: string): Promise<Collection>;
+    /**
+     * Executes a compiled WFS request as POST and returns the JSON FeatureCollection.
+     *
+     * @param request Compiled request split into query-string parameters and POST body.
+     * @returns The parsed JSON response returned by the WFS endpoint.
+     */
+    protected fetchFeatureCollection(request: CompiledRequest): Promise<any>;
+    /**
+     * Extracts a result count from a WFS response, preferring `numberMatched`.
+     * Explicitly rejects responses that do not provide a usable total.
+     *
+     * @param featureCollection Parsed WFS response object.
+     * @returns The total number of matching features.
+     */
+    protected getMatchedFeatureCount(featureCollection: Record<string, unknown>): number;
+    /**
+     * Resolves the geometry of a reference feature when `intersects_feature` is used,
+     * then converts it to EWKT for CQL compilation.
+     *
+     * @param input Normalized tool input.
+     * @returns The resolved reference geometry, or `undefined` when no reference feature is needed.
+     */
+    protected resolveIntersectsFeatureGeometry(input: GpfWfsGetFeaturesInput): Promise<{
+        typename: string;
+        feature_id: string;
+        geometry_ewkt: string;
+    }>;
+    /**
+     * Orchestrates the full tool execution flow:
+     * catalog lookup -> compilation -> WFS request -> response post-processing.
+     *
+     * @param input Normalized tool input.
+     * @returns Either a compiled request, a hit count, or a transformed FeatureCollection.
+     */
+    execute(input: GpfWfsGetFeaturesInput): Promise<Record<string, unknown>>;
 }
 export default GpfWfsGetFeaturesTool;