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

package/dist/src/stable-json.js

@@ -0,0 +1,126 @@
+const MAX_NODES = 8_192;
+const MAX_DEPTH = 32;
+const MAX_BYTES = 1_048_576;
+const MAX_OBJECT_PROPERTIES = 128;
+const MAX_ARRAY_LENGTH = 1_024;
+const MAX_STRING_CODE_UNITS = 65_536;
+const SNAPSHOT_ERRORS = new WeakSet();
+/** Stable boundary error whose message never includes a reflected value or trap error. */
+export class McpJsonSnapshotError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "McpJsonSnapshotError";
+        SNAPSHOT_ERRORS.add(this);
+    }
+}
+/**
+ * Detach untrusted JSON without invoking property getters.
+ *
+ * The clone is deeply frozen and bounded before any asynchronous authorization
+ * callback can observe it. Reflection failures (including Proxy traps) collapse
+ * to one stable error instead of reflecting attacker-controlled messages.
+ */
+export function snapshotMcpJson(input, label) {
+    try {
+        return snapshot(input, 0, new WeakSet(), { nodes: 0, bytes: 0 });
+    }
+    catch (error) {
+        if (error !== null && typeof error === "object" && SNAPSHOT_ERRORS.has(error))
+            throw error;
+        throw new McpJsonSnapshotError(`${label} could not be safely snapshotted`);
+    }
+}
+function snapshot(value, depth, ancestors, budget) {
+    budget.nodes += 1;
+    if (budget.nodes > MAX_NODES)
+        invalid("MCP JSON exceeds the node limit");
+    if (depth > MAX_DEPTH)
+        invalid("MCP JSON exceeds the depth limit");
+    addBytes(budget, 8);
+    if (value === null || typeof value === "boolean")
+        return value;
+    if (typeof value === "string") {
+        if (value.length > MAX_STRING_CODE_UNITS)
+            invalid("MCP JSON contains an oversized string");
+        addBytes(budget, utf8Bytes(value));
+        return value;
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            invalid("MCP JSON contains a non-finite number");
+        return Object.is(value, -0) ? 0 : value;
+    }
+    if (typeof value !== "object")
+        invalid("MCP JSON contains an unsupported value");
+    if (ancestors.has(value))
+        invalid("MCP JSON must not contain cycles");
+    ancestors.add(value);
+    const result = Array.isArray(value)
+        ? snapshotArray(value, depth, ancestors, budget)
+        : snapshotObject(value, depth, ancestors, budget);
+    ancestors.delete(value);
+    return result;
+}
+function snapshotArray(input, depth, ancestors, budget) {
+    if (Object.getPrototypeOf(input) !== Array.prototype)
+        invalid("MCP JSON arrays must use the standard prototype");
+    const lengthDescriptor = Reflect.getOwnPropertyDescriptor(input, "length");
+    const length = lengthDescriptor && "value" in lengthDescriptor ? lengthDescriptor.value : undefined;
+    if (!Number.isSafeInteger(length) || length < 0 || length > MAX_ARRAY_LENGTH) {
+        invalid("MCP JSON contains an invalid or oversized array");
+    }
+    const keys = Reflect.ownKeys(input);
+    if (keys.some((key) => typeof key !== "string"))
+        invalid("MCP JSON must not contain symbol keys");
+    if (keys.length !== length + 1 || !keys.includes("length")) {
+        invalid("MCP JSON arrays must be dense and must not contain extra properties");
+    }
+    const output = [];
+    for (let index = 0; index < length; index += 1) {
+        const descriptor = Reflect.getOwnPropertyDescriptor(input, String(index));
+        if (!descriptor || !("value" in descriptor) || !descriptor.enumerable) {
+            invalid("MCP JSON arrays must contain enumerable data properties");
+        }
+        output.push(snapshot(descriptor.value, depth + 1, ancestors, budget));
+    }
+    return Object.freeze(output);
+}
+function snapshotObject(input, depth, ancestors, budget) {
+    const prototype = Object.getPrototypeOf(input);
+    if (prototype !== Object.prototype && prototype !== null)
+        invalid("MCP JSON values must be plain objects");
+    const keys = Reflect.ownKeys(input);
+    if (keys.length > MAX_OBJECT_PROPERTIES)
+        invalid("MCP JSON object exceeds the property limit");
+    if (keys.some((key) => typeof key !== "string"))
+        invalid("MCP JSON must not contain symbol keys");
+    const output = Object.create(null);
+    for (const key of keys.sort()) {
+        if (key.length > MAX_STRING_CODE_UNITS)
+            invalid("MCP JSON contains an oversized property name");
+        addBytes(budget, utf8Bytes(key));
+        const descriptor = Reflect.getOwnPropertyDescriptor(input, key);
+        if (!descriptor || !("value" in descriptor) || !descriptor.enumerable) {
+            invalid("MCP JSON objects must contain enumerable data properties");
+        }
+        Object.defineProperty(output, key, {
+            value: snapshot(descriptor.value, depth + 1, ancestors, budget),
+            enumerable: true,
+            writable: false,
+            configurable: false,
+        });
+    }
+    return Object.freeze(output);
+}
+function addBytes(budget, increment) {
+    const next = budget.bytes + increment;
+    if (!Number.isSafeInteger(next) || next > MAX_BYTES)
+        invalid("MCP JSON exceeds the byte limit");
+    budget.bytes = next;
+}
+function utf8Bytes(value) {
+    return new TextEncoder().encode(value).byteLength;
+}
+function invalid(message) {
+    throw new McpJsonSnapshotError(message);
+}

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/explain-capability-gap.d.ts

@@ -1,4 +1,4 @@
-import { type Capability, type Protocol } from "@honua/sdk-js";
+import type { Capability, Protocol } from "@honua/sdk-js";
 import { z } from "zod";
 export declare const schema: z.ZodObject<{
     capability: z.ZodEffects<z.ZodString, Capability, string>;
@@ -7,13 +7,13 @@ export declare const schema: z.ZodObject<{
     declaredCapabilities: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, Capability, string>, "many">>;
 }, "strip", z.ZodTypeAny, {
     capability: Capability;
-    protocol?: Protocol | undefined;
     sourceId?: string | undefined;
+    protocol?: Protocol | undefined;
     declaredCapabilities?: Capability[] | undefined;
 }, {
     capability: string;
-    protocol?: string | undefined;
     sourceId?: string | undefined;
+    protocol?: string | undefined;
     declaredCapabilities?: string[] | undefined;
 }>;
 export type Input = z.infer<typeof schema>;

package/dist/src/tools/explain-capability-gap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explain-capability-gap.d.ts","sourceRoot":"","sources":["../../../src/tools/explain-capability-gap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAa,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAExF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;EAKjB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE3C,wBAAsB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK;;;;;GAI3D"}
+{"version":3,"file":"explain-capability-gap.d.ts","sourceRoot":"","sources":["../../../src/tools/explain-capability-gap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;EAKjB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE3C,wBAAsB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK;;;;;GAI3D"}

package/dist/src/tools/explain-capability-gap.js

@@ -1,5 +1,5 @@
-import { CAPABILITIES, PROTOCOLS } from "@honua/sdk-js";
 import { explainHonuaCapabilityGap } from "@honua/sdk-js/agent-tools";
+import { CAPABILITIES, PROTOCOLS } from "@honua/sdk-js/contract";
 import { z } from "zod";
 import { jsonText } from "../helpers.js";
 const capabilitySchema = z.string().refine((value) => CAPABILITIES.includes(value), {

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,12 +1,27 @@
 {
   "name": "@honua/mcp-server",
-  "version": "0.0.20-alpha.0",
+  "version": "0.1.1-beta.0",
   "description": "MCP server for Honua geospatial feature services",
   "type": "module",
   "bin": {
     "honua-mcp": "dist/src/index.js",
     "honua-mcp-proxy": "dist/src/proxy.js"
   },
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./agent-execution": {
+      "types": "./dist/src/agent-execution.d.ts",
+      "default": "./dist/src/agent-execution.js"
+    },
+    "./nl-map-control": {
+      "types": "./dist/src/nl-map-control.d.ts",
+      "default": "./dist/src/nl-map-control.js"
+    },
+    "./package.json": "./package.json"
+  },
   "scripts": {
     "clean": "rm -rf dist coverage",
     "build": "npm run clean --silent && tsc -p tsconfig.json",
@@ -16,11 +31,16 @@
     "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:nl-map-control": "vitest run test/certification/nl-map-control.test.ts",
     "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 +60,7 @@
     "hono": "^4.12.21"
   },
   "peerDependencies": {
-    "@honua/sdk-js": "^0.0.20-alpha.0"
+    "@honua/sdk-js": "^0.1.1-beta.0"
   },
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
@@ -57,5 +77,10 @@
   ],
   "engines": {
     "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/honua-io/honua-sdk-js.git",
+    "directory": "mcp"
   }
 }