report

name	report
description	Publish reports to Nostr — either NIP-23 long-form markdown articles (kind:30023) via report_publish, or rich HTML reports via html_publish
tools	["report_publish","html_publish"]

html_publish — Rich HTML Reports

Use html_publish to create and publish a visual HTML report that appears in the client's Reports tab.

Single file

html_publish(
  title="Q1 Performance Summary",
  description="One-line description shown in the report list",
  path="$AGENT_HOME/report.html",
  slug="q1-performance-summary"
)

Multi-file bundle (directory)

The directory must contain index.html. All files are zipped and uploaded together.

html_publish(
  title="Dashboard",
  description="Interactive project dashboard",
  path="$AGENT_HOME/dashboard/",
  slug="dashboard"
)

Relative links work

Within a bundle, relative links between files work correctly in the viewer:

• <a href="details.html"> → navigates to details.html in the same bundle
• <link rel="stylesheet" href="style.css"> → loads style.css from the bundle
• <script src="chart.js"> → loads chart.js from the bundle
• <img src="images/logo.png"> → loads image from the bundle

Guidelines

• Always include <meta charset="UTF-8"> and <meta name="viewport" content="width=device-width, initial-scale=1.0">
• Self-contained HTML with inline CSS is simplest; external CDN resources (e.g. Chart.js from a CDN URL) also work since the viewer allows network access
• Avoid absolute file:// paths — use relative paths for all intra-bundle references
• The description is shown as the subtitle in the report list — keep it to one sentence
• slug is a stable identifier emitted as a ["d", <slug>] tag — re-publishing with the same slug replaces the prior version, so use a fresh slug per distinct report and reuse the same slug to update one