@honua/mcp-server 0.0.6-alpha.0 → 0.0.8-alpha.0

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;AAYtF,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,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,aA8D/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;AAatF,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,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,aAqE/C"}

package/dist/src/index.js

@@ -8,6 +8,7 @@ import * as layerSchemaResource from "./resources/layer-schema.js";
 import * as servicesResource from "./resources/services.js";
 import * as countFeatures from "./tools/count-features.js";
 import * as describeLayer from "./tools/describe-layer.js";
+import * as explainCapabilityGap from "./tools/explain-capability-gap.js";
 import * as getExtent from "./tools/get-extent.js";
 import * as listServices from "./tools/list-services.js";
 import * as queryFeatures from "./tools/query-features.js";
@@ -124,6 +125,7 @@ export function createServer(client) {
     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)));
     // ── 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));

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

@@ -0,0 +1,26 @@
+import { type Capability, type Protocol } from "@honua/sdk-js";
+import { z } from "zod";
+export declare const schema: z.ZodObject<{
+    capability: z.ZodEffects<z.ZodString, Capability, string>;
+    protocol: z.ZodOptional<z.ZodEffects<z.ZodString, Protocol, string>>;
+    sourceId: z.ZodOptional<z.ZodString>;
+    declaredCapabilities: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, Capability, string>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    capability: Capability;
+    protocol?: Protocol | undefined;
+    sourceId?: string | undefined;
+    declaredCapabilities?: Capability[] | undefined;
+}, {
+    capability: string;
+    protocol?: string | undefined;
+    sourceId?: string | undefined;
+    declaredCapabilities?: string[] | undefined;
+}>;
+export type Input = z.infer<typeof schema>;
+export declare function execute(_client: unknown, input: Input): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=explain-capability-gap.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,24 @@
+import { CAPABILITIES, PROTOCOLS } from "@honua/sdk-js";
+import { explainHonuaCapabilityGap } from "@honua/sdk-js/agent-tools";
+import { z } from "zod";
+import { jsonText } from "../helpers.js";
+const capabilitySchema = z.string().refine((value) => CAPABILITIES.includes(value), {
+    message: "Unknown Honua capability",
+});
+const protocolSchema = z
+    .string()
+    .refine((value) => PROTOCOLS.includes(value), {
+    message: "Unknown Honua protocol",
+})
+    .optional();
+export const schema = z.object({
+    capability: capabilitySchema.describe("Honua capability to check"),
+    protocol: protocolSchema.describe("Optional Honua protocol identifier"),
+    sourceId: z.string().optional().describe("Optional source id for the explanation"),
+    declaredCapabilities: z.array(capabilitySchema).optional().describe("Optional source-declared capabilities"),
+});
+export async function execute(_client, input) {
+    return jsonText({
+        explanation: explainHonuaCapabilityGap(input),
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honua/mcp-server",
-  "version": "0.0.6-alpha.0",
+  "version": "0.0.8-alpha.0",
   "description": "MCP server for Honua geospatial feature services",
   "type": "module",
   "bin": {
@@ -26,7 +26,7 @@
     "zod": "^3.24.0"
   },
   "peerDependencies": {
-    "@honua/sdk-js": "^0.0.6-alpha.0"
+    "@honua/sdk-js": "^0.0.8-alpha.0"
   },
   "devDependencies": {
     "@honua/sdk-js": "file:..",