{ }
GitHub
Full Demo Runway

Spec to Evals, MCP, Sandbox, AgentUI, and Root

A source-backed demo that validates one contract, generates target-specific artifacts, and prepares honest handoff evidence before any protected downstream tool runs.

Open WorkbenchOpen Demo APIOpen Integration Matrix
Demo Contract
Bundled public-safe OpenAPI contract used for repeatable demos.
{
  "openapi": "3.1.0",
  "info": {
    "title": "PlatPhorm Demo Contract",
    "version": "2026.06.01",
    "description": "Public-safe demo contract for Spec, MCP, AgentUI, Sandbox, and Evals handoff verification."
  },
  "servers": [
    {
      "url": "https://spec.platphormnews.com"
    }
  ],
  "paths": {
    "/api/health": {
      "get": {
        "operationId": "getSpecHealth",
        "summary": "Read public Spec health.",
        "responses": {
          "200": {
            "description": "Health payload",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SpecHealth"
                }
              }
            }
          }
        }
      }
    },
    "/api/mcp": {
      "post": {
        "operationId": "callSpecMcp",
        "summary": "Call the public-safe Spec MCP endpoint.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "jsonrpc",
                  "method"
                ],
                "properties": {
                  "jsonrpc": {
                    "type": "string",
                    "enum": [
                      "2.0"
                    ]
                  },
                  "id": {
                    "type": "string"
                  },
                  "method": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON-RPC response"
          },
          "400": {
            "description": "Invalid JSON-RPC request"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "SpecHealth": {
        "type": "object",
        "required": [
          "service",
          "status",
          "timestamp"
        ],
        "properties": {
          "service": {
            "type": "string",
            "description": "Service identifier."
          },
          "status": {
            "type": "string",
            "enum": [
              "healthy",
              "degraded",
              "unavailable"
            ]
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      }
    }
  }
}
Source
openapi
Validation
valid
Artifacts
5
Trace
9573c157-5e9a-40
Spec Workbench
completed
Validate the source contract and produce trace-linked evidence.
Role
Validate, normalize, generate artifacts, and create evidence before remote tools run.
Public
/api/v1/validate
Protected
/api/v1/contracts
Artifact
validation evidence
platphormctl spec validate c01ac96423b2698b1d91b9586ff5952934467a21689fd1337c290d4ad1e4b656.json
Open Spec Workbench
PlatPhorm Root Graph
preview_ready
Use root graph discovery as public provenance for source selection.
Role
Provide network topology and discover contract source URLs for import.
Public
https://platphormnews.com/api/network/graph
Protected
/api/v1/import/network
Artifact
platphorm-demo-contract.platphormctl.md
```bash
platphormctl site inspect spec
platphormctl mcp validate spec
platphormctl policy inspect spec
platphormctl spec validate c01ac96423b2698b1d91b9586ff5952934467a21689fd1337c290d4ad1e4b656.json
platphormctl spec diff <a> <b>
platphormctl spec generate-tests spec
platphormctl harness run spec-evals-browserops-loop --dry-run
platphormctl harness run developer-validation --target https://spec.platphormnews.com --dry-run
```
platphormctl site inspect platphormnews --best-effort
Open PlatPhorm Root Graph
MCP Gateway
preview_ready
Generate an MCP tool candidate from the parsed OpenAPI operation.
Role
Receive validated MCP tool candidates and expose public MCP capability discovery.
Public
https://mcp.platphormnews.com/.well-known/mcp.json
Protected
/api/v1/handoffs/dispatch
Artifact
platphorm-demo-contract.mcp-tool.json
{
  "name": "getSpecHealth",
  "description": "Read public Spec health.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "annotations": {
    "publicSafe": true,
    "protected": false,
    "sourceOperation": "GET /api/health"
  }
}
platphormctl spec generate mcp-tool c01ac96423b2698b1d91b9586ff5952934467a21689fd1337c290d4ad1e4b656.json
Open MCP Gateway
AgentUI
preview_ready
Generate a form payload suitable for local AgentUI preview.
Role
Render generated forms and protected action panels from contract schemas.
Public
/api/v1/agentui/preview-form
Protected
/api/v1/agentui/send-form
Artifact
platphorm-demo-contract.agentui-form.json
{
  "version": "agentui.form.v1",
  "title": "PlatPhorm Demo Contract",
  "sourceSpecHash": "c01ac96423b2698b1d91b9586ff5952934467a21689fd1337c290d4ad1e4b656",
  "publicSafe": true,
  "protectedActionPolicy": "Remote send requires PLATPHORM_API_KEY; local preview is public-safe.",
  "schema": {
    "type": "object",
    "required": [
      "service",
      "status",
      "timestamp"
    ],
    "properties": {
      "service": {
        "type": "string",
        "description": "Service identifier."
      },
      "status": {
        "type": "string",
        "enum": [
          "healthy",
          "degraded",
          "unavailable"
        ]
      },
      "timestamp": {
        "type": "s
platphormctl spec generate agentui-form c01ac96423b2698b1d91b9586ff5952934467a21689fd1337c290d4ad1e4b656.json
Open AgentUI
Sandbox
preview_ready
Generate a deterministic Sandbox script without claiming command output.
Role
Run generated contract tests only when protected execution evidence exists.
Public
/api/v1/sandbox/generate-test
Protected
/api/v1/sandbox/run-test
Artifact
platphorm-demo-contract.sandbox-test.js
const assert = require("node:assert/strict")

const contract = {
  "type": "openapi",
  "title": "PlatPhorm Demo Contract",
  "hash": "c01ac96423b2698b1d91b9586ff5952934467a21689fd1337c290d4ad1e4b656"
}

assert.ok(contract.hash, "source spec hash is required")
assert.ok(["openapi","asyncapi","jsonschema","mcp","webhook","event"].includes(contract.type), "supported contract type")
console.log(JSON.stringify({ ok: true, data: { contract } }))
platphormctl spec generate sandbox-test c01ac96423b2698b1d91b9586ff5952934467a21689fd1337c290d4ad1e4b656.json
Open Sandbox
Evals
preview_ready
Generate a contract eval suite draft from validation evidence.
Role
Score contract readiness, release gates, and generated artifact behavior.
Public
/api/v1/evals/generate-suite
Protected
/api/v1/evals/trigger
Artifact
platphorm-demo-contract.evals.json
{
  "suite": "platphorm-demo-contract-contract-evals",
  "sourceSpecHash": "c01ac96423b2698b1d91b9586ff5952934467a21689fd1337c290d4ad1e4b656",
  "cases": [
    {
      "id": "contract-validates",
      "assertion": "Spec validation status is valid, warn, or degraded with explicit reasons."
    },
    {
      "id": "public-protected-boundary",
      "assertion": "Protected actions require PLATPHORM_API_KEY."
    },
    {
      "id": "trace-metadata",
      "assertion": "Generated handoffs include traceId evidence."
    }
  ]
}
platphormctl spec release-gate c01ac96423b2698b1d91b9586ff5952934467a21689fd1337c290d4ad1e4b656
Open Evals
Demo Policy
Public preview is separate from protected execution.
Public Preview

Validation, generation previews, demo runway evidence, and public discovery are available without login.

Protected Dispatch

Remote dispatch, durable registry mutation, execution, and scoring require PLATPHORM_API_KEY.

No Fake Execution

Spec does not claim Evals scoring, MCP publishing, Sandbox execution, or AgentUI remote rendering unless downstream evidence exists.