Public Metadata API
Read-only contract, no execution surface.
This API is intentionally small and public-safe. It exposes metadata about AMOF's public CLI, release, provider templates, and capability boundaries. It does not expose remote dispatch execution, raw private operator details, auth internals, or internal control-plane topology.
GET /healthz
Static public health metadata for the public site and metadata API surface.
{
"status": "ok",
"surface": "public-metadata",
"execution_api": "not_in_this_slice"
}GET /version
Current public CLI release and metadata contract version.
{
"product": "AMOF",
"public_cli_version": "v3.0.0",
"api_contract_version": "2026-05-31",
"install": {
"method": "pipx",
"command": "pipx install \"git+https://github.com/marekhotshot/amof.git@v3.0.0\""
}
}GET /v1/releases/latest
Static release metadata with install and documentation links.
{
"version": "v3.0.0",
"published_at": "2026-05-30",
"install_command": "pipx install \"git+https://github.com/marekhotshot/amof.git@v3.0.0\""
}GET /v1/providers/templates
Read-only provider template catalog aligned with the public CLI setup flow.
{
"templates": [
{ "id": "openrouter", "status": "setup_profile_only" },
{ "id": "local-qwen", "status": "template_only_until_runner_profile_is_configured" },
{ "id": "openai", "status": "setup_profile_only" },
{ "id": "anthropic", "status": "setup_profile_only" },
{ "id": "bedrock", "status": "setup_profile_only" },
{ "id": "xai", "status": "template_only_until_provider_resolver_support" },
{ "id": "runpod", "status": "profile_resolver_supported" }
]
}GET /v1/public-capabilities
Public capability summary for Runtime Authority surfaces and bounded public behavior.
{
"capabilities": [
"installable_cli",
"runtime_context_selection",
"governed_intake",
"runner_registry",
"execution_scan_report",
"bounded_loops",
"run_inspection",
"runtime_logs_contract",
"receipts_and_evidence"
],
"non_goals": [
"autonomous_mutation_dispatch",
"silent_local_fallback",
"raw_secret_or_prompt_exposure"
]
}GET /openapi.json
Machine-readable OpenAPI draft for all public metadata endpoints in this slice.
{
"openapi": "3.1.0",
"info": {
"title": "AMOF Public Metadata API",
"version": "2026-05-20"
}
}Scope Guardrails
- No POST endpoints.
- No autonomous public run execution or mutation endpoints.
- No auth system or private operator paths in this draft.
- No cloud-control-plane assumptions are required to read this contract.
- Public runtime authority remains scan/report/read-only/planning-first.