orrery/html-to-pdf

Render simple HTML to a downloadable PDF with signed receipts.

/resolve?name=orrery/html-to-pdf

Use this when

You need a short-lived PDF artifact from trusted HTML
You want a signed convert receipt for document evidence
You are queueing a managed PDF run and polling for the result

Not for

Untrusted HTML with active content
Complex CSS/layout engines
Long-term PDF hosting

Inputs / Outputs

Inputs

Name	Type	Notes
`html` required	string	—
`idempotency_key`	string	required for submit
`run_id`	string	required for result

Outputs

Name	Type	Notes
`artifact`	pdf-url	—
`run_id`	string	—
`envelope`	signed-envelope	—

Example

{
  "method": "tools/call",
  "params": {
    "name": "convert",
    "arguments": {
      "html": "<p>Hello from Orrery</p>"
    }
  }
}

Tools

convert Render simple HTML to a short-lived downloadable PDF synchronously in the API process. Use for small jobs when the caller can wait · schema

{
  "type": "object",
  "properties": {
    "html": {
      "type": "string"
    }
  },
  "required": [
    "html"
  ]
}

submit Queue a managed PDF run on the private worker and return run_id plus queued state. Poll result(run_id) until state is terminal. Prefer convert for quick synchronous PDFs; use submit/result for durable worker execution · schema

{
  "type": "object",
  "properties": {
    "html": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string"
    }
  },
  "required": [
    "html",
    "idempotency_key"
  ]
}

result Poll a managed run by run_id from submit. Returns queued or running state until the worker seals a signed final receipt. Unknown run_id returns {error: run_not_found, run_id} · schema

{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "string"
    }
  },
  "required": [
    "run_id"
  ]
}

health Html-to-pdf readiness probe · schema

{
  "type": "object",
  "properties": {}
}

In constellations

orrery/board-memoResumable board-memo demo: memo-bind → audience-choice pause → pdf-seal composite (ADR 0007 Example 2)↗acme/launch-gateShip a release through gates, repair loop, and fan-in↗