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.