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

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

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/resources/result-package.schema.json",
+  "title": "Result package resource payload",
+  "description": "Read-only projection returned for honua://results/{result_package_id} (AnalysisResultPackage). See resources.md §Result Package Resources.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["resultPackageId", "status"],
+  "properties": {
+    "resultPackageId": {
+      "type": "string",
+      "description": "Stable identifier (result_…)."
+    },
+    "status": {
+      "type": "string",
+      "description": "GeoprocessingWorkflowStatus (read-only).",
+      "enum": [
+        "Draft",
+        "AwaitingClarification",
+        "Validated",
+        "AwaitingApproval",
+        "AwaitingExecution",
+        "Running",
+        "Completed",
+        "Failed",
+        "Cancelled"
+      ]
+    },
+    "summary": {
+      "type": "object",
+      "description": "Title and description.",
+      "additionalProperties": true,
+      "properties": {
+        "title": { "type": "string" },
+        "description": { "type": "string" }
+      }
+    },
+    "assumptions": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "artifacts": {
+      "type": "array",
+      "items": { "$ref": "artifact.schema.json" }
+    },
+    "workspaceRefs": {
+      "type": "array",
+      "items": { "$ref": "workspace.schema.json" }
+    },
+    "mapPackageId": {
+      "type": "string",
+      "description": "Deferred reference to a MapPackage (map_…)."
+    },
+    "appPackageId": {
+      "type": "string",
+      "description": "Deferred reference to an AppPackage (app_…)."
+    },
+    "provenance": { "$ref": "provenance.schema.json" },
+    "errors": {
+      "type": "array",
+      "items": { "$ref": "../common/geoprocessing-error.schema.json" }
+    }
+  }
+}

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

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/resources/style.schema.json",
+  "title": "Style resource payload",
+  "description": "Responsibility-level projection of a StyleRef at honua://styles/{style_id}. Concrete field spellings are upstream-owned; only the stable styleId is pinned. Responsibilities: thematic renderer selection, style preset reuse/composition, label/popup bindings, legend-generation inputs. See resources.md §honua://styles/{style_id}.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["styleId"],
+  "properties": {
+    "styleId": { "type": "string", "description": "Stable identifier (style_…)." }
+  }
+}

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

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/resources/theme.schema.json",
+  "title": "Theme resource payload",
+  "description": "Responsibility-level projection of a ThemeSpec at honua://themes/{theme_id}. Concrete field spellings are upstream-owned; only the stable themeId is pinned. Responsibilities: color-ramp tokens, typography tokens, spacing/panel chrome, semantic status colors. See resources.md §honua://themes/{theme_id}.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["themeId"],
+  "properties": {
+    "themeId": { "type": "string", "description": "Stable identifier (theme_…)." }
+  }
+}

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,27 @@
+{
+  "$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. x-honua-reference-shape: this shape tracks the reference implementation (advertised name honua_apply_style_preset), which applies a reusable StyleRef preset (a catalog styleId) as the primary/default style of a published layer, persisting through the server OGC API – Styles authoring surface (ADR-0048) so subsequent render_map calls reflect it. The bare taxonomy responsibility (map-package composition) is described in taxonomy.md §Map composition; the reference implementation binds presets to published layers rather than to an in-memory MapPackage. Applying a preset never edits feature records (ADR-0028); it authors presentation metadata on the hosted service. See taxonomy.md §Map composition and resources.md §honua://styles.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["serviceId", "layerId", "styleId"],
+  "properties": {
+    "serviceId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Published service identifier or name whose layer is being styled."
+    },
+    "layerId": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Service-local layer index to apply the preset to."
+    },
+    "styleId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "StyleRef preset identifier (style_…) to apply as the layer's primary/default style. Discover the available presets with get_style (no styleId lists honua://styles)."
+    }
+  }
+}

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

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/buffer_features.schema.json",
+  "title": "buffer_features inputSchema",
+  "description": "Direct geoprocessing verb (advertised name honua_buffer_features): buffer input features by a distance and return the buffer polygons. Use this for a single self-contained buffer step (\"buffer these roads by 500 m\"); for multi-step analysis with dependencies, clarification, 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 — the same handoff execute_plan uses. 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", "distance"],
+  "properties": {
+    "source": {
+      "description": "Dataset to buffer: EITHER a published layer (serviceId + layerId) OR a prior-result artifact (artifactId) from an earlier analysis job or verb.",
+      "oneOf": [
+        { "$ref": "#/$defs/layerRef" },
+        { "$ref": "#/$defs/artifactRef" }
+      ]
+    },
+    "distance": {
+      "type": "number",
+      "description": "Buffer distance in the given unit. Negative distances buffer inward for polygon inputs."
+    },
+    "unit": {
+      "type": "string",
+      "default": "meters",
+      "enum": ["meters", "kilometers", "feet", "miles", "nautical_miles", "degrees"],
+      "description": "Linear unit of distance."
+    },
+    "dissolve": {
+      "type": "boolean",
+      "default": false,
+      "description": "When true, overlapping buffers are dissolved into a single geometry; when false, one buffer per input feature is returned."
+    },
+    "where": {
+      "type": "string",
+      "description": "Optional attribute filter (ArcGIS/SQL WHERE clause) selecting which input features to buffer."
+    },
+    "outSrid": {
+      "type": "integer",
+      "description": "Output spatial reference (SRID/WKID) for the returned buffers; defaults to the source CRS. Buffer distances are always measured in the given unit regardless of outSrid."
+    }
+  },
+  "$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/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/edit_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/edit_features.schema.json",
+  "title": "edit_features inputSchema",
+  "description": "Argument shape for the transactional feature-editing tool (advertised name honua_edit_features). edit_features is the sole member of the standard's **mutation** conformance profile (see /CONFORMANCE.md and docs/adr/0028-governed-feature-mutation.md): it applies adds/updates/deletes to a single published editable layer as one all-or-nothing transaction when rollbackOnFailure=true (the default). It is governed mutation, not autonomous mutation: an implementation MUST require an authenticated, authorized caller and MUST authorize each edit type independently (insert for adds, update for updates, delete for deletes), rejecting the whole request before any edit is applied if any required permission is missing. An implementation MAY be read-only and still conform to the base profile by not advertising this tool. x-honua-reference-shape: the concrete objectId/globalId/attributes spellings track the reference implementation's shared edit/transaction pipeline; see taxonomy.md §Feature editing (mutation profile).",
+  "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 or resolve_entity)."
+    },
+    "layerId": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Service-local layer index of the editable layer (from list_layers.layerId)."
+    },
+    "srid": {
+      "type": "integer",
+      "default": 4326,
+      "description": "Spatial reference (SRID/WKID) of the input feature geometries."
+    },
+    "adds": {
+      "type": "array",
+      "description": "Features to insert. Requires insert authorization on the target layer. Object IDs are assigned by the store.",
+      "items": { "$ref": "#/$defs/editFeature" }
+    },
+    "updates": {
+      "type": "array",
+      "description": "Features to update. Requires update authorization on the target layer. Each MUST carry an objectId identifying the existing feature.",
+      "items": { "$ref": "#/$defs/editFeature" }
+    },
+    "deletes": {
+      "type": "array",
+      "description": "Object IDs of features to delete. Requires delete authorization on the target layer.",
+      "items": { "type": "integer" }
+    },
+    "rollbackOnFailure": {
+      "type": "boolean",
+      "default": true,
+      "description": "When true (the default), any failed edit rolls back the whole transaction (all-or-nothing) and the layer is left unchanged; when false, successful edits commit independently and per-edit failures are reported."
+    },
+    "returnEditResults": {
+      "type": "boolean",
+      "default": true,
+      "description": "When true, per-edit results are returned; when false only the transaction summary is emitted."
+    }
+  },
+  "$defs": {
+    "editFeature": {
+      "type": "object",
+      "properties": {
+        "objectId": {
+          "type": "integer",
+          "description": "Object ID of the target feature. Required for updates; ignored for adds."
+        },
+        "globalId": {
+          "type": "string",
+          "description": "Optional global ID of the feature."
+        },
+        "geometry": {
+          "type": ["object", "null"],
+          "description": "RFC 7946 GeoJSON geometry object (e.g. {\"type\":\"Point\",\"coordinates\":[1,2]})."
+        },
+        "attributes": {
+          "type": "object",
+          "description": "Flat attribute name/value map applied to the feature."
+        }
+      }
+    }
+  }
+}

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/export_dataset.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://geospatial-mcp.honua.io/spec/schemas/tools/export_dataset.schema.json",
+  "title": "export_dataset inputSchema",
+  "description": "Direct geoprocessing verb (advertised name honua_export_dataset): materialize a dataset — a published layer or a prior verb/job result — into a downloadable artifact in the requested format and return an ArtifactRef with a content locator. Use this for a single self-contained export step (\"export the intersect result as GeoPackage\"); 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 referencing the produced artifact. Advertised readOnlyHint: false — it writes a new downloadable artifact — but non-destructive (it creates a new artifact and mutates no source records) and idempotent. It is NOT feature mutation and is not part of the mutation profile. x-honua-reference-shape: the concrete source (serviceId/layerId, artifactId) spellings track the reference pipeline.",
+  "x-honua-reference-shape": true,
+  "type": "object",
+  "required": ["source", "format"],
+  "properties": {
+    "source": {
+      "description": "Dataset to export: EITHER a published layer (serviceId + layerId) OR a prior-result artifact (artifactId) from an earlier analysis job or verb.",
+      "oneOf": [
+        { "$ref": "#/$defs/layerRef" },
+        { "$ref": "#/$defs/artifactRef" }
+      ]
+    },
+    "format": {
+      "type": "string",
+      "enum": ["geojson", "geopackage", "csv", "parquet"],
+      "description": "Output format. geojson: RFC 7946 features. geopackage: OGC GeoPackage (.gpkg). csv: attribute rows (geometry as WKT when returnGeometry). parquet: (Geo)Parquet columnar."
+    },
+    "where": {
+      "type": "string",
+      "description": "Optional attribute filter (ArcGIS/SQL WHERE clause) selecting which features to export."
+    },
+    "outFields": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional attribute fields to include; omit for all fields."
+    },
+    "returnGeometry": {
+      "type": "boolean",
+      "default": true,
+      "description": "When false, export attributes only (no geometry). csv/parquet exports of attribute tables commonly set this false."
+    },
+    "outSrid": {
+      "type": "integer",
+      "description": "Output spatial reference (SRID/WKID) for exported geometries; defaults to the source CRS."
+    }
+  },
+  "$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." }
+      }
+    }
+  }
+}