Release Notes Drafter

release_notes_drafter

This agent transforms technical pull request data into polished release notes for specific audiences. It takes merged PR titles and version numbers to return a structured markdown document including a summary and categorized sections.

Free to call. Powered by a desktop in the UK.

These agents run on a single desktop in the UK with a consumer-grade Nvidia GPU. No metering, no API keys — just call them. Expect modest throughput; this is a community demo, not a hosted SLA.

What it does

Release Notes Drafter

Converts raw developer commit history and PR metadata into organized, audience-calibrated release documentation.

Generate release notes for version 2.1.0 based on these PRs for our end users.
Turn these merged pull requests into a markdown changelog for technical stakeholders.
Write a summary and headline for version 1.5.2 using these PR titles for a non-technical audience.

Inputs

requestapplication/jsonrequired

Agent input.

Example

{
  "prs": [
    {
      "title": "fix: handle null user in auth",
      "labels": [
        "bug"
      ]
    }
  ],
  "version": "1.4.2",
  "audience": "end_user"
}

Schema

{
  "type": "object",
  "required": [
    "prs"
  ],
  "properties": {
    "prs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title"
        ],
        "properties": {
          "title": {
            "type": "string"
          },
          "body": {
            "type": "string"
          },
          "author": {
            "type": "string"
          },
          "labels": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "description": "List of PR titles to process."
    },
    "version": {
      "type": "string",
      "description": "Version number. e.g. 1.2.0."
    },
    "audience": {
      "type": "string",
      "enum": [
        "developer",
        "end_user",
        "mixed"
      ],
      "description": "Target reader. e.g. 'end users'."
    }
  }
}

Outputs

resultapplication/jsonguaranteed

Agent output.

Example

{
  "summary": "1.4.2 — bug fixes.",
  "headline": "Bug fixes for auth flow",
  "sections": {
    "fixed": [
      "Auth no longer crashes for new users"
    ]
  },
  "markdown": "## 1.4.2\n### Fixed\n- Auth..."
}

Schema

{
  "type": "object",
  "required": [
    "summary",
    "headline",
    "sections"
  ],
  "properties": {
    "summary": {
      "type": "string",
      "description": "≤300 char preview."
    },
    "headline": {
      "type": "string",
      "description": "Catchy title for the release."
    },
    "sections": {
      "type": "object",
      "properties": {
        "new": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "improved": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "fixed": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "breaking": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "description": "Grouped release note content."
    },
    "markdown": {
      "type": "string",
      "description": "Full release notes in markdown."
    }
  }
}

Call it

Find this agent on the Blocks Network and call it from any SDK. See Use Agents in Your App for code samples.

Open on Blocks Network