@honua/mcp-server 0.0.20-alpha.0 → 0.1.0-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":"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;IAC7B;;;;;OAKG;IACH,+GAA+G;IAC/G,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,oHAAoH;IACpH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;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;IAC1D;;;;;OAKG;IACH,OAAO,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;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"}

package/dist/src/index.d.ts

@@ -13,11 +13,35 @@ 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): 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 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;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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,aAyF/C;AAMD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvF"}

package/dist/src/index.js

@@ -117,11 +117,25 @@ 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) {
     const server = new McpServer({
@@ -129,15 +143,15 @@ export function createServer(client) {
         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)));
     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 +159,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/provenance.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Self-proving provenance for certification & eval artifacts (A5 provability).
+ *
+ * A published report is only evidence if a reader can verify WHAT was tested and
+ * WITH WHICH code. Every artifact carries a `provenance` block naming the target
+ * surface, the negotiated MCP protocol version, the advertised tool count, the
+ * auth mode, the git SHA of the certification/eval suite, and a timestamp. That
+ * turns "we pass" into "here is the exact, reproducible run that passed".
+ */
+/** How the eval/cert authenticated to the surface (proves the run was authed). */
+export type AuthMode = "bearer" | "api-key" | "anonymous" | "none" | "unknown";
+/** The reproducibility fingerprint attached to every artifact. */
+export interface SuiteProvenance {
+    /** Git SHA of the certification/eval suite that produced this artifact. */
+    suiteGitSha: string;
+    /** Where the SHA came from (CI env, local git, or unresolved). */
+    suiteGitShaSource: "env" | "git" | "unknown";
+    /** Human-readable target surface / URL under test. */
+    targetUrl: string;
+    /** MCP protocol version negotiated with the surface, when observable. */
+    protocolVersion: string | null;
+    /** Number of tools the surface advertised. */
+    toolCount: number;
+    /** How the run authenticated to the surface. */
+    authMode: AuthMode;
+}
+/**
+ * Resolve the git SHA of the running suite. Prefers the CI-provided `GITHUB_SHA`
+ * (or an explicit `HONUA_SUITE_GIT_SHA` override), then falls back to
+ * `git rev-parse HEAD`, then to `"unknown"` so an artifact is always self-labeled
+ * even outside a git checkout.
+ */
+export declare function resolveSuiteGitSha(env?: NodeJS.ProcessEnv): {
+    sha: string;
+    source: SuiteProvenance["suiteGitShaSource"];
+};
+/**
+ * Read the negotiated MCP protocol version off a connected client, if its
+ * transport exposes one (the streamable-HTTP client transport does after
+ * `initialize`). Returns `null` for transports that do not surface it
+ * (stdio / in-memory), so the field is honest rather than fabricated.
+ */
+export declare function readNegotiatedProtocolVersion(client: unknown): string | null;
+//# sourceMappingURL=provenance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../../src/provenance.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,kFAAkF;AAClF,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/E,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,iBAAiB,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAC7C,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,eAAe,CAAC,mBAAmB,CAAC,CAAC;CAC9C,CAiBA;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI5E"}

package/dist/src/provenance.js

@@ -0,0 +1,37 @@
+import { execFileSync } from "node:child_process";
+/**
+ * Resolve the git SHA of the running suite. Prefers the CI-provided `GITHUB_SHA`
+ * (or an explicit `HONUA_SUITE_GIT_SHA` override), then falls back to
+ * `git rev-parse HEAD`, then to `"unknown"` so an artifact is always self-labeled
+ * even outside a git checkout.
+ */
+export function resolveSuiteGitSha(env = process.env) {
+    const fromEnv = (env.HONUA_SUITE_GIT_SHA ?? env.GITHUB_SHA ?? "").trim();
+    if (fromEnv.length > 0) {
+        return { sha: fromEnv, source: "env" };
+    }
+    try {
+        const sha = execFileSync("git", ["rev-parse", "HEAD"], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        if (sha.length > 0) {
+            return { sha, source: "git" };
+        }
+    }
+    catch {
+        // not a git checkout / git unavailable
+    }
+    return { sha: "unknown", source: "unknown" };
+}
+/**
+ * Read the negotiated MCP protocol version off a connected client, if its
+ * transport exposes one (the streamable-HTTP client transport does after
+ * `initialize`). Returns `null` for transports that do not surface it
+ * (stdio / in-memory), so the field is honest rather than fabricated.
+ */
+export function readNegotiatedProtocolVersion(client) {
+    const transport = client.transport;
+    const version = transport?.protocolVersion;
+    return typeof version === "string" && version.length > 0 ? version : null;
+}

package/dist/src/resources/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/resources/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,8DAA8D;AAC9D,eAAO,MAAM,GAAG,mBAAmB,CAAC;AAEpC,6EAA6E;AAC7E,eAAO,MAAM,WAAW,6BAA6B,CAAC;AAEtD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,WAAW;;;;;;GAiBpD;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;;;;;;GAY9D"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/resources/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAQjD,8DAA8D;AAC9D,eAAO,MAAM,GAAG,mBAAmB,CAAC;AAEpC,6EAA6E;AAC7E,eAAO,MAAM,WAAW,6BAA6B,CAAC;AAEtD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,WAAW;;;;;;GAyBpD;AAeD;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;;;;;;GAoB9D"}

package/dist/src/resources/styles.js

@@ -1,4 +1,7 @@
-import { listStyles, resolveStyleRef } from "../styles.js";
+import { CapabilityUnavailableError, capabilityUnavailablePayload } from "../capability.js";
+import { STYLE_SURFACE, listStyles, resolveStyleRef } from "../styles.js";
+const STYLE_GUIDANCE = "This target is a plain FeatureServer/OGC endpoint with no OGC API - Styles surface. " +
+    "Build a MapLibre style client-side, or point honua-mcp at a Honua deployment for managed styles.";
 /** URI for the styles catalog resource (`honua://styles`). */
 export const uri = "honua://styles";
 /** URI template for a single style resource (`honua://styles/{styleId}`). */
@@ -8,7 +11,16 @@ export const uriTemplate = "honua://styles/{styleId}";
  * with its stable styleId, title, and canonical URI (`honua://styles/{id}`).
  */
 export async function readCatalog(client) {
-    const list = await listStyles(client);
+    let list;
+    try {
+        list = await listStyles(client);
+    }
+    catch (err) {
+        if (err instanceof CapabilityUnavailableError) {
+            return unavailableContents(uri, err.reason);
+        }
+        throw err;
+    }
     const styles = list.styles.map((entry) => ({
         styleId: entry.id,
         title: entry.title ?? entry.id,
@@ -24,13 +36,34 @@ export async function readCatalog(client) {
         ],
     };
 }
+/** Structured "not available on this target" resource body (platform-free mode). */
+function unavailableContents(resourceUri, reason) {
+    return {
+        contents: [
+            {
+                uri: resourceUri,
+                mimeType: "application/json",
+                text: JSON.stringify(capabilityUnavailablePayload(STYLE_SURFACE, reason, STYLE_GUIDANCE), null, 2),
+            },
+        ],
+    };
+}
 /**
  * Read a single style as a `StyleRef` projection (style_id / title /
  * description / style_version / encodings / legend_url), resolved against the
  * server's `/ogc/styles/{styleId}` surface.
  */
 export async function read(client, styleId) {
-    const styleRef = await resolveStyleRef(client, styleId);
+    let styleRef;
+    try {
+        styleRef = await resolveStyleRef(client, styleId);
+    }
+    catch (err) {
+        if (err instanceof CapabilityUnavailableError) {
+            return unavailableContents(`honua://styles/${encodeURIComponent(styleId)}`, err.reason);
+        }
+        throw err;
+    }
     return {
         contents: [
             {

package/dist/src/styles.d.ts

@@ -1,4 +1,6 @@
 import type { HonuaClient } from "@honua/sdk-js";
+/** Human label for the Honua-only styling surface (capability degradation). */
+export declare const STYLE_SURFACE = "OGC API - Styles";
 /**
  * Thin read-only client over the server's OGC API – Styles surface
  * (honua-server, ADR-0048):

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

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AAEH,qEAAqE;AACrE,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,+EAA+E;AAC/E,eAAO,MAAM,yBAAyB,sCAAsC,CAAC;AAE7E,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,4CAA4C,CAAC;AAE3E,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,4CAA4C,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,eAAe,CAAC;AAE3D,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,eAAe,GAAG,MAAM,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAeD,mDAAmD;AACnD,wBAAsB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAoB3E;AAED,qEAAqE;AACrE,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGtG;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAElG;AASD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4B7F"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,+EAA+E;AAC/E,eAAO,MAAM,aAAa,qBAAqB,CAAC;AAEhD;;;;;;;;;;;;;;;;;GAiBG;AAEH,qEAAqE;AACrE,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,+EAA+E;AAC/E,eAAO,MAAM,yBAAyB,sCAAsC,CAAC;AAE7E,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,4CAA4C,CAAC;AAE3E,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,4CAA4C,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,eAAe,CAAC;AAE3D,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,eAAe,GAAG,MAAM,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAqCD,mDAAmD;AACnD,wBAAsB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAuB3E;AAED,qEAAqE;AACrE,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGtG;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAElG;AASD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4B7F"}

package/dist/src/styles.js

@@ -1,3 +1,6 @@
+import { CapabilityUnavailableError } from "./capability.js";
+/** Human label for the Honua-only styling surface (capability degradation). */
+export const STYLE_SURFACE = "OGC API - Styles";
 /**
  * Thin read-only client over the server's OGC API – Styles surface
  * (honua-server, ADR-0048):
@@ -38,8 +41,28 @@ function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 async function getJson(client, path, accept) {
-    const response = await client.pipelineFetch("GET", path, { headers: { Accept: accept } });
-    return (await response.json());
+    let response;
+    try {
+        response = await client.pipelineFetch("GET", path, { headers: { Accept: accept } });
+    }
+    catch (err) {
+        // A plain FeatureServer / OGC-Features endpoint has no styling surface, so
+        // `GET /ogc/styles*` fails (404, network error, or the SDK's non-2xx throw).
+        // Degrade gracefully rather than surfacing a raw crash.
+        throw new CapabilityUnavailableError(STYLE_SURFACE, `request to ${path} failed: ${errorMessage(err)}`);
+    }
+    if (!response.ok) {
+        throw new CapabilityUnavailableError(STYLE_SURFACE, `${path} returned HTTP ${response.status}`);
+    }
+    try {
+        return (await response.json());
+    }
+    catch {
+        throw new CapabilityUnavailableError(STYLE_SURFACE, `${path} did not return JSON (target has no OGC API - Styles surface)`);
+    }
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
 }
 function stylePath(styleId) {
     return `${OGC_STYLES_PATH}/${encodeURIComponent(styleId)}`;
@@ -48,7 +71,10 @@ function stylePath(styleId) {
 export async function listStyles(client) {
     const body = await getJson(client, OGC_STYLES_PATH, "application/json");
     if (!isRecord(body) || !Array.isArray(body.styles)) {
-        return { styles: [] };
+        // A well-formed styles document always carries a `styles` array (possibly
+        // empty). Anything else means the target is not an OGC API - Styles surface;
+        // report that honestly instead of returning a misleading empty catalog.
+        throw new CapabilityUnavailableError(STYLE_SURFACE, `${OGC_STYLES_PATH} response is not a styles document`);
     }
     const styles = [];
     for (const entry of body.styles) {

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;AAIxB,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;;;;;GAa9D"}
+{"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"}

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

@@ -1,6 +1,9 @@
 import { z } from "zod";
+import { CapabilityUnavailableError, capabilityUnavailable } from "../capability.js";
 import { jsonText } from "../helpers.js";
-import { resolveStyleRef } from "../styles.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({
     styleId: z.string().describe("Stable style identifier of the preset to resolve."),
 });
@@ -18,7 +21,16 @@ export async function execute(client, input) {
     // `resolveStyleRef` already fetches the MapLibre stylesheet and inlines it on
     // the `mapbox-style` encoding, so reuse that body instead of issuing a second
     // identical GET /ogc/styles/{id}.
-    const styleRef = await resolveStyleRef(client, input.styleId);
+    let styleRef;
+    try {
+        styleRef = await resolveStyleRef(client, input.styleId);
+    }
+    catch (err) {
+        if (err instanceof CapabilityUnavailableError) {
+            return capabilityUnavailable(STYLE_SURFACE, err.reason, STYLE_GUIDANCE);
+        }
+        throw err;
+    }
     const stylesheet = styleRef.encodings.find((e) => e.encoding === "mapbox-style")?.inlineBody ?? null;
     return jsonText({
         style: styleRef,

package/dist/src/tools/get-style.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-style.d.ts","sourceRoot":"","sources":["../../../src/tools/get-style.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,MAAM;;;;;;EAEjB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK;;;;;GAe9D"}
+{"version":3,"file":"get-style.d.ts","sourceRoot":"","sources":["../../../src/tools/get-style.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;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK;;;;;GAsB9D"}

package/dist/src/tools/get-style.js

@@ -1,6 +1,9 @@
 import { z } from "zod";
+import { CapabilityUnavailableError, capabilityUnavailable } from "../capability.js";
 import { jsonText } from "../helpers.js";
-import { listStyles, resolveStyleRef } from "../styles.js";
+import { STYLE_SURFACE, listStyles, resolveStyleRef } from "../styles.js";
+const STYLE_GUIDANCE = "This target is a plain FeatureServer/OGC endpoint with no server-side style catalog. " +
+    "Query features and build a MapLibre style client-side, or point honua-mcp at a Honua deployment for managed styles.";
 export const schema = z.object({
     styleId: z.string().optional().describe("Stable style identifier. Omit to list the styles available on the server."),
 });
@@ -12,17 +15,25 @@ export const schema = z.object({
  * is available.
  */
 export async function execute(client, input) {
-    if (!input.styleId) {
-        const list = await listStyles(client);
-        return jsonText({
-            styles: list.styles.map((entry) => ({
-                styleId: entry.id,
-                title: entry.title ?? entry.id,
-                uri: `honua://styles/${encodeURIComponent(entry.id)}`,
-            })),
-            default: list.default ?? null,
-        });
+    try {
+        if (!input.styleId) {
+            const list = await listStyles(client);
+            return jsonText({
+                styles: list.styles.map((entry) => ({
+                    styleId: entry.id,
+                    title: entry.title ?? entry.id,
+                    uri: `honua://styles/${encodeURIComponent(entry.id)}`,
+                })),
+                default: list.default ?? null,
+            });
+        }
+        const styleRef = await resolveStyleRef(client, input.styleId);
+        return jsonText(styleRef);
+    }
+    catch (err) {
+        if (err instanceof CapabilityUnavailableError) {
+            return capabilityUnavailable(STYLE_SURFACE, err.reason, STYLE_GUIDANCE);
+        }
+        throw err;
     }
-    const styleRef = await resolveStyleRef(client, input.styleId);
-    return jsonText(styleRef);
 }

package/dist/src/tools/list-services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-services.d.ts","sourceRoot":"","sources":["../../../src/tools/list-services.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,MAAM;;;;;;EAQjB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAI3C,wBAAsB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK;;;;;GAgC9D"}
+{"version":3,"file":"list-services.d.ts","sourceRoot":"","sources":["../../../src/tools/list-services.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,MAAM;;;;;;EAQjB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAI3C,wBAAsB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK;;;;;GA+C9D"}

package/dist/src/tools/list-services.js

@@ -9,7 +9,22 @@ export const schema = z.object({
 });
 const METADATA_CONCURRENCY = 8;
 export async function execute(client, input) {
-    const response = await client.listServices();
+    let response;
+    try {
+        response = await client.listServices();
+    }
+    catch (err) {
+        // Some targets expose no service catalog at `/rest/services` — e.g. a base
+        // URL pointed straight at a single FeatureServer, or an OGC-only endpoint.
+        // Degrade to a structured note instead of crashing: the agent can still
+        // describe/query a known service+layer directly.
+        return jsonText({
+            catalogAvailable: false,
+            services: [],
+            reason: `service catalog is not available on this target: ${err instanceof Error ? err.message : String(err)}`,
+            guidance: "No /rest/services directory here. Call honua_describe_layer / honua_query_features with a known serviceId and layerId, or point the base URL at an ArcGIS folder that lists services.",
+        });
+    }
     const services = (response.services ?? []).filter((s) => s.type === "FeatureServer");
     if (!input.includeDetails) {
         return jsonText(services.map((s) => ({ serviceId: s.name, type: s.type })));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honua/mcp-server",
-  "version": "0.0.20-alpha.0",
+  "version": "0.1.0-beta.0",
   "description": "MCP server for Honua geospatial feature services",
   "type": "module",
   "bin": {
@@ -16,11 +16,15 @@
     "test:unit": "vitest run",
     "test:coverage": "vitest run --coverage",
     "certify": "npm run build --silent && node dist/src/certification/cli.js",
+    "certify:standalone": "npm run build --silent && node dist/src/certification/cli.js --target standalone",
     "test:certification": "npm run build --silent && vitest run test/certification && node dist/src/certification/cli.js",
     "test:certification:artifact": "npm run build --silent && node dist/src/certification/cli.js --artifact-only",
+    "test:certification:standalone": "npm run build --silent && node dist/src/certification/cli.js --target standalone",
     "eval": "npm run build --silent && node dist/src/eval/cli.js",
     "eval:offline": "npm run build --silent && node dist/src/eval/cli.js --offline",
+    "eval:standalone": "npm run build --silent && node dist/src/eval/cli.js --corpus standalone --offline",
     "eval:live": "npm run build --silent && node dist/src/eval/cli.js --corpus operator --artifact-only",
+    "leaderboard": "node scripts/render-leaderboard.mjs",
     "test:eval": "npm run build --silent && vitest run test/eval && node dist/src/eval/cli.js --offline",
     "test:eval:artifact": "npm run build --silent && node dist/src/eval/cli.js --artifact-only",
     "lint": "biome lint src/ test/",
@@ -40,7 +44,7 @@
     "hono": "^4.12.21"
   },
   "peerDependencies": {
-    "@honua/sdk-js": "^0.0.20-alpha.0"
+    "@honua/sdk-js": "^0.1.0-beta.0"
   },
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
@@ -57,5 +61,10 @@
   ],
   "engines": {
     "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/honua-io/honua-sdk-js.git",
+    "directory": "mcp"
   }
 }