@honua/mcp-server 0.0.20-alpha.0 → 0.1.1-beta.0

package/dist/src/eval/types.d.ts

@@ -53,6 +53,22 @@ export interface SuccessCriteria {
     forbiddenTools?: string[];
     /** Case-insensitive substrings the final answer must contain. */
     answerMustInclude?: string[];
+    /**
+     * SEMANTIC assertions (issue #369) — grade the MEANING of the answer, not just
+     * the tool trajectory. Ride on the deterministic control against grounded
+     * fixtures (known feature counts, known geographic facts), so a wrong number or
+     * a hallucinated place name fails the scenario.
+     */
+    /** Case-insensitive substrings the final answer must NOT contain (anti-hallucination / wrong-answer guard). */
+    answerMustNotInclude?: string[];
+    /** Regular-expression sources the final answer must ALL match (case-insensitive) — exact numeric / value checks. */
+    answerMustMatch?: string[];
+    /**
+     * The prompt is deliberately ambiguous or unsupported: a correct client asks a
+     * clarifying question (or refuses) instead of guessing. When true, a `clarified`
+     * transcript grades as `pass` and a completed transcript grades as `fail`.
+     */
+    expectClarification?: boolean;
 }
 /** One GIS workflow in the held-out corpus. */
 export interface Scenario {
@@ -70,6 +86,15 @@ export interface Scenario {
         tool: string;
         args: Record<string, unknown>;
     }[];
+    /**
+     * Ambiguity/refusal scenarios: the deterministic driver asks this clarifying
+     * question INSTEAD of running the script (an empty script is typical). Live LLM
+     * drivers decide for themselves whether to clarify from the prompt alone. Pair
+     * with `criteria.expectClarification: true`.
+     */
+    clarify?: {
+        question: string;
+    };
 }
 /** Per-scenario grade for one model. */
 export type GradeOutcome = "pass" | "fail" | "clarified" | "error";

package/dist/src/eval/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/eval/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAChF;AAED,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,sBAAsB,EAAE,OAAO,CAAC;IAChC,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,+CAA+C;AAC/C,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;OAGG;IACH,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,CAAC;CAC3D;AAED,wCAAwC;AACxC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,qDAAqD;IACrD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAC;IACtE,gEAAgE;IAChE,WAAW,IAAI,OAAO,CAAC;IACvB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACpF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/eval/types.ts"],"names":[],"mappings":"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"}

package/dist/src/helpers.d.ts

@@ -1,4 +1,4 @@
-import type { EsriGeometryType, EsriSpatialRel } from "@honua/sdk-js";
+import type { EsriGeometryType, EsriSpatialRel } from "@honua/sdk-js/honua";
 export declare const GEOMETRY_TYPES: readonly ["esriGeometryPoint", "esriGeometryPolyline", "esriGeometryPolygon", "esriGeometryEnvelope", "esriGeometryMultipoint"];
 export declare function mapSpatialRel(rel: string | undefined): EsriSpatialRel | undefined;
 export declare function clampLimit(limit: number | undefined): number;

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAMtE,eAAO,MAAM,cAAc,iIAMjB,CAAC;AAQX,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAKjF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG5D;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7C,YAAY,EAAE,gBAAgB,GAAG,SAAS,GACzC,gBAAgB,GAAG,SAAS,CA8B9B;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAE5F;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAWvE;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC3C,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,CAAC,EAAE,CAAC,CAqBd"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM5E,eAAO,MAAM,cAAc,iIAMjB,CAAC;AAQX,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAKjF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG5D;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7C,YAAY,EAAE,gBAAgB,GAAG,SAAS,GACzC,gBAAgB,GAAG,SAAS,CA8B9B;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAE5F;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAWvE;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC3C,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,CAAC,EAAE,CAAC,CAqBd"}

package/dist/src/index.d.ts

@@ -2,6 +2,9 @@
 import { HonuaClient } from "@honua/sdk-js";
 import type { HonuaTransport } from "@honua/sdk-js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type NlMapControlMcpHost } from "./nl-map-control.js";
+export { createNlMapControlMcpHost, registerNlMapControlMcpTools, } from "./nl-map-control.js";
+export type { CreateNlMapControlMcpHostOptions, McpNlMapExecutionResponse, McpNlMapPlanResponse, McpNlMapReceipt, NlMapControlMcpHost, NlMapControlMcpRequestContext, } from "./nl-map-control.js";
 export interface RuntimeOptions {
     baseUrl: string;
     apiKey: string | undefined;
@@ -9,15 +12,43 @@ export interface RuntimeOptions {
     timeoutMs: number;
     retryMaxRetries: number;
 }
+export interface CreateServerOptions {
+    /** Optional BYO-LLM/map-runtime host for the experimental NL map-plan tools. */
+    readonly nlMapControl?: NlMapControlMcpHost;
+}
 export declare const SERVER_VERSION: string;
 export declare function resolveRuntimeOptions(env: NodeJS.ProcessEnv): RuntimeOptions;
 export declare function createClientFromEnv(env?: NodeJS.ProcessEnv): HonuaClient;
 /**
- * @deprecated Static, hand-maintained 9-tool MCP server. This is NO LONGER the
- * product surface and is NOT on the certification trust path — the honua-server
- * `/mcp` catalog is the source of truth, mirrored to stdio by `honua-mcp-proxy`
- * (see {@link runProxy}). `createServer` is retained ONLY as a labeled offline
- * test fixture (proxy parity harness). Do not ship it as the operator surface.
+ * The PLATFORM-FREE standalone MCP surface (issue #369).
+ *
+ * This is the direct-SDK operator surface: nine read-only geospatial tools wired
+ * straight onto `@honua/sdk-js`, which speaks plain Esri GeoServices / OGC API
+ * over standard REST paths (`/rest/services`, `/FeatureServer/{id}/query`, …).
+ * Point it at ANY public FeatureServer / OGC endpoint (e.g. a `services.arcgis.com`
+ * FeatureServer) with ZERO Honua-server assumptions — no admin API, no `/healthz`,
+ * no `/mcp` catalog. This is what the `honua-mcp` bin runs (see {@link runStandalone}),
+ * and what the platform-free certification lane + eval corpus exercise.
+ *
+ * Tools that need a Honua-only surface (server-side styling via OGC API – Styles,
+ * a `/rest/services` catalog) degrade gracefully on a plain target: they return a
+ * structured "not available on this target" result rather than crashing or
+ * returning misleading empty data (see `capability.ts`).
+ *
+ * The Honua-ENHANCED surface — the full `/mcp` operator catalog with governed
+ * mutation, jobs, and publishing — is a superset reached over streamable-HTTP and
+ * mirrored to stdio by `honua-mcp-proxy` ({@link runProxy}); it requires a Honua
+ * deployment. Standalone is the front door; the proxy is the upgrade path.
+ */
+export declare function createServer(client: HonuaClient, options?: CreateServerOptions): McpServer;
+/**
+ * Run the platform-free standalone server end-to-end over stdio.
+ *
+ * Builds a `HonuaClient` from the environment (`HONUA_BASE_URL` + optional
+ * transport/auth) and exposes {@link createServer} — the nine read-only tools —
+ * to a stdio MCP client (Claude Desktop / Claude Code / any MCP agent). Point
+ * `HONUA_BASE_URL` at any public FeatureServer/OGC endpoint; no Honua server is
+ * required. For the Honua-enhanced `/mcp` catalog, use `honua-mcp-proxy` instead.
  */
-export declare function createServer(client: HonuaClient): McpServer;
+export declare function runStandalone(env?: NodeJS.ProcessEnv): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"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;AAgBtF,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;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;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,aAyF/C"}
+{"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;AAGtF,OAAO,EAAE,KAAK,mBAAmB,EAAgC,MAAM,qBAAqB,CAAC;AAc7F,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,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;CAC7C;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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,mBAAwB,aA6FlF;AAMD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvF"}

package/dist/src/index.js

@@ -4,6 +4,7 @@ import { fileURLToPath } from "node:url";
 import { HonuaClient } from "@honua/sdk-js";
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerNlMapControlMcpTools } from "./nl-map-control.js";
 import * as layerSchemaResource from "./resources/layer-schema.js";
 import * as servicesResource from "./resources/services.js";
 import * as stylesResource from "./resources/styles.js";
@@ -16,6 +17,7 @@ import * as getStyle from "./tools/get-style.js";
 import * as listServices from "./tools/list-services.js";
 import * as queryFeatures from "./tools/query-features.js";
 import * as statistics from "./tools/statistics.js";
+export { createNlMapControlMcpHost, registerNlMapControlMcpTools, } from "./nl-map-control.js";
 const DEFAULT_TIMEOUT_MS = 30_000;
 const DEFAULT_MAX_RETRIES = 2;
 const DEFAULT_SERVER_VERSION = "0.0.3-alpha.0";
@@ -117,27 +119,44 @@ export function createClientFromEnv(env = process.env) {
     });
 }
 /**
- * @deprecated Static, hand-maintained 9-tool MCP server. This is NO LONGER the
- * product surface and is NOT on the certification trust path — the honua-server
- * `/mcp` catalog is the source of truth, mirrored to stdio by `honua-mcp-proxy`
- * (see {@link runProxy}). `createServer` is retained ONLY as a labeled offline
- * test fixture (proxy parity harness). Do not ship it as the operator surface.
+ * The PLATFORM-FREE standalone MCP surface (issue #369).
+ *
+ * This is the direct-SDK operator surface: nine read-only geospatial tools wired
+ * straight onto `@honua/sdk-js`, which speaks plain Esri GeoServices / OGC API
+ * over standard REST paths (`/rest/services`, `/FeatureServer/{id}/query`, …).
+ * Point it at ANY public FeatureServer / OGC endpoint (e.g. a `services.arcgis.com`
+ * FeatureServer) with ZERO Honua-server assumptions — no admin API, no `/healthz`,
+ * no `/mcp` catalog. This is what the `honua-mcp` bin runs (see {@link runStandalone}),
+ * and what the platform-free certification lane + eval corpus exercise.
+ *
+ * Tools that need a Honua-only surface (server-side styling via OGC API – Styles,
+ * a `/rest/services` catalog) degrade gracefully on a plain target: they return a
+ * structured "not available on this target" result rather than crashing or
+ * returning misleading empty data (see `capability.ts`).
+ *
+ * The Honua-ENHANCED surface — the full `/mcp` operator catalog with governed
+ * mutation, jobs, and publishing — is a superset reached over streamable-HTTP and
+ * mirrored to stdio by `honua-mcp-proxy` ({@link runProxy}); it requires a Honua
+ * deployment. Standalone is the front door; the proxy is the upgrade path.
  */
-export function createServer(client) {
+export function createServer(client, options = {}) {
     const server = new McpServer({
         name: "honua",
         version: SERVER_VERSION,
     });
     // ── Tools ──────────────────────────────────────────────────────
-    server.tool("honua_list_services", "Discover all available feature services. Set includeDetails=true for descriptions, layer counts, and spatial references.", listServices.schema.shape, async (args) => listServices.execute(client, listServices.schema.parse(args)));
+    server.tool("honua_list_services", "Discover all available feature services on any FeatureServer folder. Set includeDetails=true for descriptions, layer counts, and spatial references. Degrades gracefully when the target has no service catalog.", listServices.schema.shape, async (args) => listServices.execute(client, listServices.schema.parse(args)));
+    if (options.nlMapControl) {
+        registerNlMapControlMcpTools(server, options.nlMapControl);
+    }
     server.tool("honua_describe_layer", "Get full schema for a layer — fields, geometry type, extent, relationships.", describeLayer.schema.shape, async (args) => describeLayer.execute(client, describeLayer.schema.parse(args)));
     server.tool("honua_query_features", "Query features with attribute filters, spatial filters, field selection, and pagination. returnGeometry defaults to false to save tokens.", queryFeatures.schema.shape, async (args) => queryFeatures.execute(client, queryFeatures.schema.parse(args)));
     server.tool("honua_count_features", "Count features matching a filter without returning data. Use before querying to check cardinality.", countFeatures.schema.shape, async (args) => countFeatures.execute(client, countFeatures.schema.parse(args)));
     server.tool("honua_get_extent", "Get the spatial bounding box of features matching a filter.", getExtent.schema.shape, async (args) => getExtent.execute(client, getExtent.schema.parse(args)));
     server.tool("honua_statistics", "Compute aggregate statistics (count, sum, avg, min, max, stddev) on a field, optionally grouped.", statistics.schema.shape, async (args) => statistics.execute(client, statistics.schema.parse(args)));
-    server.tool("honua_explain_capability_gap", "Explain whether a Honua 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 the 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.", 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.", applyStylePreset.schema.shape, async (args) => applyStylePreset.execute(client, applyStylePreset.schema.parse(args)));
+    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)));
     // ── Resources ──────────────────────────────────────────────────
     server.resource("services-catalog", servicesResource.uri, async (uri) => servicesResource.read(client));
     server.resource("layer-schema", new ResourceTemplate(layerSchemaResource.uriTemplate, { list: undefined }), async (uri, params) => layerSchemaResource.read(client, params.encodedServiceId, params.layerId));
@@ -145,22 +164,28 @@ export function createServer(client) {
     server.resource("style", new ResourceTemplate(stylesResource.uriTemplate, { list: undefined }), async (uri, params) => stylesResource.read(client, params.styleId));
     return server;
 }
-/* v8 ignore start -- deprecated bin entry: delegates to the dynamic proxy at
-   runtime; the proxy's logic is unit-tested in proxy.test.ts. */
+/* v8 ignore start -- live-process entry: wires the stdio transport to a real
+   SDK client against HONUA_BASE_URL; exercised by running the bin, not unit tests.
+   The unit-testable logic (option resolution, client construction, server wiring)
+   lives in the exported functions above and is covered there. */
 /**
- * Deprecated `honua-mcp` bin entry.
+ * Run the platform-free standalone server end-to-end over stdio.
  *
- * The static 9-tool server has been retired from the product/trust path. This
- * bin now prints a deprecation notice and launches the dynamic proxy
- * (`honua-mcp-proxy`), which mirrors the honua-server `/mcp` catalog. It
- * therefore requires `HONUA_MCP_REMOTE_URL` (the remote `/mcp` endpoint) instead
- * of the old `HONUA_BASE_URL`.
+ * Builds a `HonuaClient` from the environment (`HONUA_BASE_URL` + optional
+ * transport/auth) and exposes {@link createServer} — the nine read-only tools —
+ * to a stdio MCP client (Claude Desktop / Claude Code / any MCP agent). Point
+ * `HONUA_BASE_URL` at any public FeatureServer/OGC endpoint; no Honua server is
+ * required. For the Honua-enhanced `/mcp` catalog, use `honua-mcp-proxy` instead.
  */
+export async function runStandalone(env = process.env) {
+    const client = createClientFromEnv(env);
+    const server = createServer(client);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+/** `honua-mcp` bin entry — the platform-free standalone server. */
 async function main() {
-    process.stderr.write("DEPRECATION: `honua-mcp` is deprecated and now proxies the honua-server /mcp catalog. " +
-        "Use `honua-mcp-proxy` directly. Set HONUA_MCP_REMOTE_URL to the remote /mcp endpoint.\n");
-    const { runProxy } = await import("./proxy.js");
-    await runProxy();
+    await runStandalone();
 }
 if (process.argv[1] === fileURLToPath(import.meta.url)) {
     main().catch((err) => {

package/dist/src/nl-map-control.d.ts

@@ -0,0 +1,70 @@
+import { type AgentApprovalUseConsumer } from "@honua/sdk-js/agent-safety";
+import { type CreateNlMapControlOptions, NL_MAP_CONTROL_VERSION, type NlMapControl, type NlMapPlan, type NlMapPlanExecution } from "@honua/sdk-js/nl-map-control";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+declare const MCP_NL_MAP_RECEIPT_KIND: "honua.mcp-nl-map-receipt";
+export interface NlMapControlMcpRequestContext {
+    readonly signal?: AbortSignal;
+    /** Scopes authenticated by the MCP transport. Caller arguments never populate this field. */
+    readonly transportAuthorizationScopes?: readonly string[];
+}
+export interface CreateNlMapControlMcpHostOptions {
+    /** The identical controller configuration used by the in-app NL surface. */
+    readonly control: CreateNlMapControlOptions;
+    /** Atomic, host-authenticated approval-use store. Required for every approved MCP execution. */
+    readonly approvalUseConsumer: AgentApprovalUseConsumer;
+    /**
+     * Resolve trusted scopes for transports without MCP `authInfo` (for example an
+     * embedded stdio host). The input contains transport-authenticated scopes only.
+     */
+    readonly resolveAuthorizationScopes?: (transportScopes: readonly string[]) => readonly string[] | Promise<readonly string[]>;
+}
+export interface McpNlMapPlanResponse {
+    readonly plan: NlMapPlan;
+    readonly approvalRequired: boolean;
+}
+export interface McpNlMapReceipt {
+    readonly kind: typeof MCP_NL_MAP_RECEIPT_KIND;
+    readonly version: typeof NL_MAP_CONTROL_VERSION;
+    readonly id: string;
+    readonly planId: string;
+    readonly planFingerprint: `sha256:${string}`;
+    readonly mode: NlMapPlanExecution["mode"];
+    readonly outcome: NlMapPlanExecution["outcome"];
+    readonly approvalDigest?: `sha256:${string}`;
+    readonly startedAt: string;
+    readonly completedAt: string;
+    readonly steps: NlMapPlanExecution["receipt"]["steps"];
+    /** Digest of the SDK receipt retained by the host. Its raw instruction is never returned over MCP. */
+    readonly sdkReceiptDigest: `sha256:${string}`;
+    readonly receiptDigest: `sha256:${string}`;
+}
+export interface McpNlMapExecutionResponse {
+    readonly planId: string;
+    readonly planFingerprint: `sha256:${string}`;
+    readonly mode: NlMapPlanExecution["mode"];
+    readonly outcome: NlMapPlanExecution["outcome"];
+    readonly receipt: McpNlMapReceipt;
+}
+export interface NlMapControlMcpHost {
+    readonly control: NlMapControl;
+    propose(input: {
+        readonly instruction: string;
+    }, context?: NlMapControlMcpRequestContext): Promise<McpNlMapPlanResponse>;
+    execute(input: {
+        readonly plan: unknown;
+        readonly approval?: unknown;
+    }, context?: NlMapControlMcpRequestContext): Promise<McpNlMapExecutionResponse>;
+}
+/**
+ * Bind the experimental NL map controller to the MCP trust boundary.
+ *
+ * The host pre-authorizes and atomically consumes every approved step before
+ * delegating to `createNlMapControl`. This preserves the SDK's exact plan and
+ * signature checks while preventing approval replay through a second transport
+ * call. No caller-provided credential or cursor is included in MCP output.
+ */
+export declare function createNlMapControlMcpHost(options: CreateNlMapControlMcpHostOptions): NlMapControlMcpHost;
+/** Register `proposeMapPlan` and `executeMapPlan` on a real MCP server. */
+export declare function registerNlMapControlMcpTools(server: McpServer, host: NlMapControlMcpHost): void;
+export {};
+//# sourceMappingURL=nl-map-control.d.ts.map

package/dist/src/nl-map-control.d.ts.map

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