@honua/mcp-server 0.0.10-alpha.0 → 0.1.0-beta.0

package/certification/geospatial-mcp-schemas/tools/query_features.schema.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/query_features.schema.json",
+  "title": "query_features inputSchema",
+  "description": "Argument shape for the discovery/query feature-query tool (advertised name honua_query_features). Reads features from a published layer with an optional attribute and spatial filter. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["serviceId", "layerId"],
+  "properties": {
+    "serviceId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Published service identifier or name (from list_layers.serviceId)."
+    },
+    "layerId": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Service-local layer index (from list_layers.layerId)."
+    },
+    "where": {
+      "type": "string",
+      "description": "Optional attribute filter expressed as an ArcGIS/SQL WHERE clause."
+    },
+    "bbox": {
+      "type": "array",
+      "minItems": 4,
+      "maxItems": 4,
+      "items": { "type": "number" },
+      "description": "Optional spatial filter envelope as [minX, minY, maxX, maxY]."
+    },
+    "bboxSrid": {
+      "type": "integer",
+      "default": 4326,
+      "description": "Spatial reference (SRID/WKID) of the bbox ordinates."
+    },
+    "outFields": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional attribute fields to return; omit for all fields."
+    },
+    "limit": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 1000,
+      "default": 100,
+      "description": "Maximum number of features to return (capped at 1000)."
+    },
+    "resultOffset": {
+      "type": "integer",
+      "minimum": 0,
+      "default": 0,
+      "description": "Number of matching features to skip before returning results (pagination). Pair with limit to page mechanically through large result sets: when a response reports exceededTransferLimit=true, re-issue the same query with resultOffset set to the returned nextOffset until exceededTransferLimit is false."
+    },
+    "returnGeometry": {
+      "type": "boolean",
+      "default": true,
+      "description": "When false, features are returned without geometry (attribute-only rows). Use for attribute scans where returning geometry would waste the response/context budget."
+    },
+    "returnCountOnly": {
+      "type": "boolean",
+      "default": false,
+      "description": "When true, return only the matching feature count and no features. Use for cheap cardinality checks before deciding whether/how to page."
+    },
+    "outSrid": {
+      "type": "integer",
+      "default": 4326,
+      "description": "Output spatial reference (SRID/WKID) for returned geometries."
+    },
+    "geometryPrecision": {
+      "type": "integer",
+      "description": "Optional number of decimal places to round returned GeoJSON coordinates to, trading positional precision for a smaller response/context budget. A negative value returns full precision. When omitted, precision is implementation-defined; the reference implementation defaults to 6 (~0.1 m), which cuts coordinate payload roughly 12% at the default and far more for dense geometries. Standardized from the honua-server x-honua extension (geospatial-mcp#52)."
+    }
+  }
+}

package/certification/geospatial-mcp-schemas/tools/refine_map_package.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/refine_map_package.schema.json",
+  "title": "refine_map_package inputSchema",
+  "description": "Argument shape for refine_map_package (Analyze, Build App; returns the updated MapPackage). Refines an existing map package's composition. Responsibility-level: targets a mapPackageId and carries a refinement delta whose concrete field set finalizes upstream (honua-server#731). See taxonomy.md §Map composition.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["mapPackageId"],
+  "properties": {
+    "mapPackageId": {
+      "type": "string",
+      "description": "Identifier (map_…) of the MapPackage to refine."
+    },
+    "styleId": { "type": "string" },
+    "themeId": { "type": "string" },
+    "sourceBindings": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "initialView": { "type": "object", "additionalProperties": true }
+  }
+}

package/certification/geospatial-mcp-schemas/tools/render_map.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/render_map.schema.json",
+  "title": "render_map inputSchema",
+  "description": "Argument shape for the map-render tool (advertised name honua_render_map). Renders an image of ordered layers over an extent. This is the reference implementation's read-only map preview surface, distinct from the semantic map-composition family (create_map_package, etc.). x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["layers", "bbox"],
+  "properties": {
+    "layers": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Ordered layers to draw, bottom-to-top.",
+      "items": {
+        "type": "object",
+        "required": ["serviceId", "layerId"],
+        "properties": {
+          "serviceId": { "type": "string", "minLength": 1 },
+          "layerId": { "type": "integer", "minimum": 0 }
+        }
+      }
+    },
+    "bbox": {
+      "type": "array",
+      "minItems": 4,
+      "maxItems": 4,
+      "items": { "type": "number" },
+      "description": "Map extent as [minX, minY, maxX, maxY]."
+    },
+    "bboxSrid": {
+      "type": "integer",
+      "default": 4326,
+      "description": "Spatial reference (SRID/WKID) of the bbox and output image."
+    },
+    "width": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 1024,
+      "default": 512,
+      "description": "Output image width in pixels (capped at 1024)."
+    },
+    "height": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 1024,
+      "default": 512,
+      "description": "Output image height in pixels (capped at 1024)."
+    },
+    "transparent": {
+      "type": "boolean",
+      "default": false,
+      "description": "Render a transparent background instead of an opaque one."
+    },
+    "maxInlineBytes": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Optional ceiling, in bytes, on inline base64 image content. When the rendered image is at or below this size it may be returned inline; above it, the tool returns a resource_link href to the image instead of inlining megabytes of PNG into model context. When omitted, inlining behavior is implementation-defined; the reference implementation defaults to returning a resource_link href rather than inlining. Standardized from the honua-server x-honua extension (geospatial-mcp#52)."
+    }
+  }
+}

package/certification/geospatial-mcp-schemas/tools/reproject_features.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/reproject_features.schema.json",
+  "title": "reproject_features inputSchema",
+  "description": "Direct geoprocessing verb (advertised name honua_reproject_features): reproject a whole dataset into a target spatial reference and return the reprojected features. Use this when reprojection is the goal (\"give me this layer in EPSG:3857\"); when you only need another verb's output in a particular CRS, prefer that verb's optional outSrid param instead of a second call. For multi-step analysis with dependencies and a packaged result, use plan_analysis + execute_plan instead. Member of the standard's opt-in **analysis** conformance profile (see /CONFORMANCE.md and docs/adr/0029-direct-geoprocessing-verbs.md). Long-running calls return an ExecutionJob handle (honua://jobs/{job_id}), pollable and cancelable via cancel_job; small/fast calls may return an inline result. Advertised readOnlyHint: true (computes a derived result; mutates no server state). x-honua-reference-shape: the concrete source (serviceId/layerId, artifactId) spellings track the reference pipeline.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["source", "targetSrid"],
+  "properties": {
+    "source": {
+      "description": "Dataset to reproject: EITHER a published layer (serviceId + layerId) OR a prior-result artifact (artifactId).",
+      "oneOf": [
+        { "$ref": "#/$defs/layerRef" },
+        { "$ref": "#/$defs/artifactRef" }
+      ]
+    },
+    "targetSrid": {
+      "type": "integer",
+      "description": "Target spatial reference (SRID/WKID) to reproject into. Required — it is the operation's defining parameter."
+    },
+    "sourceSrid": {
+      "type": "integer",
+      "description": "Spatial reference (SRID/WKID) of the input geometries; defaults to the dataset's declared CRS. Provide only to override a missing or incorrect source CRS."
+    },
+    "where": {
+      "type": "string",
+      "description": "Optional attribute filter (ArcGIS/SQL WHERE clause) selecting which input features to reproject."
+    }
+  },
+  "$defs": {
+    "layerRef": {
+      "type": "object",
+      "required": ["serviceId", "layerId"],
+      "additionalProperties": false,
+      "properties": {
+        "serviceId": { "type": "string", "minLength": 1, "description": "Published service identifier or name (from list_layers.serviceId or resolve_entity)." },
+        "layerId": { "type": "integer", "minimum": 0, "description": "Service-local layer index (from list_layers.layerId)." }
+      }
+    },
+    "artifactRef": {
+      "type": "object",
+      "required": ["artifactId"],
+      "additionalProperties": false,
+      "properties": {
+        "artifactId": { "type": "string", "minLength": 1, "description": "Identifier (artifact_…) of a prior-result ArtifactRef produced by an earlier analysis job or verb. See resources/artifact.schema.json." }
+      }
+    }
+  }
+}

package/certification/geospatial-mcp-schemas/tools/resolve_entity.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/resolve_entity.schema.json",
+  "title": "resolve_entity inputSchema",
+  "description": "Argument shape for resolving a natural-language name or phrase to concrete catalog entity references (services/layers). The bare standard taxonomy models entity resolution as a CapabilityCatalog/grounding read; the reference implementation exposes it as a discrete tool (advertised name honua_resolve_entity). x-honua-extension: this is a documented Honua extension over the bare taxonomy, pending formalization in the geospatial-mcp standard. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-extension": true,
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["text"],
+  "properties": {
+    "text": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Natural-language name or phrase to resolve to catalog entities (e.g. \"parcels\", \"flood zones\", \"roads\")."
+    },
+    "entityType": {
+      "type": "string",
+      "enum": ["any", "service", "layer"],
+      "default": "any",
+      "description": "Restrict matches to services, to layers, or to both (default)."
+    },
+    "limit": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 50,
+      "default": 10,
+      "description": "Maximum number of ranked matches to return (capped at 50)."
+    }
+  }
+}

package/certification/geospatial-mcp-schemas/tools/solve_route.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/solve_route.schema.json",
+  "title": "solve_route inputSchema",
+  "description": "Argument shape for the analysis/geoprocessing routing tool (advertised name honua_solve_route). Solves an ordered route through a sequence of stops. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["stops"],
+  "properties": {
+    "stops": {
+      "type": "array",
+      "minItems": 2,
+      "maxItems": 25,
+      "description": "Ordered stops to route through, in visit order.",
+      "items": {
+        "type": "object",
+        "required": ["lon", "lat"],
+        "properties": {
+          "lon": { "type": "number", "description": "Longitude (X) ordinate." },
+          "lat": { "type": "number", "description": "Latitude (Y) ordinate." }
+        }
+      }
+    },
+    "travelProfile": {
+      "type": "string",
+      "default": "driving",
+      "description": "Travel profile / cost-model selector (e.g. \"driving\", \"walking\")."
+    },
+    "outSrid": {
+      "type": "integer",
+      "default": 4326,
+      "description": "Output spatial reference (SRID/WKID) for the returned route geometry."
+    },
+    "inSrid": {
+      "type": "integer",
+      "description": "Spatial reference of the input stop ordinates; defaults to outSrid."
+    }
+  }
+}

package/certification/geospatial-mcp-schemas/tools/summarize_statistics.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/summarize_statistics.schema.json",
+  "title": "summarize_statistics inputSchema",
+  "description": "Direct geoprocessing verb (advertised name honua_summarize_statistics): compute summary statistics over a dataset, optionally grouped by attribute fields, and return the summary rows. Use this for a single self-contained summary step (\"total population by county\", \"mean parcel value by zoning\") over a layer or a prior overlay/verb result; for multi-step analysis with dependencies and a packaged result, use plan_analysis + execute_plan instead. Member of the standard's opt-in **analysis** conformance profile (see /CONFORMANCE.md and docs/adr/0029-direct-geoprocessing-verbs.md). Long-running calls return an ExecutionJob handle (honua://jobs/{job_id}), pollable and cancelable via cancel_job; small/fast calls may return an inline result. Advertised readOnlyHint: true (computes a derived result; mutates no server state). x-honua-reference-shape: the concrete source (serviceId/layerId, artifactId) spellings track the reference pipeline.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["source", "statistics"],
+  "properties": {
+    "source": {
+      "description": "Dataset to summarize: EITHER a published layer (serviceId + layerId) OR a prior-result artifact (artifactId) such as an overlay_features or join_features result.",
+      "oneOf": [
+        { "$ref": "#/$defs/layerRef" },
+        { "$ref": "#/$defs/artifactRef" }
+      ]
+    },
+    "groupByFields": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Attribute fields to group by. Omit for a single summary row over all matching features."
+    },
+    "statistics": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Statistics to compute. Each entry names a statistic type and the field it is computed on.",
+      "items": {
+        "type": "object",
+        "required": ["statisticType", "onField"],
+        "additionalProperties": false,
+        "properties": {
+          "statisticType": {
+            "type": "string",
+            "enum": ["count", "sum", "min", "max", "mean", "stddev", "var"],
+            "description": "Aggregate to compute. count ignores onField values (counts rows)."
+          },
+          "onField": {
+            "type": "string",
+            "description": "Attribute field the statistic is computed on."
+          },
+          "outField": {
+            "type": "string",
+            "description": "Optional name for the output column; defaults to an implementation-defined name derived from statisticType and onField."
+          }
+        }
+      }
+    },
+    "where": {
+      "type": "string",
+      "description": "Optional attribute filter (ArcGIS/SQL WHERE clause) selecting which input features are summarized."
+    }
+  },
+  "$defs": {
+    "layerRef": {
+      "type": "object",
+      "required": ["serviceId", "layerId"],
+      "additionalProperties": false,
+      "properties": {
+        "serviceId": { "type": "string", "minLength": 1, "description": "Published service identifier or name (from list_layers.serviceId or resolve_entity)." },
+        "layerId": { "type": "integer", "minimum": 0, "description": "Service-local layer index (from list_layers.layerId)." }
+      }
+    },
+    "artifactRef": {
+      "type": "object",
+      "required": ["artifactId"],
+      "additionalProperties": false,
+      "properties": {
+        "artifactId": { "type": "string", "minLength": 1, "description": "Identifier (artifact_…) of a prior-result ArtifactRef produced by an earlier analysis job or verb. See resources/artifact.schema.json." }
+      }
+    }
+  }
+}

package/certification/geospatial-mcp-schemas/tools/validate_package.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/validate_package.schema.json",
+  "title": "validate_package inputSchema",
+  "description": "Argument shape for the read-only composition-review tool (advertised name honua_validate_package). Inspects a map/app package's requirement coverage (data bindings, permissions, schema, CRS, capabilities, dependencies, approvals) and returns canonical findings without mutating server state. x-honua-reference-shape: tracks the reference implementation; the bare taxonomy models package review as a CapabilityCatalog + resource read.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "description": "Package-review contract version. Current value is honua.package_review.v1."
+    },
+    "packageFamily": {
+      "type": "string",
+      "description": "Supported values are query, analysis_plan, map_package, dashboard_report, form, app_package, workflow, gp, and etl. Missing or unknown values are returned as canonical missing_package_family or unsupported_package_family findings rather than rejected by the schema."
+    },
+    "packageId": { "type": "string" },
+    "requestedAction": { "type": "string" },
+    "format": { "type": "string" },
+    "packagePayload": {
+      "type": ["object", "array", "string", "number", "boolean", "null"],
+      "description": "Opaque package payload inspected only by the matching package-family adapter."
+    },
+    "requirements": {
+      "type": ["object", "null"],
+      "description": "Shared data binding, permission, schema, CRS, capability, dependency, and approval requirements. An explicit null is normalized to an empty requirement set."
+    },
+    "includePassFindings": { "type": "boolean" },
+    "resourceRefs": {
+      "type": ["object", "null"],
+      "additionalProperties": { "type": "string" },
+      "description": "Safe caller-visible resource references. An explicit null is normalized to an empty map."
+    }
+  }
+}

package/certification/geospatial-mcp-schemas/tools/validate_plan.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/validate_plan.schema.json",
+  "title": "validate_plan inputSchema",
+  "description": "Argument shape for the validate_plan tool (Analyze, Publish Data, Build App; also shared by the dry_run_plan preview tool in the reference implementation). Reference advertised name: honua_validate_plan. Accepts a partial AnalysisPlan so the validator can report EMPTY_PLAN_ID / EMPTY_STEPS as structured violations rather than rejecting at ingest — planId and steps are therefore NOT required here (contrast execute_plan). See planning.md §5.1.",
+  "type": "object",
+  "required": ["plan"],
+  "properties": {
+    "plan": { "$ref": "#/$defs/analysisPlan" }
+  },
+  "$defs": {
+    "analysisPlan": {
+      "type": "object",
+      "description": "Canonical AnalysisPlan expressed as MCP plan input. Partial plans are permitted at validate time.",
+      "required": [],
+      "properties": {
+        "planId": { "type": "string" },
+        "intentId": { "type": "string" },
+        "steps": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/planStep" }
+        },
+        "outputs": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/artifactKind" }
+        },
+        "warnings": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "planStep": {
+      "type": "object",
+      "required": ["stepId", "kind"],
+      "properties": {
+        "stepId": { "type": "string" },
+        "kind": { "$ref": "#/$defs/planStepKind" },
+        "processId": { "type": "string" },
+        "inputs": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        },
+        "dependsOn": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "planStepKind": {
+      "type": "string",
+      "description": "Canonical AnalysisPlanStepKind value. Server parsing is case-insensitive but clients should send the canonical PascalCase spelling.",
+      "enum": ["QueryFeatures", "Geoprocess", "Aggregate", "RenderMap", "Export"]
+    },
+    "artifactKind": {
+      "type": "string",
+      "description": "Canonical ArtifactKind value.",
+      "enum": ["Scalar", "FeatureLayer", "Table", "Raster", "File", "Report", "Map", "AppBundle"]
+    }
+  }
+}

package/dist/src/capability.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Platform-free capability degradation (issue #369).
+ *
+ * `@honua/mcp-server` runs in two modes: against a Honua-enhanced deployment
+ * (which exposes extra surfaces such as OGC API – Styles) and — the platform-free
+ * front door — against ANY plain public Esri FeatureServer / OGC endpoint that
+ * has none of those surfaces. A tool that depends on a Honua-only surface must
+ * NEVER crash, hang, or return misleading empty data on a plain target. Instead
+ * it detects the missing surface and reports a clear, structured "not available
+ * on this target" result — the same skip-with-reason honesty the certification
+ * suite uses.
+ *
+ * Probing helpers throw {@link CapabilityUnavailableError} when a surface is
+ * absent; the tool/resource layer catches it and returns
+ * {@link capabilityUnavailable}, a non-error tool result carrying
+ * `available: false` plus a human-readable reason.
+ */
+export declare class CapabilityUnavailableError extends Error {
+    readonly code = "CAPABILITY_UNAVAILABLE";
+    /** Human label of the missing surface, e.g. "OGC API - Styles". */
+    readonly surface: string;
+    /** Why the surface was judged unavailable (status / parse / shape). */
+    readonly reason: string;
+    constructor(surface: string, reason: string);
+}
+/** Machine-readable body of a graceful capability-degradation result. */
+export interface CapabilityUnavailablePayload {
+    available: false;
+    surface: string;
+    reason: string;
+    /** What a client can do instead on a plain public endpoint. */
+    guidance: string;
+}
+/**
+ * Build a structured "not available on this target" tool/resource result. The
+ * result is deliberately NOT an MCP error: a plain FeatureServer legitimately
+ * lacks the surface, so degradation is an honest, expected outcome — not a
+ * failure. Clients branch on `available === false`.
+ */
+export declare function capabilityUnavailablePayload(surface: string, reason: string, guidance: string): CapabilityUnavailablePayload;
+/** Convenience: the {@link capabilityUnavailablePayload} body wrapped as tool text content. */
+export declare function capabilityUnavailable(surface: string, reason: string, guidance: string): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+//# sourceMappingURL=capability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../src/capability.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,4BAA4B;IACzC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAM5C;AAED,yEAAyE;AACzE,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,KAAK,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,4BAA4B,CAE9B;AAED,+FAA+F;AAC/F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;;;;;EAEtF"}

package/dist/src/capability.js

@@ -0,0 +1,44 @@
+import { jsonText } from "./helpers.js";
+/**
+ * Platform-free capability degradation (issue #369).
+ *
+ * `@honua/mcp-server` runs in two modes: against a Honua-enhanced deployment
+ * (which exposes extra surfaces such as OGC API – Styles) and — the platform-free
+ * front door — against ANY plain public Esri FeatureServer / OGC endpoint that
+ * has none of those surfaces. A tool that depends on a Honua-only surface must
+ * NEVER crash, hang, or return misleading empty data on a plain target. Instead
+ * it detects the missing surface and reports a clear, structured "not available
+ * on this target" result — the same skip-with-reason honesty the certification
+ * suite uses.
+ *
+ * Probing helpers throw {@link CapabilityUnavailableError} when a surface is
+ * absent; the tool/resource layer catches it and returns
+ * {@link capabilityUnavailable}, a non-error tool result carrying
+ * `available: false` plus a human-readable reason.
+ */
+export class CapabilityUnavailableError extends Error {
+    code = "CAPABILITY_UNAVAILABLE";
+    /** Human label of the missing surface, e.g. "OGC API - Styles". */
+    surface;
+    /** Why the surface was judged unavailable (status / parse / shape). */
+    reason;
+    constructor(surface, reason) {
+        super(`${surface} is not available on this target: ${reason}`);
+        this.name = "CapabilityUnavailableError";
+        this.surface = surface;
+        this.reason = reason;
+    }
+}
+/**
+ * Build a structured "not available on this target" tool/resource result. The
+ * result is deliberately NOT an MCP error: a plain FeatureServer legitimately
+ * lacks the surface, so degradation is an honest, expected outcome — not a
+ * failure. Clients branch on `available === false`.
+ */
+export function capabilityUnavailablePayload(surface, reason, guidance) {
+    return { available: false, surface, reason, guidance };
+}
+/** Convenience: the {@link capabilityUnavailablePayload} body wrapped as tool text content. */
+export function capabilityUnavailable(surface, reason, guidance) {
+    return jsonText(capabilityUnavailablePayload(surface, reason, guidance));
+}

package/dist/src/certification/census-data.d.ts

@@ -0,0 +1,33 @@
+export interface CensusRow {
+    OBJECTID: number;
+    NAME: string;
+    STUSPS: string;
+    Total_Pop_2020: number | null;
+    Seats_2020: number | null;
+}
+/** The public FeatureServer this fixture was recorded from. */
+export declare const CENSUS_ENDPOINT = "https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/2020_Census_State_Apportionment/FeatureServer/0";
+/** Service id (as it appears under /rest/services) for the recorded service. */
+export declare const CENSUS_SERVICE_ID = "2020_Census_State_Apportionment";
+/** Human layer name as advertised by the live layer metadata. */
+export declare const CENSUS_LAYER_NAME = "States 2020 Apportionment - U.S. House of Representatives Seats";
+/** Recorded layer extent (Web Mercator, wkid 102100). */
+export declare const CENSUS_EXTENT: {
+    readonly xmin: -19942592.3656;
+    readonly ymin: 2024070.8216000013;
+    readonly xmax: 20012846.037699997;
+    readonly ymax: 11523911.845299996;
+    readonly spatialReference: {
+        readonly wkid: 102100;
+        readonly latestWkid: 3857;
+    };
+};
+/** Recorded field list for layer 0 (all 22 fields, verbatim). */
+export declare const CENSUS_FIELDS: ReadonlyArray<{
+    name: string;
+    type: string;
+    alias: string;
+}>;
+/** All 52 recorded rows (attribute-only; geometry omitted to keep the fixture small). */
+export declare const CENSUS_ROWS: ReadonlyArray<CensusRow>;
+//# sourceMappingURL=census-data.d.ts.map

package/dist/src/certification/census-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"census-data.d.ts","sourceRoot":"","sources":["../../../src/certification/census-data.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAG9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,+DAA+D;AAC/D,eAAO,MAAM,eAAe,sHACyF,CAAC;AAEtH,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,oCAAoC,CAAC;AAEnE,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,oEAAoE,CAAC;AAEnG,yDAAyD;AACzD,eAAO,MAAM,aAAa;;;;;;;;;CAMhB,CAAC;AAEX,iEAAiE;AACjE,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA+GtF,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,SAAS,CA6WhD,CAAC"}