Skip to content

distribution.releases

Every release this repository recorded, newest first, and the one an unpinned installation resolves to: the highest version among the stable, unwithdrawn records. The pointer is derived here and never authored anywhere.

Every release this repository recorded, newest first, and the one an unpinned installation resolves to: the highest version among the stable, unwithdrawn records. The pointer is derived here and never authored anywhere.

Exposure

Where this one definition is reachable. Absence is explicit: a surface not listed does not carry it.

surfaceas
MCPtool majordomus_releases
HTTPGET /api/v1/distribution/releases operationId distribution.releases
command linemajordomus distribution releases

Schemas

The canonical input and output, from the Rust types; the MCP tool schema and the OpenAPI parameters and responses are derived from these.

input · Empty

No input.

No properties: the capability takes no input.

JSON Schema
{
  "additionalProperties": false,
  "description": "No input.",
  "title": "Empty",
  "type": "object"
}

output · ReleasesReport

The releases this repository recorded, and the one an unpinned installation resolves to.

propertytyperequireddescription
count integer yes How many records there are.
latest one of 2 no The release an unpinned installation resolves to, when there is one.
releases array yes Every record, newest first.
JSON Schema
{
  "$defs": {
    "Channel": {
      "description": "Which releases an unpinned installation may resolve to.",
      "oneOf": [
        {
          "const": "stable",
          "description": "Resolved by `latest`.",
          "type": "string"
        },
        {
          "const": "prerelease",
          "description": "Published, addressable by its exact tag, never resolved by default.",
          "type": "string"
        }
      ]
    },
    "ReleaseView": {
      "description": "One release, as every projection shows it.",
      "properties": {
        "artifacts": {
          "description": "How many artifacts it published.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "channel": {
          "$ref": "#/$defs/Channel",
          "description": "Whether an unpinned installation may resolve it."
        },
        "commit": {
          "description": "The commit it was built from.",
          "type": "string"
        },
        "metadata_url": {
          "description": "Where its public metadata is served.",
          "type": "string"
        },
        "published_at": {
          "description": "When it was published, UTC.",
          "type": "string"
        },
        "tag": {
          "description": "The git tag.",
          "type": "string"
        },
        "version": {
          "description": "The semantic version.",
          "type": "string"
        },
        "yanked": {
          "description": "True when it has been withdrawn.",
          "type": "boolean"
        }
      },
      "required": [
        "tag",
        "version",
        "channel",
        "published_at",
        "commit",
        "yanked",
        "artifacts",
        "metadata_url"
      ],
      "type": "object"
    }
  },
  "description": "The releases this repository recorded, and the one an unpinned installation resolves to.",
  "properties": {
    "count": {
      "description": "How many records there are.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "latest": {
      "anyOf": [
        {
          "$ref": "#/$defs/ReleaseView"
        },
        {
          "type": "null"
        }
      ],
      "description": "The release an unpinned installation resolves to, when there is one."
    },
    "releases": {
      "description": "Every record, newest first.",
      "items": {
        "$ref": "#/$defs/ReleaseView"
      },
      "type": "array"
    }
  },
  "required": [
    "count",
    "releases"
  ],
  "title": "ReleasesReport",
  "type": "object"
}

Policies

benchmark
required — a target on every transport the exposure declares; the cases are the input type's
cache
disabled — every call runs the handler

Benchmark targets

Derived from the registry for this repository: one requirement per transport, and the cases the input type provides. The whole matrix is on the benchmarks page.

transportstatecasestargets
directcovered1default
mcpcovered1default
httpcovered1default