clio-kit 2.3.2__tar.gz → 2.4.1__tar.gz

{clio_kit-2.3.2 → clio_kit-2.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clio-kit
-Version: 2.3.2
+Version: 2.4.1
 Summary: CLIO Kit - MCP Servers, Clients, and Tools for AI Agents
 Project-URL: Homepage, https://github.com/iowarp/clio-kit
 Project-URL: Repository, https://github.com/iowarp/clio-kit
@@ -107,11 +107,11 @@ CLIO Kit is part of the IoWarp platform's comprehensive tooling ecosystem for AI
 
 ```bash
 # Install the released CLI into its own persistent tool environment
-uv tool install 'clio-kit==2.3.2'
+uv tool install 'clio-kit==2.4.0'
 # If uv reports that its executable directory is not on PATH:
 uv tool update-shell
 
-# List all 22 available MCP servers
+# List all 23 available MCP servers
 clio-kit mcp-servers
 
 # Run any installed server
@@ -129,7 +129,7 @@ clio-kit prompt code-coverage-prompt # Use a prompt
 ```
 
 `uv tool install` keeps CLIO Kit in a persistent, isolated tool environment.
-Use `uvx --from 'clio-kit==2.3.2' clio-kit ...` only for a temporary, one-shot
+Use `uvx --from 'clio-kit==2.4.0' clio-kit ...` only for a temporary, one-shot
 invocation.
 
 Released `clio-kit` wheels execute each embedded MCP server from that server's
@@ -140,14 +140,16 @@ option is an explicit development path and is not an immutable
 release-artifact path.
 
 The root wheel also ships machine-readable user contracts for the locked
-JARVIS, SLURM, and Spack servers. These artifacts are generated from real stdio
+JARVIS, SLURM, Spack, and Scientific Catalog servers. These artifacts are generated from real stdio
 `tools/list` exchanges and include canonical SHA-256 digests for downstream
 federation gates:
 
 ```bash
 clio-kit mcp-contracts
+clio-kit mcp-contract clio-kit-jarvis-user-v3.1
 clio-kit mcp-contract clio-kit-slurm-user-v3
 clio-kit mcp-contract clio-kit-spack-user-v2
+clio-kit mcp-contract clio-kit-scientific-catalog-user-v1
 ```
 
 <details>
@@ -249,8 +251,8 @@ See [Claude Desktop MCP docs](https://modelcontextprotocol.io/quickstart/user) f
 ## Available Packages
 
 The version below is each MCP server's agent-facing contract version, not the
-containing `clio-kit` wheel version. JARVIS and SLURM are 3.0 because their
-contracts were redesigned for agent use. Spack is at 2.0, while the other
+containing `clio-kit` wheel version. JARVIS 3.1 and SLURM 3.0 have contracts
+redesigned for agent use. Spack is at 2.0, while the other
 contracts retain their existing 2.x identities until a focused upgrade.
 
 The Spack install contract makes concretization explicit: `reuse=true` passes
@@ -270,7 +272,7 @@ Agents should discover first, install only when needed, then pass the exact
 | **`geo`** | 2.2.3 | Geospatial | Render GeoJSON vector layers with basemaps | `clio-kit mcp-server geo` |
 | **`geojson`** | 2.2.3 | Geospatial | Inspect, validate, and summarize GeoJSON | `clio-kit mcp-server geojson` |
 | **`hdf5`** | 2.2.3 | Data I/O | HPC-optimized scientific data with 27 tools, AI insights, caching, streaming | `clio-kit mcp-server hdf5` |
-| **`jarvis`** | 3.0.0 | Workflow | Data pipeline lifecycle management | `clio-kit mcp-server jarvis` |
+| **`jarvis`** | 3.1.0 | Workflow | Durable pipeline, progress, artifact, and service-runtime management | `clio-kit mcp-server jarvis` |
 | **`lmod`** | 2.2.3 | Environment | Environment module management | `clio-kit mcp-server lmod` |
 | **`ndp`** | 2.2.3 | Data Protocol | Search and discover datasets across CKAN instances | `clio-kit mcp-server ndp` |
 | **`node-hardware`** | 2.2.3 | System | System hardware information | `clio-kit mcp-server node-hardware` |
@@ -281,6 +283,7 @@ Agents should discover first, install only when needed, then pass the exact
 | **`plot`** | 2.2.3 | Visualization | Generate plots from CSV data | `clio-kit mcp-server plot` |
 | **`sac`** | 2.2.3 | Seismology | Analyze SAC waveforms and archives | `clio-kit mcp-server sac` |
 | **`seismic`** | 2.2.3 | Seismology | Analyze earthquake catalogs and sequences | `clio-kit mcp-server seismic` |
+| **`scientific-catalog`** | 1.0.0 | Discovery | Operator-owned scientific dataset discovery | `clio-kit mcp-server scientific-catalog` |
 | **`slurm`** | 3.0.0 | HPC | Job submission and management | `clio-kit mcp-server slurm` |
 | **`spack`** | 2.0.1 | Package Management | Structured package discovery, installation, and location | `clio-kit mcp-server spack` |
 | **`terrain`** | 2.2.3 | Geospatial | Analyze DEMs and terrain point clouds | `clio-kit mcp-server terrain` |
@@ -410,7 +413,7 @@ pip install uv
 Then install CLIO Kit persistently and expose uv's tool directory:
 
 ```bash
-uv tool install 'clio-kit==2.3.2'
+uv tool install 'clio-kit==2.4.0'
 uv tool update-shell
 ```
 

{clio_kit-2.3.2 → clio_kit-2.4.1}/README.md

@@ -81,11 +81,11 @@ CLIO Kit is part of the IoWarp platform's comprehensive tooling ecosystem for AI
 
 ```bash
 # Install the released CLI into its own persistent tool environment
-uv tool install 'clio-kit==2.3.2'
+uv tool install 'clio-kit==2.4.0'
 # If uv reports that its executable directory is not on PATH:
 uv tool update-shell
 
-# List all 22 available MCP servers
+# List all 23 available MCP servers
 clio-kit mcp-servers
 
 # Run any installed server
@@ -103,7 +103,7 @@ clio-kit prompt code-coverage-prompt # Use a prompt
 ```
 
 `uv tool install` keeps CLIO Kit in a persistent, isolated tool environment.
-Use `uvx --from 'clio-kit==2.3.2' clio-kit ...` only for a temporary, one-shot
+Use `uvx --from 'clio-kit==2.4.0' clio-kit ...` only for a temporary, one-shot
 invocation.
 
 Released `clio-kit` wheels execute each embedded MCP server from that server's
@@ -114,14 +114,16 @@ option is an explicit development path and is not an immutable
 release-artifact path.
 
 The root wheel also ships machine-readable user contracts for the locked
-JARVIS, SLURM, and Spack servers. These artifacts are generated from real stdio
+JARVIS, SLURM, Spack, and Scientific Catalog servers. These artifacts are generated from real stdio
 `tools/list` exchanges and include canonical SHA-256 digests for downstream
 federation gates:
 
 ```bash
 clio-kit mcp-contracts
+clio-kit mcp-contract clio-kit-jarvis-user-v3.1
 clio-kit mcp-contract clio-kit-slurm-user-v3
 clio-kit mcp-contract clio-kit-spack-user-v2
+clio-kit mcp-contract clio-kit-scientific-catalog-user-v1
 ```
 
 <details>
@@ -223,8 +225,8 @@ See [Claude Desktop MCP docs](https://modelcontextprotocol.io/quickstart/user) f
 ## Available Packages
 
 The version below is each MCP server's agent-facing contract version, not the
-containing `clio-kit` wheel version. JARVIS and SLURM are 3.0 because their
-contracts were redesigned for agent use. Spack is at 2.0, while the other
+containing `clio-kit` wheel version. JARVIS 3.1 and SLURM 3.0 have contracts
+redesigned for agent use. Spack is at 2.0, while the other
 contracts retain their existing 2.x identities until a focused upgrade.
 
 The Spack install contract makes concretization explicit: `reuse=true` passes
@@ -244,7 +246,7 @@ Agents should discover first, install only when needed, then pass the exact
 | **`geo`** | 2.2.3 | Geospatial | Render GeoJSON vector layers with basemaps | `clio-kit mcp-server geo` |
 | **`geojson`** | 2.2.3 | Geospatial | Inspect, validate, and summarize GeoJSON | `clio-kit mcp-server geojson` |
 | **`hdf5`** | 2.2.3 | Data I/O | HPC-optimized scientific data with 27 tools, AI insights, caching, streaming | `clio-kit mcp-server hdf5` |
-| **`jarvis`** | 3.0.0 | Workflow | Data pipeline lifecycle management | `clio-kit mcp-server jarvis` |
+| **`jarvis`** | 3.1.0 | Workflow | Durable pipeline, progress, artifact, and service-runtime management | `clio-kit mcp-server jarvis` |
 | **`lmod`** | 2.2.3 | Environment | Environment module management | `clio-kit mcp-server lmod` |
 | **`ndp`** | 2.2.3 | Data Protocol | Search and discover datasets across CKAN instances | `clio-kit mcp-server ndp` |
 | **`node-hardware`** | 2.2.3 | System | System hardware information | `clio-kit mcp-server node-hardware` |
@@ -255,6 +257,7 @@ Agents should discover first, install only when needed, then pass the exact
 | **`plot`** | 2.2.3 | Visualization | Generate plots from CSV data | `clio-kit mcp-server plot` |
 | **`sac`** | 2.2.3 | Seismology | Analyze SAC waveforms and archives | `clio-kit mcp-server sac` |
 | **`seismic`** | 2.2.3 | Seismology | Analyze earthquake catalogs and sequences | `clio-kit mcp-server seismic` |
+| **`scientific-catalog`** | 1.0.0 | Discovery | Operator-owned scientific dataset discovery | `clio-kit mcp-server scientific-catalog` |
 | **`slurm`** | 3.0.0 | HPC | Job submission and management | `clio-kit mcp-server slurm` |
 | **`spack`** | 2.0.1 | Package Management | Structured package discovery, installation, and location | `clio-kit mcp-server spack` |
 | **`terrain`** | 2.2.3 | Geospatial | Analyze DEMs and terrain point clouds | `clio-kit mcp-server terrain` |
@@ -384,7 +387,7 @@ pip install uv
 Then install CLIO Kit persistently and expose uv's tool directory:
 
 ```bash
-uv tool install 'clio-kit==2.3.2'
+uv tool install 'clio-kit==2.4.0'
 uv tool update-shell
 ```
 

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/adios/server.json

@@ -12,7 +12,7 @@
     {
       "registryType": "pypi",
       "identifier": "clio-kit",
-      "version": "2.3.2",
+      "version": "2.4.1",
       "transport": {
         "type": "stdio"
       },

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/arxiv/server.json

@@ -12,7 +12,7 @@
     {
       "registryType": "pypi",
       "identifier": "clio-kit",
-      "version": "2.3.2",
+      "version": "2.4.1",
       "transport": {
         "type": "stdio"
       },

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/chronolog/server.json

@@ -12,7 +12,7 @@
     {
       "registryType": "pypi",
       "identifier": "clio-kit",
-      "version": "2.3.2",
+      "version": "2.4.1",
       "transport": {
         "type": "stdio"
       },

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/compression/server.json

@@ -12,7 +12,7 @@
     {
       "registryType": "pypi",
       "identifier": "clio-kit",
-      "version": "2.3.2",
+      "version": "2.4.1",
       "transport": {
         "type": "stdio"
       },

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/darshan/server.json

@@ -12,7 +12,7 @@
     {
       "registryType": "pypi",
       "identifier": "clio-kit",
-      "version": "2.3.2",
+      "version": "2.4.1",
       "transport": {
         "type": "stdio"
       },

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/geo/server.json

@@ -12,7 +12,7 @@
     {
       "registryType": "pypi",
       "identifier": "clio-kit",
-      "version": "2.3.2",
+      "version": "2.4.1",
       "transport": {
         "type": "stdio"
       },

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/geojson/server.json

@@ -12,7 +12,7 @@
     {
       "registryType": "pypi",
       "identifier": "clio-kit",
-      "version": "2.3.2",
+      "version": "2.4.1",
       "transport": {
         "type": "stdio"
       },

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/hdf5/server.json

@@ -12,7 +12,7 @@
     {
       "registryType": "pypi",
       "identifier": "clio-kit",
-      "version": "2.3.2",
+      "version": "2.4.1",
       "transport": {
         "type": "stdio"
       },

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/jarvis/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "clio-jarvis",
   "description": "JARVIS-CD MCP with a compact user pipeline contract and explicit admin compatibility profiles",
-  "version": "3.0.0"
+  "version": "3.1.0"
 }

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/jarvis/README.md

@@ -145,6 +145,14 @@ query for an execution. It always returns the exact handle, latest record, and
 runtime metadata, and includes the generic package progress snapshot by
 default. Set `include_progress=false` when only lifecycle state is needed.
 
+Execution-owned network services are also selectable through this same query,
+not a separate tool. Set `include_service_runtimes=true` to receive the exact
+`jarvis.execution.service-runtimes.v1` snapshot, including durable lifecycle,
+service instance identity, private endpoint metadata, and the intrinsic
+`jarvis.dataset-descriptor.v1`. JARVIS owns and validates these records; the MCP
+does not scrape stdout or infer a service from process text. Private cluster
+endpoints are routing inputs for clio-relay, not browser URLs.
+
 Artifacts are opt-in so routine polling stays compact. Pass `artifacts={}` for
 the default bounded page, or provide exact `package_id`, `role`, `state`, and
 `artifact_id` filters plus `page_size` and `cursor`. The page size defaults to
@@ -154,9 +162,10 @@ artifact or execution state changed between pages. References include opaque
 artifact IDs, lifecycle state, role, structure, ownership, metadata, and
 transport-neutral locations. The MCP does not read or transfer artifact
 content or interpret application-specific formats. The fixed response always
-contains nullable `progress` and `artifact_page` keys, so selecting less data
-does not change its shape. `include_progress=false` suppresses only the progress
-snapshot; runtime paths and package provenance remain available.
+contains nullable `progress`, `artifact_page`, and `service_runtimes` keys, so
+selecting less data does not change its shape. `include_progress=false`
+suppresses only the progress snapshot; runtime paths and package provenance
+remain available.
 
 The query retries boundedly if execution state changes while JARVIS is reading
 the record, progress, and artifact manifests, so one response cannot mix
@@ -167,7 +176,7 @@ agent can restart pagination from the first page without parsing prose. This
 works for direct executions with no scheduler, scheduler executions before or
 after allocation, and terminal executions.
 Successful `jarvis_run` results use `clio-kit.jarvis-run.v1`; unified execution
-queries use `clio-kit.jarvis-execution.v1`.
+queries use `clio-kit.jarvis-execution.v2`.
 
 ## Claude Code
 
@@ -230,7 +239,7 @@ uv --directory clio-kit-mcp-servers/jarvis run pytest -q
 **Tags**: jarvis, pipeline, user
 
 ### `jarvis_get_execution`
-**Description**: Query a durable JARVIS execution, optionally including package progress and one bounded page of generated-artifact references.
+**Description**: Query a durable JARVIS execution, optionally including package progress, execution-owned service runtimes, and one bounded page of generated-artifact references.
 **Hints**: read-only, idempotent
 **Tags**: jarvis, pipeline, execution, user
 

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/jarvis/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "jarvis-mcp"
-version = "2.0.0"
+version = "3.1.0"
 description = "JARVIS-CD MCP with a compact user pipeline contract and explicit admin compatibility profiles"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -15,7 +15,7 @@ dependencies = [
   "fastmcp>=3.2.0",
   "fastapi",
   "python-dotenv>=1.2.2",
-  "jarvis-cd @ https://github.com/grc-iit/jarvis-cd/releases/download/v1.2.2/jarvis_cd-1.2.2-py3-none-any.whl#sha256=f05454718a4efe4dadebefb98c83511ba3dcc662238c0c05430a1b621a8ab8b7",
+  "jarvis-cd @ https://github.com/grc-iit/jarvis-cd/releases/download/v1.3.1/jarvis_cd-1.3.1-py3-none-any.whl#sha256=08411d49f8d457ec8a1a73ad9eacc71416a17919733682acee7e28e0011d8cea",
   "starlette>=1.3.1",
   "authlib>=1.6.12",
   "cryptography>=48.0.1",

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/jarvis/scripts/live_ares_semantic_mcp_probe.py

@@ -18,13 +18,13 @@ from urllib.parse import urlsplit
 
 
 Json = dict[str, Any]
-EXPECTED_JARVIS_VERSION = "1.2.2"
+EXPECTED_JARVIS_VERSION = "1.3.1"
 EXPECTED_JARVIS_URL = (
-    "https://github.com/grc-iit/jarvis-cd/releases/download/v1.2.2/"
-    "jarvis_cd-1.2.2-py3-none-any.whl"
+    "https://github.com/grc-iit/jarvis-cd/releases/download/v1.3.1/"
+    "jarvis_cd-1.3.1-py3-none-any.whl"
 )
 EXPECTED_JARVIS_SHA256 = (
-    "f05454718a4efe4dadebefb98c83511ba3dcc662238c0c05430a1b621a8ab8b7"
+    "08411d49f8d457ec8a1a73ad9eacc71416a17919733682acee7e28e0011d8cea"
 )
 
 
@@ -689,7 +689,7 @@ def main() -> int:
         )
         execution_payload = _tool_payload(execution_result)
         assert execution_payload.get("schema_version") == (
-            "clio-kit.jarvis-execution.v1"
+            "clio-kit.jarvis-execution.v2"
         ), execution_payload
         progress_payload = execution_payload.get("progress")
         assert isinstance(progress_payload, dict), execution_payload

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/jarvis/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.iowarp/jarvis-mcp",
   "title": "CLIO Jarvis",
   "description": "JARVIS-CD MCP with a compact user pipeline contract and explicit admin compatibility profiles",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "repository": {
     "url": "https://github.com/iowarp/clio-kit",
     "source": "github"
@@ -12,7 +12,7 @@
     {
       "registryType": "pypi",
       "identifier": "clio-kit",
-      "version": "2.3.2",
+      "version": "2.4.1",
       "transport": {
         "type": "stdio"
       },
@@ -51,7 +51,7 @@
     },
     {
       "name": "jarvis_get_execution",
-      "description": "Query one JARVIS execution handle, durable lifecycle record, and runtime metadata. Progress is included by default and can be omitted. Set artifacts to {} or filters to include one bounded artifact page; omit artifacts to avoid querying the artifact manifest."
+      "description": "Query one JARVIS execution handle, durable lifecycle record, and runtime metadata. Progress is included by default and can be omitted. Set include_service_runtimes=true to include execution-owned network services such as an interactive ParaView runtime. Set artifacts to {} or filters to include one bounded artifact page; omit artifacts to avoid querying the artifact manifest."
     }
   ],
   "resources": [

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/jarvis/src/jarvis_mcp/capabilities/__init__.py

@@ -3,12 +3,12 @@ Jarvis MCP Server
 
 Jarvis-CD MCP - Pipeline Management for High-Performance Computing with comprehensive workflow operations
 
-Version: 2.0.0
+Version: 3.1.0
 Author: IoWarp Team - Gnosis Research Center
 License: BSD-3-Clause
 """
 
-__version__ = "2.0.0"
+__version__ = "3.1.0"
 __author__ = "IoWarp Team - Gnosis Research Center"
 __email__ = "grc@illinoistech.edu"
 __license__ = "BSD-3-Clause"

{clio_kit-2.3.2 → clio_kit-2.4.1}/clio-kit-mcp-servers/jarvis/src/jarvis_mcp/capabilities/jarvis_handler.py

@@ -41,7 +41,7 @@ from jarvis_mcp.progress import (
 RUNTIME_METADATA_SCHEMA = "jarvis.runtime.v1"
 RUNTIME_ERROR_SCHEMA = "jarvis.error.v1"
 RUN_RESULT_SCHEMA = "clio-kit.jarvis-run.v1"
-EXECUTION_QUERY_SCHEMA = "clio-kit.jarvis-execution.v1"
+EXECUTION_QUERY_SCHEMA = "clio-kit.jarvis-execution.v2"
 _EXECUTION_QUERY_CONSISTENCY_ATTEMPTS = 4
 _EXECUTION_QUERY_RETRY_DELAY_SECONDS = 0.02
 _MAX_SPACK_SPECS = 32
@@ -771,9 +771,10 @@ async def get_execution(
     execution_id: str,
     *,
     include_progress: bool = True,
+    include_service_runtimes: bool = False,
     artifacts: dict[str, Any] | None = None,
 ) -> dict[str, Any]:
-    """Return one durable execution view with optional progress and artifacts."""
+    """Return one durable execution view with selectable owned semantics."""
     validated_pipeline = _validate_pipeline_id(pipeline_id)
     try:
         validated_execution = _native_execution_id(execution_id)
@@ -810,6 +811,15 @@ async def get_execution(
                     if artifacts is not None
                     else None
                 )
+                service_runtime_snapshot = (
+                    _service_runtime_snapshot_document(
+                        pipeline.get_execution_service_runtimes(validated_execution),
+                        expected_execution_id=validated_execution,
+                        expected_pipeline_id=validated_pipeline,
+                    )
+                    if include_service_runtimes
+                    else None
+                )
                 record = pipeline.get_execution(validated_execution)
                 record_document = _execution_record_document(
                     record,
@@ -825,6 +835,7 @@ async def get_execution(
                     record_document,
                     progress_document=progress_document,
                     artifact_snapshot=artifact_snapshot,
+                    service_runtime_snapshot=service_runtime_snapshot,
                 ):
                     break
                 if attempt + 1 < _EXECUTION_QUERY_CONSISTENCY_ATTEMPTS:
@@ -875,6 +886,7 @@ async def get_execution(
                 "runtime_metadata": runtime_metadata,
                 "progress": progress_document,
                 "artifact_page": artifact_page,
+                "service_runtimes": service_runtime_snapshot,
             }
         except ToolError:
             raise
@@ -915,11 +927,16 @@ def _execution_snapshots_match_record(
     *,
     progress_document: dict[str, Any] | None,
     artifact_snapshot: dict[str, Any] | None,
+    service_runtime_snapshot: dict[str, Any] | None,
 ) -> bool:
     """Return whether optional producer snapshots share one lifecycle state."""
     state = record_document["state"]
     terminal = record_document["terminal"]
-    for snapshot in (progress_document, artifact_snapshot):
+    for snapshot in (
+        progress_document,
+        artifact_snapshot,
+        service_runtime_snapshot,
+    ):
         if snapshot is not None and (
             snapshot["execution_state"] != state or snapshot["terminal"] is not terminal
         ):
@@ -927,6 +944,44 @@ def _execution_snapshots_match_record(
     return True
 
 
+def _service_runtime_snapshot_document(
+    snapshot: Any,
+    *,
+    expected_execution_id: str,
+    expected_pipeline_id: str,
+) -> dict[str, Any]:
+    """Normalize and identity-bind one native JARVIS service snapshot."""
+    to_dict = getattr(snapshot, "to_dict", None)
+    document = to_dict() if callable(to_dict) else snapshot
+    if not isinstance(document, dict):
+        raise TypeError("JARVIS service-runtime snapshot must be an object")
+    expected_fields = {
+        "schema_version",
+        "execution_id",
+        "pipeline_id",
+        "execution_state",
+        "terminal",
+        "service_runtimes",
+    }
+    if set(document) != expected_fields:
+        raise ValueError("JARVIS service-runtime snapshot fields are invalid")
+    if document.get("schema_version") != "jarvis.execution.service-runtimes.v1":
+        raise ValueError("JARVIS service-runtime snapshot schema is unsupported")
+    if document.get("execution_id") != expected_execution_id:
+        raise ValueError("JARVIS service-runtime execution identity did not match")
+    if document.get("pipeline_id") != expected_pipeline_id:
+        raise ValueError("JARVIS service-runtime pipeline identity did not match")
+    runtimes = document.get("service_runtimes")
+    if not isinstance(runtimes, list):
+        raise ValueError("JARVIS service-runtime entries must be a list")
+    for runtime in runtimes:
+        if not isinstance(runtime, dict):
+            raise ValueError("JARVIS service-runtime entry must be an object")
+        if runtime.get("execution_id") != expected_execution_id:
+            raise ValueError("JARVIS service-runtime entry identity did not match")
+    return cast(dict[str, Any], document)
+
+
 async def _run_pipeline_operation(
     operation: Callable[[], Any],
     *,