@honua/mcp-server 0.1.14 → 0.1.16

package/dist/src/eval/operator-corpus.js

@@ -1,3 +1,4 @@
+import { TYPED_PROPOSAL_TOOLS } from "./proposal-tools.js";
 /**
  * Operator-surface corpus for the cross-model eval (honua-server #1956).
  *
@@ -16,11 +17,15 @@
  * criteria over the identical live catalog.
  *
  * SAFETY: these scenarios are READ-MOSTLY and reversible. The end-to-end planning
- * scenarios stop at validate / dry-run and FORBID the mutating lifecycle tools
- * (`honua_execute_plan`, `honua_propose_operation`) — on the Community-edition
- * demo `honua_propose_operation` executes directly (no approval gate), so a
- * correct agent must NOT call it for a read-only analysis task. Forbidding those
- * tools turns "did the agent stay read-only?" into a graded criterion.
+ * scenarios stop at validate / dry-run and FORBID the mutating lifecycle tools:
+ * `honua_execute_plan` and the typed governed-proposal roster
+ * (`honua_propose_finding`, `honua_propose_deploy_plan`,
+ * `honua_propose_deploy_operation`, `honua_propose_rollback`,
+ * `honua_propose_platform_release_convergence`, `honua_propose_metadata_release`)
+ * that replaced the retired `honua_propose_operation`. Each proposal files a
+ * control-plane change for approval, so a correct agent must NOT call one for a
+ * read-only analysis task. Forbidding those tools turns "did the agent stay
+ * read-only?" into a graded criterion.
  *
  * Grading is deliberately tool-centric: required-tool selection, ordered
  * subsequence, and forbidden-tool avoidance — the verifiable signals of "the
@@ -37,7 +42,7 @@
 const MAUI_BUILDINGS_SERVICE = "svc-publish-maui-buildings";
 const MAUI_BUILDINGS_LAYER = 13;
 /** Mutating lifecycle tools a read-only analysis agent must never call. */
-const MUTATING_TOOLS = ["honua_execute_plan", "honua_propose_operation"];
+const MUTATING_TOOLS = ["honua_execute_plan", ...TYPED_PROPOSAL_TOOLS];
 /** A small, static, well-formed analysis plan reused by validate/dry-run. */
 const SAMPLE_PLAN = {
     planId: "eval-operator-plan-1",

package/dist/src/eval/proposal-tools.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The honua-server governed-proposal roster.
+ *
+ * The server retired the opaque `honua_propose_operation` escape hatch
+ * (honua-server #3474/#3735) and replaced it with one typed tool per proposal
+ * kind. Each one files a control-plane proposal for human approval; none of them
+ * belongs in a read-only analysis or a north-star authoring workflow, so the
+ * corpora forbid the whole roster where they used to forbid the single retired
+ * name.
+ */
+export declare const TYPED_PROPOSAL_TOOLS: readonly ["honua_propose_finding", "honua_propose_deploy_plan", "honua_propose_deploy_operation", "honua_propose_rollback", "honua_propose_platform_release_convergence", "honua_propose_metadata_release"];
+/** The retired generic proposal tool. No catalog or corpus may name it. */
+export declare const RETIRED_PROPOSAL_TOOL = "honua_propose_operation";
+//# sourceMappingURL=proposal-tools.d.ts.map

package/dist/src/eval/proposal-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal-tools.d.ts","sourceRoot":"","sources":["../../../src/eval/proposal-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,6MAOvB,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,4BAA4B,CAAC"}

package/dist/src/eval/proposal-tools.js

@@ -0,0 +1,20 @@
+/**
+ * The honua-server governed-proposal roster.
+ *
+ * The server retired the opaque `honua_propose_operation` escape hatch
+ * (honua-server #3474/#3735) and replaced it with one typed tool per proposal
+ * kind. Each one files a control-plane proposal for human approval; none of them
+ * belongs in a read-only analysis or a north-star authoring workflow, so the
+ * corpora forbid the whole roster where they used to forbid the single retired
+ * name.
+ */
+export const TYPED_PROPOSAL_TOOLS = [
+    "honua_propose_finding",
+    "honua_propose_deploy_plan",
+    "honua_propose_deploy_operation",
+    "honua_propose_rollback",
+    "honua_propose_platform_release_convergence",
+    "honua_propose_metadata_release",
+];
+/** The retired generic proposal tool. No catalog or corpus may name it. */
+export const RETIRED_PROPOSAL_TOOL = "honua_propose_operation";

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAItF,OAAO,EAAE,KAAK,mBAAmB,EAAgC,MAAM,qBAAqB,CAAC;AAM7F,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAanF,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iCAAiC,EACjC,2BAA2B,EAC3B,6BAA6B,EAC7B,gCAAgC,GACjC,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AACnF,YAAY,EACV,gCAAgC,EAChC,yBAAyB,EACzB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;CAC5D;AAMD,eAAO,MAAM,cAAc,QAAyB,CAAC;AA2DrD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,cAAc,CAgD5E;AAED,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,WAAW,CASrF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,mBAAwB,aAoHlF;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,IAAI,SAAS,CAIjD;AAgBD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAItF,OAAO,EAAE,KAAK,mBAAmB,EAAgC,MAAM,qBAAqB,CAAC;AAM7F,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAanF,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iCAAiC,EACjC,2BAA2B,EAC3B,6BAA6B,EAC7B,gCAAgC,GACjC,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AACnF,YAAY,EACV,gCAAgC,EAChC,yBAAyB,EACzB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;CAC5D;AAMD,eAAO,MAAM,cAAc,QAAyB,CAAC;AA6DrD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,cAAc,CAgD5E;AAED,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,WAAW,CASrF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,mBAAwB,aA0HlF;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,IAAI,SAAS,CAIjD;AAgBD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvF"}

package/dist/src/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
 import { HonuaClient } from "@honua/sdk-js";
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -29,7 +30,9 @@ const DEFAULT_SERVER_VERSION = "0.0.3-alpha.0";
 export const SERVER_VERSION = resolveServerVersion();
 function resolveServerVersion() {
     try {
-        const packageJsonPath = new URL("../../package.json", import.meta.url);
+        // Self-reference resolves this package in both src/ and dist/src/. A
+        // relative ../../ path reads the SDK's manifest when Vitest loads src/.
+        const packageJsonPath = createRequire(import.meta.url).resolve("@honua/mcp-server/package.json");
         const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
         if (typeof packageJson.version === "string" && packageJson.version.length > 0) {
             return packageJson.version;
@@ -172,13 +175,19 @@ export function createServer(client, options = {}) {
         registerNlMapControlMcpTools(server, options.nlMapControl);
     }
     server.tool("honua_describe_layer", "Describe a source: its protocol, the capabilities it actually supports, field schema, geometry type, and extent. Address it with `source` (from honua_list_sources); the serviceId/layerId pair is deprecated but still accepted.", describeLayer.schema.shape, async (args) => describeLayer.execute(client, describeLayer.schema.parse(args)));
-    server.tool("honua_query_features", "Query features from any supported protocol. Address the source with `source`; filter with the typed protocol-neutral `filter`, a GeoJSON `geometry` or `bbox` plus `spatialRel`, and `temporal`. returnGeometry defaults to false to save tokens. A construct the backing protocol cannot express returns a structured capability error, never a silently empty result.", queryFeatures.schema.shape, async (args, extra) => queryFeatures.execute(client, queryFeatures.schema.parse(args), extra?.signal));
+    server.registerTool("honua_query_features", {
+        description: "Query features from any supported protocol. Address the source with source; use the typed filter, GeoJSON geometry or bbox, and temporal. returnGeometry defaults to true. resultOffset/outSrid alias offset/outSr; use honua_count_features for count-only requests. Unsupported inputs fail explicitly.",
+        inputSchema: queryFeatures.schema,
+    }, async (args, extra) => queryFeatures.execute(client, queryFeatures.schema.parse(args), extra?.signal));
     server.tool("honua_count_features", "Count features matching a filter without returning data. Use before querying to check cardinality.", countFeatures.schema.shape, async (args, extra) => countFeatures.execute(client, countFeatures.schema.parse(args), extra?.signal));
     server.tool("honua_get_extent", "Get the spatial bounding box of features matching a filter.", getExtent.schema.shape, async (args, extra) => getExtent.execute(client, getExtent.schema.parse(args), extra?.signal));
     server.tool("honua_statistics", "Compute aggregate statistics (count, sum, avg, min, max, stddev, var) on a field, optionally grouped. Protocols without server-side aggregation answer client-side and report the degradation.", statistics.schema.shape, async (args, extra) => statistics.execute(client, statistics.schema.parse(args), extra?.signal));
     server.tool("honua_explain_capability_gap", "Explain whether a source/protocol supports a capability and suggest a safe fallback when it does not.", explainCapabilityGap.schema.shape, async (args) => explainCapabilityGap.execute(client, explainCapabilityGap.schema.parse(args)));
     server.tool("honua_get_style", "Resolve a style from a server's OGC API – Styles surface. Pass styleId for the canonical StyleRef (style_id, title, encodings incl. inlined MapLibre); omit it to list available styles. On a plain FeatureServer with no styling surface, reports a structured 'not available on this target' result.", getStyle.schema.shape, async (args) => getStyle.execute(client, getStyle.schema.parse(args)));
-    server.tool("honua_apply_style_preset", "Resolve a style preset and its MapLibre stylesheet for client-side application. Read-only: returns the stylesheet to apply locally; it does not mutate server state. Degrades gracefully on a target with no styling surface.", applyStylePreset.schema.shape, async (args) => applyStylePreset.execute(client, applyStylePreset.schema.parse(args)));
+    server.registerTool("honua_apply_style_preset", {
+        description: "Resolve a style preset for client-side application. Returns its stylesheet without persisting a layer binding; serviceId/layerId targets are unsupported.",
+        inputSchema: applyStylePreset.schema,
+    }, async (args) => applyStylePreset.execute(client, applyStylePreset.schema.parse(args)));
     if (options.controlPlaneCommands) {
         // Thin adapters generated from the shared command catalog. Registered last
         // so the platform-free read-only surface keeps its stable tool order.

package/dist/src/neutral/query.js

@@ -53,7 +53,7 @@ export const queryShapeFields = {
         .describe('Sort order as [{"field":"NAME","direction":"desc"}], or the legacy string form "NAME DESC,VALUE ASC".'),
     limit: z.number().int().positive().optional().describe("Max features to return (default 100, max 2000)."),
     offset: z.number().int().nonnegative().optional().describe("Number of features to skip (for pagination)."),
-    returnGeometry: z.boolean().optional().default(false).describe("Include geometry in results (default: false)."),
+    returnGeometry: z.boolean().optional().default(true).describe("Include geometry in results (default: true)."),
     geometryFormat: z
         .enum(["geojson", "esri-json"])
         .optional()

package/dist/src/release/zero-to-map-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zero-to-map-cli.d.ts","sourceRoot":"","sources":["../../../src/release/zero-to-map-cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"zero-to-map-cli.d.ts","sourceRoot":"","sources":["../../../src/release/zero-to-map-cli.ts"],"names":[],"mappings":"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"}

package/dist/src/release/zero-to-map-cli.js

@@ -14,7 +14,7 @@ import { requireSecureCredentialEndpoint } from "../credential-endpoint.js";
 import { isMainEntrypoint } from "../entrypoint.js";
 import { resolveProxyOptions } from "../proxy.js";
 import { assertZeroToMapCheckpointBindings, assertZeroToMapCheckpointDigest, assertZeroToMapCheckpointFresh, consumeZeroToMapCheckpoint, createZeroToMapCheckpoint, parseZeroToMapCheckpoint, } from "./zero-to-map-checkpoint.js";
-import { ZERO_TO_MAP_ACCESS_GRANTS, assertAwsEcsProvisionBindings, parseAwsEcsProvisionBinding, } from "./zero-to-map-provision.js";
+import { ZERO_TO_MAP_LOCAL_ACCESS_GRANTS, assertAwsEcsProvisionBindings, parseAwsEcsProvisionBinding, } from "./zero-to-map-provision.js";
 import { JourneyBlockedError, assertRenderedPng, parseZeroToMapPlan, resolvePublishedShareUrl, runZeroToMapJourney, } from "./zero-to-map.js";
 class ContractAdapter {
     runCli() {
@@ -642,6 +642,7 @@ export function parseInstallAccessCredential(stdout) {
         "baseUrl",
         "claudeDesktopConfigFile",
         "composeFile",
+        "credentialReissued",
         "directory",
         "envFile",
         "mcpConfigFile",
@@ -650,7 +651,12 @@ export function parseInstallAccessCredential(stdout) {
         "reused",
         "serverImage",
         "status",
+        ...(root.reason === undefined ? [] : ["reason"]),
     ], "local installer receipt");
+    if (typeof root.credentialReissued !== "boolean" ||
+        (root.credentialReissued ? root.reason !== "legacy-grants" : root.reason !== undefined)) {
+        throw new Error("local installer receipt credential re-issue fields are inconsistent");
+    }
     const credential = releaseRecord(root.accessCredential, "local installer access credential");
     releaseExactKeys(credential, [
         "canAuthenticate",
@@ -672,7 +678,7 @@ export function parseInstallAccessCredential(stdout) {
     if (stableStringSet(requestedGrants) !== stableStringSet(effectiveGrants)) {
         throw new Error("local installer requested and effective access grants do not match");
     }
-    if (stableStringSet(requestedGrants) !== stableStringSet(ZERO_TO_MAP_ACCESS_GRANTS)) {
+    if (stableStringSet(requestedGrants) !== stableStringSet(ZERO_TO_MAP_LOCAL_ACCESS_GRANTS)) {
         throw new Error("local installer access credential is not scoped to the required release grants");
     }
     if (credential.status !== "active" ||

package/dist/src/release/zero-to-map-provision.d.ts

@@ -1,5 +1,11 @@
 export declare const AWS_ECS_PROVISION_BINDING_SCHEMA: "honua.aws-ecs.provision-binding/v1";
 export declare const ZERO_TO_MAP_ACCESS_GRANTS: readonly ["admin:read", "admin:write"];
+/**
+ * Grants the local installer mints on `honua-local-agent` (`LOCAL_AGENT_GRANTS` in
+ * `@honua/sdk-js/local-install`). `read:*` is required since honua-server #5643:
+ * administrative grants alone no longer read layer data.
+ */
+export declare const ZERO_TO_MAP_LOCAL_ACCESS_GRANTS: readonly ["admin:read", "admin:write", "read:*"];
 export interface ProvisionedAccessCredentialReceipt {
     readonly id: string;
     readonly requestedGrants: readonly string[];

package/dist/src/release/zero-to-map-provision.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zero-to-map-provision.d.ts","sourceRoot":"","sources":["../../../src/release/zero-to-map-provision.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gCAAgC,EAAG,oCAA6C,CAAC;AAC9F,eAAO,MAAM,yBAAyB,wCAAyC,CAAC;AAEhF,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,OAAO,gCAAgC,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,kCAAkC,CAAC;IAC9D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,GAAG,cAAc,GAAG,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7F,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,GAAG,iBAAiB,GAAG,WAAW,GAAG,mBAAmB,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtH,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,qGAAqG;AACrG,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAkIlF;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,sBAAsB,EAC/B,QAAQ,EAAE;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9F,IAAI,CAON;AAWD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BhE"}
+{"version":3,"file":"zero-to-map-provision.d.ts","sourceRoot":"","sources":["../../../src/release/zero-to-map-provision.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gCAAgC,EAAG,oCAA6C,CAAC;AAC9F,eAAO,MAAM,yBAAyB,wCAAyC,CAAC;AAChF;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,kDAAmD,CAAC;AAEhG,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,OAAO,gCAAgC,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,kCAAkC,CAAC;IAC9D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,GAAG,cAAc,GAAG,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7F,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,GAAG,iBAAiB,GAAG,WAAW,GAAG,mBAAmB,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtH,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,qGAAqG;AACrG,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAkIlF;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,sBAAsB,EAC/B,QAAQ,EAAE;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9F,IAAI,CAON;AAWD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BhE"}

package/dist/src/release/zero-to-map-provision.js

@@ -1,6 +1,12 @@
 import { createHash } from "node:crypto";
 export const AWS_ECS_PROVISION_BINDING_SCHEMA = "honua.aws-ecs.provision-binding/v1";
 export const ZERO_TO_MAP_ACCESS_GRANTS = ["admin:read", "admin:write"];
+/**
+ * Grants the local installer mints on `honua-local-agent` (`LOCAL_AGENT_GRANTS` in
+ * `@honua/sdk-js/local-install`). `read:*` is required since honua-server #5643:
+ * administrative grants alone no longer read layer data.
+ */
+export const ZERO_TO_MAP_LOCAL_ACCESS_GRANTS = ["admin:read", "admin:write", "read:*"];
 /** Strictly parse the producer-owned pre-teardown binding without importing a second provisioner. */
 export function parseAwsEcsProvisionBinding(value) {
     const binding = object(value, "AWS ECS provision binding");

package/dist/src/tools/apply-style-preset.d.ts

@@ -2,7 +2,7 @@ import type { HonuaClient } from "@honua/sdk-js";
 import { z } from "zod";
 export declare const schema: z.ZodObject<{
     styleId: z.ZodString;
-}, "strip", z.ZodTypeAny, {
+}, "strict", z.ZodTypeAny, {
     styleId: string;
 }, {
     styleId: string;

package/dist/src/tools/apply-style-preset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply-style-preset.d.ts","sourceRoot":"","sources":["../../../src/tools/apply-style-preset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,MAAM;;;;;;EAEjB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE3C;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK;;;;;GAqB9D"}
+{"version":3,"file":"apply-style-preset.d.ts","sourceRoot":"","sources":["../../../src/tools/apply-style-preset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,MAAM;;;;;;EAIR,CAAC;AAEZ,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE3C;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK;;;;;GAqB9D"}

package/dist/src/tools/apply-style-preset.js

@@ -4,9 +4,11 @@ import { jsonText } from "../helpers.js";
 import { STYLE_SURFACE, resolveStyleRef } from "../styles.js";
 const STYLE_GUIDANCE = "This target is a plain FeatureServer/OGC endpoint with no style presets. " +
     "Build a MapLibre style client-side from the layer's fields, or use a Honua deployment for managed presets.";
-export const schema = z.object({
+export const schema = z
+    .object({
     styleId: z.string().describe("Stable style identifier of the preset to resolve."),
-});
+})
+    .strict();
 /**
  * Resolve a style preset for client-side application. Returns the canonical
  * `StyleRef` plus the MapLibre/Mapbox stylesheet body so an agent or downstream

package/dist/src/tools/control-plane-command.d.ts

@@ -86,7 +86,7 @@ type ControlPlaneCommandToolArgs = z.infer<ReturnType<typeof controlPlaneCommand
  * serialized taxonomy, not rethrown as an opaque MCP failure: an agent has to
  * be able to tell a `validation` refusal from a `conflict` it should retry.
  */
-export declare function execute(host: ControlPlaneCommandMcpHost, command: HonuaAnyCommand, args: ControlPlaneCommandToolArgs): Promise<CallToolResult>;
+export declare function execute(host: ControlPlaneCommandMcpHost, command: HonuaAnyCommand, args: ControlPlaneCommandToolArgs, signal?: AbortSignal): Promise<CallToolResult>;
 /**
  * Register one MCP tool per catalog command.
  *

package/dist/src/tools/control-plane-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-plane-command.d.ts","sourceRoot":"","sources":["../../../src/tools/control-plane-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,oBAAoB,EAGzB,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mDAAmD;AACnD,eAAO,MAAM,iCAAiC,mBAAmB,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAC1C;AAED,mEAAmE;AACnE,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,eAAe;;;;;;;;;;;;;;;GAgBrE;AAED,KAAK,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,CAAC;AAE7F;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,0BAA0B,EAChC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,cAAc,CAAC,CAsBzB;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,0BAA0B,GAAG,IAAI,CAkB1G"}
+{"version":3,"file":"control-plane-command.d.ts","sourceRoot":"","sources":["../../../src/tools/control-plane-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,oBAAoB,EAGzB,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mDAAmD;AACnD,eAAO,MAAM,iCAAiC,mBAAmB,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAC1C;AAED,mEAAmE;AACnE,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,eAAe;;;;;;;;;;;;;;;GAgBrE;AAED,KAAK,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,CAAC;AAE7F;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,0BAA0B,EAChC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,2BAA2B,EACjC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAuBzB;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,0BAA0B,GAAG,IAAI,CAkB1G"}

package/dist/src/tools/control-plane-command.js

@@ -74,9 +74,10 @@ export function controlPlaneCommandToolSchema(command) {
  * serialized taxonomy, not rethrown as an opaque MCP failure: an agent has to
  * be able to tell a `validation` refusal from a `conflict` it should retry.
  */
-export async function execute(host, command, args) {
+export async function execute(host, command, args, signal) {
     const invocation = {
         transport: "mcp",
+        ...(signal ? { signal } : {}),
         ...(host.identity ? { identity: host.identity } : {}),
         ...(args.idempotencyKey ? { idempotencyKey: args.idempotencyKey } : {}),
         ...(args.ifMatch ? { ifMatch: args.ifMatch } : {}),
@@ -117,7 +118,7 @@ export function registerControlPlaneCommandTools(server, host) {
                 idempotentHint: true,
                 openWorldHint: true,
             },
-        }, async (args) => execute(host, command, args));
+        }, async (args, extra) => execute(host, command, args, extra.signal));
     }
 }
 // ---------------------------------------------------------------------------

package/dist/src/tools/docs-search.d.ts

@@ -53,8 +53,8 @@ export interface DocsCorpusLocation {
 }
 /**
  * Locate the corpus: an explicit `HONUA_DOCS_CORPUS_PATH` (the corpus file
- * itself, or a directory holding one), otherwise the nearest ancestor directory
- * holding `llms-full.txt`.
+ * itself, or a directory holding one), otherwise the recognized Honua package root
+ * holding `llms-full.txt`, or the SDK root beside mcp/ in a source checkout.
  *
  * The override names the file to read, so it is read — its basename is not
  * assumed to be `llms-full.txt`. Discarding it and reading `<parent>/llms-full.txt`

package/dist/src/tools/docs-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-search.d.ts","sourceRoot":"","sources":["../../../src/tools/docs-search.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmHxB,eAAO,MAAM,MAAM;;;;;;;;;;;;EAUjB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE3C,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,oBAAoB,EAAE,aAAa,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAe5D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAIpD;AAYD,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAgB7F;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAgB1F;AAED,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAkBrH;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvG;AAeD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAoBhF;AAcD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAepB;AAMD,wBAAsB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK;;;;;GA4D3D"}
+{"version":3,"file":"docs-search.d.ts","sourceRoot":"","sources":["../../../src/tools/docs-search.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmHxB,eAAO,MAAM,MAAM;;;;;;;;;;;;EAUjB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE3C,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,oBAAoB,EAAE,aAAa,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAe5D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAIpD;AAYD,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAgB7F;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAgB1F;AAED,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CA4BrH;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvG;AAeD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAoBhF;AAcD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAepB;AAMD,wBAAsB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK;;;;;GA4D3D"}

package/dist/src/tools/docs-search.js

@@ -204,8 +204,8 @@ export function excerptFor(document, queryTerms) {
 }
 /**
  * Locate the corpus: an explicit `HONUA_DOCS_CORPUS_PATH` (the corpus file
- * itself, or a directory holding one), otherwise the nearest ancestor directory
- * holding `llms-full.txt`.
+ * itself, or a directory holding one), otherwise the recognized Honua package root
+ * holding `llms-full.txt`, or the SDK root beside mcp/ in a source checkout.
  *
  * The override names the file to read, so it is read — its basename is not
  * assumed to be `llms-full.txt`. Discarding it and reading `<parent>/llms-full.txt`
@@ -226,8 +226,19 @@ export function resolveDocsCorpus(env = process.env, from) {
     let dir = from ?? path.dirname(fileURLToPath(import.meta.url));
     for (let depth = 0; depth < 10; depth += 1) {
         const corpusPath = path.join(dir, CORPUS_FILE);
-        if (fs.existsSync(corpusPath))
-            return { corpusPath, root: dir };
+        const pkg = readJson(path.join(dir, "package.json"));
+        if (pkg?.name === "@honua/mcp-server" || pkg?.name === "@honua/sdk-js") {
+            if (fs.existsSync(corpusPath))
+                return { corpusPath, root: dir };
+            // In a source checkout, mcp/ shares the SDK's corpus one level up.
+            const sdkRoot = path.dirname(dir);
+            if (pkg.name === "@honua/mcp-server" && readJson(path.join(sdkRoot, "package.json"))?.name === "@honua/sdk-js") {
+                const sdkCorpus = path.join(sdkRoot, CORPUS_FILE);
+                if (fs.existsSync(sdkCorpus))
+                    return { corpusPath: sdkCorpus, root: sdkRoot };
+            }
+            return undefined;
+        }
         const parent = path.dirname(dir);
         if (parent === dir)
             break;

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

@@ -10,6 +10,9 @@ import { z } from "zod";
  * WFS, and OData. The deprecated `serviceId` + `layerId` pair is still accepted.
  */
 export declare const schema: z.ZodObject<{
+    returnCountOnly: z.ZodOptional<z.ZodLiteral<false>>;
+    resultOffset: z.ZodOptional<z.ZodNumber>;
+    outSrid: z.ZodOptional<z.ZodNumber>;
     outFields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     orderBy: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodObject<{
         field: z.ZodString;
@@ -53,7 +56,7 @@ export declare const schema: z.ZodObject<{
     layout: z.ZodOptional<z.ZodEnum<["honua-facade", "ogc-api", "auto", "stac-api", "stac-static"]>>;
     serviceId: z.ZodOptional<z.ZodString>;
     layerId: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
+}, "strict", z.ZodTypeAny, {
     returnGeometry: boolean;
     filter?: import("../neutral/filter.js").FilterNode | undefined;
     serviceId?: string | undefined;
@@ -77,6 +80,9 @@ export declare const schema: z.ZodObject<{
     bboxSrid?: number | undefined;
     spatialRel?: "intersects" | "contains" | "within" | "crosses" | "touches" | "overlaps" | "bbox-intersects" | undefined;
     limit?: number | undefined;
+    returnCountOnly?: false | undefined;
+    resultOffset?: number | undefined;
+    outSrid?: number | undefined;
     outFields?: string[] | undefined;
     offset?: number | undefined;
     geometryFormat?: "geojson" | "esri-json" | undefined;
@@ -104,6 +110,9 @@ export declare const schema: z.ZodObject<{
     bboxSrid?: number | undefined;
     spatialRel?: "intersects" | "contains" | "within" | "crosses" | "touches" | "overlaps" | "bbox-intersects" | undefined;
     limit?: number | undefined;
+    returnCountOnly?: false | undefined;
+    resultOffset?: number | undefined;
+    outSrid?: number | undefined;
     outFields?: string[] | undefined;
     offset?: number | undefined;
     returnGeometry?: boolean | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"query-features.d.ts","sourceRoot":"","sources":["../../../src/tools/query-features.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIjB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE3C,wBAAsB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;;;GA0BpF"}
+{"version":3,"file":"query-features.d.ts","sourceRoot":"","sources":["../../../src/tools/query-features.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYR,CAAC;AAEZ,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE3C,wBAAsB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;;;GAiCpF"}

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

@@ -13,22 +13,34 @@ import { resolveSource, sourceRefFields } from "../neutral/source-ref.js";
  * same call means the same thing against GeoServices, OGC API Features, STAC,
  * WFS, and OData. The deprecated `serviceId` + `layerId` pair is still accepted.
  */
-export const schema = z.object({
+export const schema = z
+    .object({
     ...sourceRefFields,
     ...queryFilterFields,
     ...queryShapeFields,
-});
+    returnCountOnly: z
+        .literal(false)
+        .optional()
+        .describe("Only false is supported here; use honua_count_features for count-only requests."),
+    resultOffset: z.number().int().nonnegative().optional().describe("Standard alias for offset; pass only one."),
+    outSrid: z.number().int().optional().describe("Standard alias for outSr; pass only one."),
+})
+    .strict();
 export async function execute(client, input, signal) {
     return withCapabilityHonesty(async () => {
+        if (input.offset !== undefined && input.resultOffset !== undefined)
+            throw new Error("Pass either offset or resultOffset, not both.");
+        if (input.outSr !== undefined && input.outSrid !== undefined)
+            throw new Error("Pass either outSr or outSrid, not both.");
         const resolved = resolveSource(client, input);
-        const query = toQuery(input, { protocol: resolved.descriptor.protocol });
+        const query = toQuery({ ...input, offset: input.resultOffset ?? input.offset, outSr: input.outSrid ?? input.outSr }, { protocol: resolved.descriptor.protocol });
         query.signal = signal;
         const result = await resolved.source.query(query);
         // Legacy addressing keeps legacy output: a client that still sends
         // serviceId/layerId also still expects Esri-JSON geometry. Neutral
         // addressing gets the neutral encoding.
         const geometryFormat = input.geometryFormat ?? (resolved.legacyAddressing ? "esri-json" : "geojson");
-        const returnGeometry = input.returnGeometry ?? false;
+        const returnGeometry = input.returnGeometry ?? true;
         const degraded = projectDegraded(result.degraded);
         return jsonText({
             source: resolved.ref.ref,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honua/mcp-server",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "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.14"
+    "@honua/sdk-js": "^0.1.15"
   },
   "devDependencies": {
     "@biomejs/biome": "1.9.4",

package/release/zero-to-map/configs/claude-code.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "honua": {
       "command": "npx",
-      "args": ["-y", "--package", "@honua/mcp-server@0.1.12", "honua-mcp-proxy"],
+      "args": ["-y", "--package", "@honua/mcp-server@0.1.14", "honua-mcp-proxy"],
       "env": {
         "HONUA_MCP_REMOTE_URL": "http://localhost:8080/mcp"
       }

package/release/zero-to-map/configs/claude-desktop.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "honua": {
       "command": "npx",
-      "args": ["-y", "--package", "@honua/mcp-server@0.1.12", "honua-mcp-proxy"],
+      "args": ["-y", "--package", "@honua/mcp-server@0.1.14", "honua-mcp-proxy"],
       "env": {
         "HONUA_MCP_REMOTE_URL": "http://localhost:8080/mcp"
       }

package/release/zero-to-map/configs/cursor.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "honua": {
       "command": "npx",
-      "args": ["-y", "--package", "@honua/mcp-server@0.1.12", "honua-mcp-proxy"],
+      "args": ["-y", "--package", "@honua/mcp-server@0.1.14", "honua-mcp-proxy"],
       "env": {
         "HONUA_MCP_REMOTE_URL": "http://localhost:8080/mcp"
       }