@honua/mcp-server 0.1.18 → 0.1.19

package/README.md

@@ -131,6 +131,10 @@ check refuses a conflicting or incomplete legacy installation.
   isolated local-install catalog instead of the ordinary read-only server.
 - `HONUA_TRANSPORT` (optional): `grpc-web` (default, Honua deployments) or `rest`.
   Use `rest` for plain public ArcGIS/OGC endpoints.
+  Feature counts use the selected transport's count operation. With `grpc-web`,
+  statistics materialize the complete matching set through feature RPCs and
+  report client-side execution as `degraded`; they fail rather than return a
+  partial aggregate when the 100-page / 200,000-feature budget is exceeded.
 - `HONUA_API_KEY` (optional): API key when your deployment requires it. Public
   endpoints need none.
 - `HONUA_TIMEOUT_MS` (optional): request timeout in milliseconds (default `30000`)

package/dist/src/tools/count-features.d.ts

@@ -9,7 +9,8 @@ import { projectDegraded } from "../neutral/result.js";
  * from whichever canonical path the source's declared capabilities support:
  *
  *  1. `queryExtent` (GeoServices, WFS, gRPC) returns an exact server count
- *     alongside the envelope in one round trip.
+ *     alongside the envelope. gRPC uses a second count RPC when its extent
+ *     response omits the count.
  *  2. otherwise a single-record `query` reports `totalCount`, which is where
  *     OGC API Features / STAC / OData carry `numberMatched`.
  *

package/dist/src/tools/count-features.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"count-features.d.ts","sourceRoot":"","sources":["../../../src/tools/count-features.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGjB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE3C,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,GAAG,YAAY,CAAC;IACvC,QAAQ,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;CAC9C;AAED,sEAAsE;AACtE,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAevB;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;;;GAoBpF"}
+{"version":3,"file":"count-features.d.ts","sourceRoot":"","sources":["../../../src/tools/count-features.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGjB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE3C,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,GAAG,YAAY,CAAC;IACvC,QAAQ,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;CAC9C;AAED,sEAAsE;AACtE,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAevB;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;;;GAoBpF"}

package/dist/src/tools/count-features.js

@@ -12,7 +12,8 @@ import { resolveSource, sourceRefFields } from "../neutral/source-ref.js";
  * from whichever canonical path the source's declared capabilities support:
  *
  *  1. `queryExtent` (GeoServices, WFS, gRPC) returns an exact server count
- *     alongside the envelope in one round trip.
+ *     alongside the envelope. gRPC uses a second count RPC when its extent
+ *     response omits the count.
  *  2. otherwise a single-record `query` reports `totalCount`, which is where
  *     OGC API Features / STAC / OData carry `numberMatched`.
  *

package/dist/src/tools/statistics.d.ts

@@ -5,9 +5,9 @@ import { z } from "zod";
  *
  * Lowers onto the canonical `AggregationSpec`, which GeoServices serves with
  * `outStatistics` and which OGC API Features (no server-side aggregation)
- * serves client-side over the returned page with an explicit `degraded` reason.
- * The reason is reported in the result rather than dropped, so a page-scoped
- * aggregate is never mistaken for an authoritative one.
+ * serves client-side over the complete matching set with an explicit `degraded`
+ * reason. gRPC similarly materializes the matching set through supported RPCs
+ * and rejects a truncated result or an exhausted finite drain budget.
  */
 export declare const schema: z.ZodObject<{
     statisticType: z.ZodEnum<["count", "sum", "avg", "min", "max", "stddev", "var"]>;

package/dist/src/tools/statistics.js

@@ -9,9 +9,9 @@ import { isGeoServicesProtocol, resolveSource, sourceRefFields } from "../neutra
  *
  * Lowers onto the canonical `AggregationSpec`, which GeoServices serves with
  * `outStatistics` and which OGC API Features (no server-side aggregation)
- * serves client-side over the returned page with an explicit `degraded` reason.
- * The reason is reported in the result rather than dropped, so a page-scoped
- * aggregate is never mistaken for an authoritative one.
+ * serves client-side over the complete matching set with an explicit `degraded`
+ * reason. gRPC similarly materializes the matching set through supported RPCs
+ * and rejects a truncated result or an exhausted finite drain budget.
  */
 export const schema = z.object({
     ...sourceRefFields,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honua/mcp-server",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "Platform-free MCP server for geospatial services: expose discovery, query, and analysis over any public ArcGIS/Esri FeatureServer or OGC API endpoint to any MCP client, with no platform lock-in",
   "license": "Apache-2.0",
   "author": "Honua",
@@ -89,7 +89,7 @@
     "qs": "^6.16.0"
   },
   "peerDependencies": {
-    "@honua/sdk-js": "^0.1.17"
+    "@honua/sdk-js": "^0.1.17 || ^0.2.0"
   },
   "devDependencies": {
     "@biomejs/biome": "1.9.4",