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

package/certification/geospatial-mcp-schemas/resources/workspace.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/resources/workspace.schema.json",
+  "title": "Workspace resource payload",
+  "description": "Read-only projection of a WorkspaceRef, addressable as honua://workspaces/{workspace_id}. The canonical kind values are Scratch/Persistent/TempLayer/SavedLayer/ResultCollection; the reference implementation projects lower_snake_case wire spellings (x-honua-reference-shape). lifecycleState is an MCP-layer projection. See resources.md §honua://workspaces/{workspace_id}.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["workspaceId"],
+  "properties": {
+    "workspaceId": {
+      "type": "string",
+      "description": "Stable identifier (ws_…)."
+    },
+    "kind": {
+      "type": "string",
+      "description": "WorkspaceKind. Canonical enum names are Scratch/Persistent/TempLayer/SavedLayer/ResultCollection; the reference implementation emits the lower_snake_case wire spelling. An empty/absent kind is not a legal value — omit the property rather than emitting an empty string.",
+      "enum": [
+        "scratch",
+        "persistent",
+        "temp_layer",
+        "saved_layer",
+        "result_collection",
+        "Scratch",
+        "Persistent",
+        "TempLayer",
+        "SavedLayer",
+        "ResultCollection"
+      ]
+    },
+    "label": { "type": "string", "description": "Human-readable label." },
+    "uri": { "type": "string", "description": "Canonical URI." },
+    "expiresAt": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "description": "Expiration timestamp when applicable."
+    },
+    "lifecycleState": {
+      "type": "string",
+      "description": "WorkspaceLifecycleState projection (MCP-layer, not a field of WorkspaceRef — see resources.md §honua://workspaces/{workspace_id}). Canonical enum names are Active/Expired/Archived/Deleted; the reference implementation emits the lower_snake_case wire spelling. Field name matches artifact.schema.json.lifecycleState.",
+      "enum": [
+        "active",
+        "expired",
+        "archived",
+        "deleted",
+        "Active",
+        "Expired",
+        "Archived",
+        "Deleted"
+      ]
+    },
+    "cleanupScheduledAt": {
+      "type": ["string", "null"],
+      "format": "date-time"
+    },
+    "resultsUri": {
+      "type": ["string", "null"],
+      "description": "URI of the result package this workspace's outputs are projected into, when applicable. MUST use the defined honua://results/{result_package_id} route (resources.md §honua://results/{result_package_id}); the spec defines no honua://jobs family (execution/job state is the canonical ExecutionJob object reference, not an MCP resource URI — see planning.md §5.3, conformance.md resource_projection contract).",
+      "pattern": "^honua://results/[^/]+$"
+    },
+    "notImplementedReason": { "type": "string" }
+  }
+}

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

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/apply_style_preset.schema.json",
+  "title": "apply_style_preset inputSchema",
+  "description": "Argument shape for apply_style_preset (Analyze, Build App; returns the updated MapPackage). Applies a reusable StyleRef preset to a map package, optionally scoped to a binding. Responsibility-level; concrete styling field set finalizes upstream. See taxonomy.md §Map composition and resources.md §honua://styles/{style_id}.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["mapPackageId", "styleId"],
+  "properties": {
+    "mapPackageId": {
+      "type": "string",
+      "description": "Identifier (map_…) of the MapPackage to style."
+    },
+    "styleId": {
+      "type": "string",
+      "description": "StyleRef preset identifier (style_…) to apply."
+    },
+    "targetBindingId": {
+      "type": "string",
+      "description": "Optional SourceBinding the preset is scoped to; applies map-wide when omitted."
+    }
+  }
+}

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

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/cancel_job.schema.json",
+  "title": "cancel_job inputSchema",
+  "description": "Argument shape for the execution-lifecycle cancel tool (advertised name honua_cancel_job). Requests cancellation of a submitted ExecutionJob. x-honua-reference-shape: lifecycle control over the execution handoff; tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["jobId"],
+  "properties": {
+    "jobId": {
+      "type": "string",
+      "description": "Execution job identifier to request cancellation for."
+    }
+  }
+}

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

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/clarify_intent.schema.json",
+  "title": "clarify_intent inputSchema",
+  "description": "Argument shape for the clarify_intent tool (Analyze, Publish Data, Build App). Reference advertised name: honua_clarify_intent. Re-runs grounding with the operator's answers merged in. Extends ground_candidates with required intentId and a response carrying answers keyed by questionId. See planning.md §2.",
+  "type": "object",
+  "required": ["goal", "intentId", "response"],
+  "properties": {
+    "goal": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Freeform natural-language description of the operator's goal."
+    },
+    "intentId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Intent identifier being clarified. Required on a clarification turn."
+    },
+    "workflowFamilyHint": {
+      "type": "string",
+      "enum": ["Analyze", "PublishData", "BuildApp", "AutomateDeploy"]
+    },
+    "assumptionPolicy": {
+      "type": "string",
+      "enum": ["AskAlways", "AskWhenMaterial", "UseDefaults"]
+    },
+    "explicitInputs": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "constraints": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "areaOfInterest": { "type": "string" },
+        "spatialReferenceId": { "type": "integer" },
+        "timeWindowStart": { "type": "string", "format": "date-time" },
+        "timeWindowEnd": { "type": "string", "format": "date-time" },
+        "units": { "type": "string" }
+      }
+    },
+    "context": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "workspaceId": { "type": "string" },
+        "priorIntentId": { "type": "string" },
+        "promotionScope": { "type": "string" }
+      }
+    },
+    "response": {
+      "type": "object",
+      "required": ["answers"],
+      "description": "ClarificationResponse: answers keyed by questionId.",
+      "properties": {
+        "answers": {
+          "type": "object",
+          "minProperties": 1,
+          "description": "Answers keyed by question identifier. Each answer is a non-empty list of values to support multi-select questions.",
+          "additionalProperties": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/compose_mixed_protocol_map.schema.json",
+  "title": "compose_mixed_protocol_map inputSchema",
+  "description": "Argument shape for compose_mixed_protocol_map (Analyze, Build App; returns a MapPackage). Composes a single map from layers bound across multiple protocols (GeoServices, OGC API, WMS/WFS, tiles) at the semantic level — protocol adaptation happens below the contract layer (taxonomy.md §Non-Goals 4). Responsibility-level; concrete binding field set finalizes upstream.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["sourceBindings"],
+  "properties": {
+    "templateId": { "type": "string" },
+    "sourceBindings": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Canonical SourceBinding entries, each protocol-aware. The tool does not expose protocol-specific operations.",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "styleId": { "type": "string" },
+    "themeId": { "type": "string" },
+    "initialView": { "type": "object", "additionalProperties": true }
+  }
+}

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

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/create_app_package.schema.json",
+  "title": "create_app_package inputSchema",
+  "description": "Argument shape for create_app_package (Build App; returns an AppPackage). Composes an SDK-native application from a map package, artifacts, and an app template. V1 targets honua-sdk-js with MapLibre GL JS. Responsibility-level: the AppPackage authoring field set finalizes upstream (honua-server#731). See taxonomy.md §App composition and resources.md §honua://app-packages/{app_package_id}.",
+  "type": "object",
+  "additionalProperties": true,
+  "properties": {
+    "templateId": {
+      "type": "string",
+      "description": "App-template registry identifier (surfaced through AppPackage.templateId)."
+    },
+    "targetSdk": {
+      "type": "string",
+      "description": "Target SDK declaration. V1 default is honua-sdk-js.",
+      "default": "honua-sdk-js"
+    },
+    "mapPackageId": {
+      "type": "string",
+      "description": "MapPackage (map_…) bound into the application."
+    },
+    "boundArtifactIds": {
+      "type": "array",
+      "description": "ArtifactRef identifiers (artifact_…) required at runtime.",
+      "items": { "type": "string" }
+    },
+    "runtimeConfig": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Runtime configuration values projected into the generated app."
+    }
+  }
+}

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

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/create_map_package.schema.json",
+  "title": "create_map_package inputSchema",
+  "description": "Argument shape for create_map_package (Analyze, Build App map-composition family; returns a MapPackage). Responsibility-level: the concrete MapPackage authoring field set is finalizing upstream (honua-server#731), so this schema pins the stable composition inputs (source bindings, style/theme selection, template, initial view) and permits additional properties. See taxonomy.md §Map composition and resources.md §honua://map-packages/{map_package_id}.",
+  "type": "object",
+  "additionalProperties": true,
+  "properties": {
+    "templateId": {
+      "type": "string",
+      "description": "Registry-defined MapTemplate identifier seeding the composition (e.g. analysis_default)."
+    },
+    "sourceBindings": {
+      "type": "array",
+      "description": "Protocol-aware bindings of map layers to data sources (canonical SourceBinding entries).",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "styleId": {
+      "type": "string",
+      "description": "StyleRef selection (style_… ) applied to the composition."
+    },
+    "themeId": {
+      "type": "string",
+      "description": "ThemeSpec selection (theme_… ) applied to the composition."
+    },
+    "initialView": {
+      "type": "object",
+      "description": "Initial view geometry: bounding box and CRS.",
+      "additionalProperties": true,
+      "properties": {
+        "bbox": {
+          "type": "array",
+          "minItems": 4,
+          "maxItems": 4,
+          "items": { "type": "number" }
+        },
+        "crs": { "type": ["string", "integer"] }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/execute_plan.schema.json",
+  "title": "execute_plan inputSchema",
+  "description": "Argument shape for the execute_plan tool (Analyze, Publish Data; handoff returns an ExecutionJob reference for Analyze). Reference advertised name: honua_execute_plan. Submission rejects a missing planId or empty steps, so the executable plan REQUIRES planId and at least one step (contrast validate_plan). See planning.md §5.2.",
+  "type": "object",
+  "required": ["plan"],
+  "properties": {
+    "plan": { "$ref": "#/$defs/executablePlan" },
+    "idempotencyKey": {
+      "type": "string",
+      "description": "Optional deduplication key. Replays with the same key return the same job record."
+    }
+  },
+  "$defs": {
+    "executablePlan": {
+      "type": "object",
+      "description": "Canonical AnalysisPlan in executable form. planId and a non-empty steps array are mandatory.",
+      "required": ["planId", "steps"],
+      "properties": {
+        "planId": { "type": "string", "minLength": 1 },
+        "intentId": { "type": "string" },
+        "steps": {
+          "type": "array",
+          "minItems": 1,
+          "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",
+      "enum": ["QueryFeatures", "Geoprocess", "Aggregate", "RenderMap", "Export"]
+    },
+    "artifactKind": {
+      "type": "string",
+      "enum": ["Scalar", "FeatureLayer", "Table", "Raster", "File", "Report", "Map", "AppBundle"]
+    }
+  }
+}

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

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/geocode_address.schema.json",
+  "title": "geocode_address inputSchema",
+  "description": "Argument shape for the analysis/geoprocessing geocode tool (advertised name honua_geocode_address). Resolves a freeform address to ranked candidates. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["address"],
+  "properties": {
+    "address": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Freeform single-line address text to geocode."
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 50,
+      "default": 5,
+      "description": "Maximum number of candidates to return."
+    },
+    "countryCodes": {
+      "type": "string",
+      "description": "Optional comma-separated ISO 3166 country codes to restrict the search."
+    },
+    "outSrid": {
+      "type": "integer",
+      "default": 4326,
+      "description": "Spatial reference (SRID/WKID) for returned candidate coordinates."
+    },
+    "provider": {
+      "type": "string",
+      "description": "Optional preferred geocoding provider name."
+    }
+  }
+}

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

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/get_style.schema.json",
+  "title": "get_style inputSchema",
+  "description": "Argument shape for get_style (Analyze, Publish Data, Build App). Read-only style inspection: with styleId, resolves a single canonical StyleRef (style_id/title/encodings) from the server OGC API – Styles surface; without styleId, lists the available styles (honua://styles). Like every MCP tool it is read-only and never mutates server-side styles. See taxonomy.md §Style inspection and resources.md §honua://styles/{style_id}.",
+  "type": "object",
+  "properties": {
+    "styleId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "StyleRef identifier (style_…) to resolve. When omitted, the tool lists the available styles (honua://styles)."
+    },
+    "encoding": {
+      "type": "string",
+      "description": "Optional StyleEncoding to select from StyleRef.encodings when resolving a single style.",
+      "enum": [
+        "mapbox-style",
+        "sld-1.0.0",
+        "sld-1.1.0",
+        "esri-drawing-info",
+        "esri-image-renderer",
+        "3d-tiles-styling"
+      ]
+    },
+    "includeStylesheet": {
+      "type": "boolean",
+      "description": "When true and styleId is set, include the resolved stylesheet body (inlineBody) for the selected encoding; otherwise the StyleRef projection advertises derived encodings by reference (storageRef)."
+    }
+  }
+}

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

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/ground_candidates.schema.json",
+  "title": "ground_candidates inputSchema",
+  "description": "Argument shape for the ground_candidates tool (Analyze, Publish Data). Reference advertised name: honua_ground_candidates. Grounds a natural-language goal to a workflow family, ranked candidates, a draft intent, and an optional clarification envelope. See taxonomy.md §Intent and planning and planning.md §2.",
+  "type": "object",
+  "required": ["goal"],
+  "properties": {
+    "goal": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Freeform natural-language description of the operator's goal."
+    },
+    "intentId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Intent identifier. Optional on the initial grounding call (server allocates one); required on a clarification turn."
+    },
+    "workflowFamilyHint": {
+      "type": "string",
+      "description": "Optional workflow-family override (one of the canonical WorkflowFamily names).",
+      "enum": ["Analyze", "PublishData", "BuildApp", "AutomateDeploy"]
+    },
+    "assumptionPolicy": {
+      "type": "string",
+      "description": "Policy controlling when inferred assumptions trigger a clarification. See planning.md §2.3.",
+      "enum": ["AskAlways", "AskWhenMaterial", "UseDefaults"]
+    },
+    "explicitInputs": {
+      "type": "array",
+      "description": "Dataset, layer, or artifact identifiers the caller has already pinned.",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "constraints": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Optional analysis constraints.",
+      "properties": {
+        "areaOfInterest": {
+          "type": "string",
+          "description": "AOI as WKT, bounding-box string, or named area."
+        },
+        "spatialReferenceId": {
+          "type": "integer",
+          "description": "EPSG SRID for the AOI (defaults to 4326)."
+        },
+        "timeWindowStart": { "type": "string", "format": "date-time" },
+        "timeWindowEnd": { "type": "string", "format": "date-time" },
+        "units": {
+          "type": "string",
+          "description": "Preferred unit system (e.g. 'meters', 'feet')."
+        }
+      }
+    },
+    "context": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Optional workflow context.",
+      "properties": {
+        "workspaceId": { "type": "string" },
+        "priorIntentId": { "type": "string" },
+        "promotionScope": { "type": "string" }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/list_capabilities.schema.json",
+  "title": "list_capabilities inputSchema",
+  "description": "Argument shape for enumerating the server's full tool/resource surface plus grounding resources for a cold client LLM. The bare standard taxonomy models capability discovery as a CapabilityCatalog read; the reference implementation exposes it as a discrete tool (advertised name honua_list_capabilities). 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",
+  "properties": {
+    "includeResources": {
+      "type": "boolean",
+      "default": true,
+      "description": "Include the resource catalog (job, catalog, and promotion URIs) in the manifest."
+    },
+    "includeGroundingResources": {
+      "type": "boolean",
+      "default": true,
+      "description": "Include the grounding/catalog resource URIs a client LLM should read first to ground a workflow."
+    }
+  }
+}

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

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/list_layers.schema.json",
+  "title": "list_layers inputSchema",
+  "description": "Argument shape for the discovery/query layer-listing tool. The bare standard taxonomy models discovery as a CapabilityCatalog read; the reference implementation exposes it as a tool (advertised name honua_list_layers) over the open-core data-access surface. x-honua-reference-shape: this shape tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "properties": {
+    "filter": {
+      "type": "string",
+      "description": "Optional case-insensitive substring to match against service and layer name/title. When omitted, all published layers are returned."
+    }
+  }
+}

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

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/plan_analysis.schema.json",
+  "title": "plan_analysis inputSchema",
+  "description": "Argument shape for the plan_analysis tool (Analyze family; emits an AnalysisPlan). Reference advertised name: honua_plan_analysis. Compiles a natural-language intent into an analysis plan / canonical spec draft. See taxonomy.md §Intent and planning.",
+  "type": "object",
+  "required": ["intent"],
+  "properties": {
+    "intent": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Natural-language intent to compile into an analysis plan or canonical spec draft."
+    },
+    "context": {
+      "type": "object",
+      "description": "Optional caller context. Echoed back unchanged by the reference implementation."
+    }
+  }
+}

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

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/preview_app_package.schema.json",
+  "title": "preview_app_package inputSchema",
+  "description": "Argument shape for preview_app_package (Build App; returns a preview ArtifactRef). Produces a read-only preview artifact for an existing app package. Responsibility-level. See taxonomy.md §App composition.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["appPackageId"],
+  "properties": {
+    "appPackageId": {
+      "type": "string",
+      "description": "Identifier (app_…) of the AppPackage to preview."
+    }
+  }
+}

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

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/preview_map_package.schema.json",
+  "title": "preview_map_package inputSchema",
+  "description": "Argument shape for preview_map_package (Analyze, Build App; returns a preview ArtifactRef). Produces a read-only preview artifact for an existing map package. Responsibility-level. See taxonomy.md §Map composition.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["mapPackageId"],
+  "properties": {
+    "mapPackageId": {
+      "type": "string",
+      "description": "Identifier (map_…) of the MapPackage to preview."
+    },
+    "width": { "type": "integer", "minimum": 1 },
+    "height": { "type": "integer", "minimum": 1 }
+  }
+}

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

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/preview_package.schema.json",
+  "title": "preview_package inputSchema",
+  "description": "Argument shape for the read-only composition-review tool (advertised name honua_preview_package). Computes a read-only preview plan for a map/app package before publishing, in addition to the requirement-coverage review; it never mutates server state. x-honua-reference-shape: tracks the reference implementation; the bare taxonomy models package preview 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."
+    },
+    "estimate": {
+      "type": "object",
+      "description": "Optional upstream estimate echoed in the shared package-review response."
+    },
+    "includePreviewPlan": { "type": "boolean" },
+    "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/propose_operation.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/propose_operation.schema.json",
+  "title": "propose_operation inputSchema",
+  "description": "Argument shape for the control-plane proposal tool (advertised name honua_propose_operation). Proposes an in-scope mutating control-plane operation for human approval (never autonomously executed), consistent with the ADR-0028 no-direct-AI-mutation boundary in taxonomy.md §Non-Goals. x-honua-reference-shape: tracks the reference implementation.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["kind"],
+  "properties": {
+    "kind": {
+      "type": "string",
+      "description": "In-scope mutating control-plane operation class to propose.",
+      "enum": ["AdminConfigChange", "Deploy", "MetadataRelease", "Seed"]
+    },
+    "reason": {
+      "type": "string",
+      "description": "Operator-facing reason or change note for the proposal."
+    },
+    "executionPayload": {
+      "type": "string",
+      "description": "Opaque, class-specific JSON execution payload replayed when the proposal is approved."
+    },
+    "idempotencyKey": {
+      "type": "string",
+      "description": "Stable idempotency key for the underlying operation."
+    }
+  }
+}