@honua/mcp-server 0.0.10-alpha.0 → 0.0.20-alpha.0

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

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

package/dist/src/eval/types.js

@@ -0,0 +1,10 @@
+/**
+ * Cross-model MCP workflow eval — shared types (honua-server #1956, WS-H).
+ *
+ * The eval proves the north-star claim "any client → any workflow": a held-out
+ * corpus of GIS workflows is driven through the honua MCP surface by DIFFERENT
+ * client LLMs (Claude AND a GPT model), and end-to-end success / clarification /
+ * edit rates are recorded per model. A deterministic (scripted) driver provides
+ * an offline control that runs in CI with no model/API calls.
+ */
+export {};

package/dist/src/helpers.d.ts

@@ -10,6 +10,17 @@ export declare function jsonText(result: unknown): {
     }>;
 };
 export declare function metadataErrorText(): string;
+/**
+ * Coerce a feature `count` from a query response into a usable value.
+ *
+ * The default `grpc-web` transport returns counts via `toSafeNumberOrString`,
+ * which yields a **string** when the proto count exceeds
+ * `Number.MAX_SAFE_INTEGER` (chosen specifically to avoid precision loss). Both
+ * a finite `number` and a numeric `string` are valid counts; anything else
+ * (non-finite numbers, non-numeric strings, missing values) returns
+ * `undefined`.
+ */
+export declare function coerceCount(value: unknown): number | string | undefined;
 export declare function encodeServiceId(serviceId: string): string;
 export declare function decodeServiceId(encoded: string): string;
 export declare function parseLayerId(value: string): 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,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,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"}

package/dist/src/helpers.js

@@ -55,6 +55,28 @@ export function jsonText(result) {
 export function metadataErrorText() {
     return METADATA_ERROR_MESSAGE;
 }
+/**
+ * Coerce a feature `count` from a query response into a usable value.
+ *
+ * The default `grpc-web` transport returns counts via `toSafeNumberOrString`,
+ * which yields a **string** when the proto count exceeds
+ * `Number.MAX_SAFE_INTEGER` (chosen specifically to avoid precision loss). Both
+ * a finite `number` and a numeric `string` are valid counts; anything else
+ * (non-finite numbers, non-numeric strings, missing values) returns
+ * `undefined`.
+ */
+export function coerceCount(value) {
+    if (typeof value === "number") {
+        return Number.isFinite(value) ? value : undefined;
+    }
+    if (typeof value === "string") {
+        // Accept canonical base-10 integer strings (optionally signed). These are
+        // the large-count representation the grpc adapter emits to preserve
+        // precision beyond Number.MAX_SAFE_INTEGER.
+        return /^-?\d+$/.test(value.trim()) ? value.trim() : undefined;
+    }
+    return undefined;
+}
 export function encodeServiceId(serviceId) {
     return encodeURIComponent(serviceId);
 }

package/dist/src/index.d.ts

@@ -12,5 +12,12 @@ export interface RuntimeOptions {
 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.
+ */
 export declare function createServer(client: HonuaClient): McpServer;
 //# 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;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"}
+{"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"}

package/dist/src/index.js

@@ -6,10 +6,13 @@ import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mc
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import * as layerSchemaResource from "./resources/layer-schema.js";
 import * as servicesResource from "./resources/services.js";
+import * as stylesResource from "./resources/styles.js";
+import * as applyStylePreset from "./tools/apply-style-preset.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 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";
@@ -113,6 +116,13 @@ export function createClientFromEnv(env = process.env) {
         retry: options.retryMaxRetries > 0 ? { maxRetries: options.retryMaxRetries } : undefined,
     });
 }
+/**
+ * @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.
+ */
 export function createServer(client) {
     const server = new McpServer({
         name: "honua",
@@ -126,16 +136,31 @@ export function createServer(client) {
     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)));
     // ── 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));
+    server.resource("styles-catalog", stylesResource.uri, async (uri) => stylesResource.readCatalog(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. */
+/**
+ * Deprecated `honua-mcp` bin entry.
+ *
+ * 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`.
+ */
 async function main() {
-    const client = createClientFromEnv();
-    const server = createServer(client);
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
+    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();
 }
 if (process.argv[1] === fileURLToPath(import.meta.url)) {
     main().catch((err) => {
@@ -143,3 +168,4 @@ if (process.argv[1] === fileURLToPath(import.meta.url)) {
         process.exit(1);
     });
 }
+/* v8 ignore stop */

package/dist/src/proxy.d.ts

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+/**
+ * Transport-symmetric stdio proxy for the honua MCP surface (honua-server #1950).
+ *
+ * The honua server exposes a single MCP catalog over streamable-HTTP/SSE at
+ * `/mcp`. Claude-Desktop-style clients speak stdio. Rather than reimplementing
+ * the tool/resource catalog (the older `@honua/mcp-server` discovery surface did
+ * exactly that, which is how the two halves drifted apart), this proxy bridges a
+ * local stdio MCP client to the remote HTTP-SSE MCP server: it connects upstream
+ * as an MCP client, then re-exposes the *same* catalog downstream over stdio.
+ *
+ * Because every request and notification is forwarded verbatim, the stdio
+ * surface is transport-symmetric with the HTTP-SSE surface by construction —
+ * identical tools, identical input/output schemas, identical resources and
+ * prompts, and live `list_changed` notifications. There is one source-of-truth
+ * catalog (the server's `/mcp`); the SDK proxies it.
+ */
+export interface ProxyOptions {
+    /** Absolute URL of the remote honua MCP endpoint (e.g. https://demo.honua.io/mcp). */
+    remoteUrl: string;
+    /** Optional bearer token for the remote MCP surface. */
+    authToken?: string | undefined;
+    /** Optional API key (sent as x-api-key) for deployments that require it. */
+    apiKey?: string | undefined;
+}
+export declare function resolveProxyOptions(env?: NodeJS.ProcessEnv): ProxyOptions;
+/** Build request headers for the upstream connection from the resolved options. */
+export declare function buildUpstreamHeaders(options: ProxyOptions): Record<string, string>;
+/** Connect an upstream MCP client to the remote honua /mcp over streamable HTTP. */
+export declare function connectUpstream(options: ProxyOptions): Promise<Client>;
+/**
+ * Build a low-level MCP server that forwards every request and `list_changed`
+ * notification to the already-connected upstream client. The proxy advertises
+ * exactly the upstream's name, version, and capabilities, so the downstream
+ * (stdio) surface mirrors the upstream (HTTP-SSE) surface.
+ */
+export declare function createProxyServer(upstream: Client): Server;
+/**
+ * Run the stdio proxy end-to-end: resolve the remote `/mcp` from the
+ * environment, connect upstream, and expose the mirrored catalog over stdio.
+ * Also used by the deprecated `honua-mcp` bin, which now delegates here.
+ */
+export declare function runProxy(env?: NodeJS.ProcessEnv): Promise<void>;
+//# sourceMappingURL=proxy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/proxy.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAiBnE;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,YAAY;IAC3B,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CAqBtF;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASlF;AAED,oFAAoF;AACpF,wBAAsB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ5E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA+C1D;AAOD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBlF"}

package/dist/src/proxy.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+import { fileURLToPath } from "node:url";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourceTemplatesRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, PromptListChangedNotificationSchema, ReadResourceRequestSchema, ResourceListChangedNotificationSchema, ToolListChangedNotificationSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { SERVER_VERSION } from "./index.js";
+export function resolveProxyOptions(env = process.env) {
+    const remoteUrl = env.HONUA_MCP_REMOTE_URL ?? env.HONUA_MCP_URL;
+    if (!remoteUrl) {
+        throw new Error("HONUA_MCP_REMOTE_URL environment variable is required (the remote honua /mcp endpoint to proxy).");
+    }
+    let parsed;
+    try {
+        parsed = new URL(remoteUrl);
+    }
+    catch {
+        throw new Error(`HONUA_MCP_REMOTE_URL must be a valid absolute URL: ${remoteUrl}`);
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error(`HONUA_MCP_REMOTE_URL must use http or https: ${remoteUrl}`);
+    }
+    return {
+        remoteUrl: parsed.toString(),
+        authToken: env.HONUA_MCP_AUTH_TOKEN,
+        apiKey: env.HONUA_API_KEY,
+    };
+}
+/** Build request headers for the upstream connection from the resolved options. */
+export function buildUpstreamHeaders(options) {
+    const headers = {};
+    if (options.authToken) {
+        headers.Authorization = `Bearer ${options.authToken}`;
+    }
+    if (options.apiKey) {
+        headers["x-api-key"] = options.apiKey;
+    }
+    return headers;
+}
+/** Connect an upstream MCP client to the remote honua /mcp over streamable HTTP. */
+export async function connectUpstream(options) {
+    const headers = buildUpstreamHeaders(options);
+    const transport = new StreamableHTTPClientTransport(new URL(options.remoteUrl), {
+        requestInit: Object.keys(headers).length > 0 ? { headers } : undefined,
+    });
+    const client = new Client({ name: "honua-mcp-stdio-proxy", version: SERVER_VERSION });
+    await client.connect(transport);
+    return client;
+}
+/**
+ * Build a low-level MCP server that forwards every request and `list_changed`
+ * notification to the already-connected upstream client. The proxy advertises
+ * exactly the upstream's name, version, and capabilities, so the downstream
+ * (stdio) surface mirrors the upstream (HTTP-SSE) surface.
+ */
+export function createProxyServer(upstream) {
+    const upstreamInfo = upstream.getServerVersion() ?? { name: "honua", version: SERVER_VERSION };
+    const upstreamCapabilities = upstream.getServerCapabilities() ?? {};
+    const server = new Server({ name: upstreamInfo.name, version: upstreamInfo.version }, {
+        capabilities: upstreamCapabilities,
+        instructions: upstream.getInstructions(),
+    });
+    // ── Tools ──────────────────────────────────────────────────────
+    if (upstreamCapabilities.tools) {
+        server.setRequestHandler(ListToolsRequestSchema, async (request) => upstream.listTools(request.params));
+        server.setRequestHandler(CallToolRequestSchema, async (request) => upstream.callTool(request.params));
+    }
+    // ── Resources ──────────────────────────────────────────────────
+    if (upstreamCapabilities.resources) {
+        server.setRequestHandler(ListResourcesRequestSchema, async (request) => upstream.listResources(request.params));
+        server.setRequestHandler(ListResourceTemplatesRequestSchema, async (request) => upstream.listResourceTemplates(request.params));
+        server.setRequestHandler(ReadResourceRequestSchema, async (request) => upstream.readResource(request.params));
+    }
+    // ── Prompts ────────────────────────────────────────────────────
+    if (upstreamCapabilities.prompts) {
+        server.setRequestHandler(ListPromptsRequestSchema, async (request) => upstream.listPrompts(request.params));
+        server.setRequestHandler(GetPromptRequestSchema, async (request) => upstream.getPrompt(request.params));
+    }
+    // ── list_changed notification forwarding ───────────────────────
+    // Keeps the stdio surface live: when the server's catalog changes, the
+    // downstream client is told, exactly as an HTTP-SSE client would be.
+    upstream.setNotificationHandler(ToolListChangedNotificationSchema, async () => {
+        await server.sendToolListChanged();
+    });
+    upstream.setNotificationHandler(ResourceListChangedNotificationSchema, async () => {
+        await server.sendResourceListChanged();
+    });
+    upstream.setNotificationHandler(PromptListChangedNotificationSchema, async () => {
+        await server.sendPromptListChanged();
+    });
+    return server;
+}
+/* v8 ignore start -- live-process entry: wires the stdio transport to a real
+   remote /mcp upstream; exercised by running the proxy, not by unit tests. The
+   unit-testable logic (option/header resolution, upstream connect, catalog
+   forwarding) lives in the exported functions above and is covered there. */
+/**
+ * Run the stdio proxy end-to-end: resolve the remote `/mcp` from the
+ * environment, connect upstream, and expose the mirrored catalog over stdio.
+ * Also used by the deprecated `honua-mcp` bin, which now delegates here.
+ */
+export async function runProxy(env = process.env) {
+    const options = resolveProxyOptions(env);
+    const upstream = await connectUpstream(options);
+    const server = createProxyServer(upstream);
+    // Tear down both ends together so a dropped upstream surfaces to the client.
+    const shutdown = async () => {
+        await server.close().catch(() => { });
+        await upstream.close().catch(() => { });
+    };
+    upstream.onclose = () => {
+        void shutdown();
+    };
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+    runProxy().catch((err) => {
+        process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    });
+}
+/* v8 ignore stop */

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

@@ -0,0 +1,29 @@
+import type { HonuaClient } from "@honua/sdk-js";
+/** URI for the styles catalog resource (`honua://styles`). */
+export declare const uri = "honua://styles";
+/** URI template for a single style resource (`honua://styles/{styleId}`). */
+export declare const uriTemplate = "honua://styles/{styleId}";
+/**
+ * Read the styles catalog: the list of styles available on the server, each
+ * with its stable styleId, title, and canonical URI (`honua://styles/{id}`).
+ */
+export declare function readCatalog(client: HonuaClient): Promise<{
+    contents: {
+        uri: string;
+        mimeType: "application/json";
+        text: string;
+    }[];
+}>;
+/**
+ * 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 declare function read(client: HonuaClient, styleId: string): Promise<{
+    contents: {
+        uri: string;
+        mimeType: "application/json";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=styles.d.ts.map

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

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

package/dist/src/resources/styles.js

@@ -0,0 +1,43 @@
+import { listStyles, resolveStyleRef } from "../styles.js";
+/** URI for the styles catalog resource (`honua://styles`). */
+export const uri = "honua://styles";
+/** URI template for a single style resource (`honua://styles/{styleId}`). */
+export const uriTemplate = "honua://styles/{styleId}";
+/**
+ * Read the styles catalog: the list of styles available on the server, each
+ * with its stable styleId, title, and canonical URI (`honua://styles/{id}`).
+ */
+export async function readCatalog(client) {
+    const list = await listStyles(client);
+    const styles = list.styles.map((entry) => ({
+        styleId: entry.id,
+        title: entry.title ?? entry.id,
+        uri: `honua://styles/${encodeURIComponent(entry.id)}`,
+    }));
+    return {
+        contents: [
+            {
+                uri,
+                mimeType: "application/json",
+                text: JSON.stringify({ styles, default: list.default ?? null }, 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);
+    return {
+        contents: [
+            {
+                uri: `honua://styles/${encodeURIComponent(styleId)}`,
+                mimeType: "application/json",
+                text: JSON.stringify(styleRef, null, 2),
+            },
+        ],
+    };
+}

package/dist/src/styles.d.ts

@@ -0,0 +1,110 @@
+import type { HonuaClient } from "@honua/sdk-js";
+/**
+ * Thin read-only client over the server's OGC API – Styles surface
+ * (honua-server, ADR-0048):
+ *
+ *   GET /ogc/styles                     -> styles list   ({ styles: [{ id, title, links }], default? })
+ *   GET /ogc/styles/{styleId}/metadata  -> style metadata ({ id, title, description, keywords, license, version, links })
+ *   GET /ogc/styles/{styleId}           -> stylesheet body (MapLibre/Mapbox JSON by default; SLD via Accept)
+ *
+ * These helpers project the server responses into the geospatial-grpc
+ * `StyleRef` / `StyleEncoding` shape (style_id / title / encodings) so the MCP
+ * resource + `get_style` tool surface a single canonical style object.
+ *
+ * The MCP package only consumes the public {@link HonuaClient.pipelineFetch}
+ * request pipeline (auth / retry / timeout / interceptors) rather than a
+ * private route, matching the other `/ogc/*` consumers in the SDK.
+ *
+ * @module
+ */
+/** Default path prefix for the server's OGC API – Styles surface. */
+export declare const OGC_STYLES_PATH = "/ogc/styles";
+/** MapLibre / Mapbox style media type (server default stylesheet encoding). */
+export declare const MAPLIBRE_STYLE_MEDIA_TYPE = "application/vnd.mapbox.style+json";
+/** SLD 1.0 stylesheet media type. */
+export declare const SLD_10_MEDIA_TYPE = "application/vnd.ogc.sld+xml;version=1.0";
+/** SLD 1.1 stylesheet media type. */
+export declare const SLD_11_MEDIA_TYPE = "application/vnd.ogc.sld+xml;version=1.1";
+/**
+ * Stylesheet encodings the MCP surface understands, keyed by the canonical
+ * geospatial-grpc `StyleEncoding.encoding` identifier. The server
+ * content-negotiates these via the `Accept` header.
+ */
+export declare const STYLE_ENCODINGS: {
+    readonly "mapbox-style": "application/vnd.mapbox.style+json";
+    readonly "sld-1.0.0": "application/vnd.ogc.sld+xml;version=1.0";
+    readonly "sld-1.1.0": "application/vnd.ogc.sld+xml;version=1.1";
+};
+/** A geospatial-grpc `StyleEncoding`-aligned encoding identifier. */
+export type StyleEncodingId = keyof typeof STYLE_ENCODINGS;
+/** Hypermedia link entry on an OGC styles document. */
+export interface OgcStyleLink {
+    href: string;
+    rel?: string;
+    type?: string;
+    title?: string;
+}
+/** One entry in the `GET /ogc/styles` styles list. */
+export interface OgcStyleListEntry {
+    id: string;
+    title?: string;
+    links?: OgcStyleLink[];
+}
+/** Response body of `GET /ogc/styles`. */
+export interface OgcStyleList {
+    styles: OgcStyleListEntry[];
+    default?: string;
+    links?: OgcStyleLink[];
+}
+/** Response body of `GET /ogc/styles/{styleId}/metadata`. */
+export interface OgcStyleMetadata {
+    id: string;
+    title?: string;
+    description?: string;
+    keywords?: string[];
+    license?: string;
+    version?: string;
+    links?: OgcStyleLink[];
+}
+/**
+ * A single encoded representation of a style, aligned with the geospatial-grpc
+ * `StyleEncoding` message. The MCP surface carries the inline body for the
+ * MapLibre encoding (the default the server serves) and exposes the alternate
+ * SLD encodings by reference (`storageRef` = the stylesheet URL).
+ */
+export interface StyleEncoding {
+    encoding: StyleEncodingId | string;
+    contentType?: string;
+    inlineBody?: unknown;
+    storageRef?: string;
+}
+/**
+ * Canonical style projection aligned with the geospatial-grpc `StyleRef`
+ * message (`style_id` / `title` / `description` / `style_version` /
+ * `encodings` / `legend_url`).
+ */
+export interface StyleRef {
+    styleId: string;
+    title: string;
+    description: string | null;
+    styleVersion: number | null;
+    legendUrl: string | null;
+    encodings: StyleEncoding[];
+}
+/** List available styles via `GET /ogc/styles`. */
+export declare function listStyles(client: HonuaClient): Promise<OgcStyleList>;
+/** Fetch style metadata via `GET /ogc/styles/{styleId}/metadata`. */
+export declare function getStyleMetadata(client: HonuaClient, styleId: string): Promise<OgcStyleMetadata>;
+/**
+ * Fetch the MapLibre/Mapbox stylesheet body via `GET /ogc/styles/{styleId}`
+ * (content-negotiated to {@link MAPLIBRE_STYLE_MEDIA_TYPE}).
+ */
+export declare function getMapLibreStylesheet(client: HonuaClient, styleId: string): Promise<unknown>;
+/**
+ * Resolve a single style into a `StyleRef` projection: fetch metadata and the
+ * canonical MapLibre stylesheet, and advertise the alternate SLD encodings by
+ * reference. The stylesheet base URL (`{baseUrl}/ogc/styles/{styleId}`) backs
+ * the `storageRef` for the by-reference encodings.
+ */
+export declare function resolveStyleRef(client: HonuaClient, styleId: string): Promise<StyleRef>;
+//# sourceMappingURL=styles.d.ts.map

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

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