Skip to content

Schema index

YAML and JSON schemas used by mas-ctl validate, mas-lab check, and the benchmark UI. Files live under docs/schemas/.

Human-readable field docs are in Specifications.


Workspace & project

Schema Purpose
config.schema.yaml Root config.yaml — defaults, flavour, infra refs
deployment.schema.yaml Deployment / placement descriptors
runtime-profile.schema.yaml Runtime profile flags (governance, observability)
placement-plan.schema.yaml Component placement plan
effective-bind.schema.yaml Resolved binding after overlay merge
memory-seed.schema.yaml Dataset memory seed files
checkpoint.schema.yaml Execution checkpoint payloads

Runtime manifests

Top-level kinds (see manifest reference):

Schema kind / role
runtime/agent.schema.yaml Agent
runtime/mas.schema.yaml MAS
runtime/workflow.schema.yaml Workflow
runtime/overlay.schema.yaml Overlay
runtime/flavour.schema.yaml Flavour
runtime/infra.schema.yaml Infra bundle / middleware
runtime/tool.schema.yaml Tool definition
runtime/tool_bundle.schema.yaml Bundled tools
runtime/prompt_bundle.schema.yaml Prompt bundles

Shared fragments under runtime/fragments/ — bindings, workflow nodes/edges, policy rules, design-pattern config, etc.


Lab & benchmarks

Schema Purpose
lab/experiment.schema.yaml experiment.yaml
lab/dataset.schema.yaml Dataset manifest
lab/pipeline.schema.yaml Pipeline step definitions
lab/lab.schema.yaml Lab folder metadata
lab/lab-config.schema.yaml Local pipeline libraries
lab/run-input.schema.yaml Per-run inputs
lab/pipeline-manifest.schema.json Serialized pipeline manifest
lab/artefacts/run_info.schema.json Run metadata artefact
lab/artefacts/metrics.schema.json Metrics artefact

Contracts, components & evaluation

Schema Purpose
contracts-registry.yaml Plugin contract registry (see Contracts)
component-registry.yaml Component / plugin registry
evaluation-envelope.schema.yaml Evaluation result envelope

Examples

Sample overlays and bindings under schemas/examples/:

Plus *.example.yaml siblings next to deployment, placement, memory-seed, and runtime-profile schemas.