@readymadeit/mcp 0.0.0-stage → 0.1.0

package/bundle/boards/rss-radio-unit-board.json

@@ -0,0 +1,809 @@
+{
+  "boardName": "Radio",
+  "description": "A feed, read aloud. Every minute it reads the feed it was given, and anything it has not spoken before is sent to a voice and the audio kept in the library.\n\nThe feed is the only thing it knows about its source, which is what makes it general: a reading list, a blog, a newsroom \u2014 anything that publishes RSS or Atom becomes a podcast without this board learning where it came from.\n\nTwo things are worth reading in the pipeline. The **claim** is one SQL statement doing the work of a lease: it takes the item, hands back nothing at all when the item is already spoken or is being spoken right now \u2014 and returning nothing stops that pass, which is how work is skipped \u2014 and gives back the path the episode is to be kept at, built from its identity rather than from a counter that would drift. Nothing is offered again by itself. **A voice that fails is recorded**: the call to it is a detour that reports a failure beside the article rather than stopping, and only a 200 carrying bytes is kept \u2014 anything else is written down with its reason (the voice's error, *the voice answered HTTP 503*, *the voice answered without audio*) and waits under **Being read** for a person to press Retry. A rendering that started and never finished counts as failed after `stuckAfter`. The branch is a Tracks: one track keeps the audio, the other records why there is none, and each stops itself when it is not the one that applies. And the **path comes back with the audio**, in a header the voice sets, because an answer arriving later than the pass that asked for it has to say what it is an answer to.\n\nA round asks the feed for its ten newest and lets the claim decide which of those are work; nothing limits the iteration itself, because an Iterator cuts the list before the claim sees it and an article below the cut would never get another turn. The calls of one round are in flight together and a voice renders them in order, so the first full round on an empty library takes as long as everything in it put together.\n\nNeeds hkp-node, kept as the remote `node`, and a voice to call. Alone it points at the public Hacker News feed; in the composition the reading list is the feed instead.\n\nWhat it has read aloud is published as a feed of its own, by the second runtime here. It has a clock rather than a trigger, for a structural reason worth knowing: an endpoint serving the last value it was handed answers with whatever its chain returns, so it has to be the last service in one \u2014 and the rendering chain above stops on the rounds where there is nothing new. A minute's staleness buys a feed that is rebuilt whatever happened.\n\nAn episode can be forgotten from the Listen panel: Remove deletes its row and its audio, in a runtime of its own whose output runs on into the playlist. The claim being the only memory of what was spoken, an article still on the reading list is read again on the next round.\n\nThe enclosure URLs point into the library, named rather than written down: the address is assigned when the board loads, and a Map is handed it the same way a client dialling it would be.",
+  "unit": {
+    "name": "radio",
+    "params": {
+      "feedUrl": "https://hnrss.org/frontpage",
+      "feedName": "Hacker News",
+      "voiceMount": "hkp-mount://speech/render",
+      "volume": "radio",
+      "database": "rss-radio",
+      "everySeconds": "60",
+      "stuckAfter": "-15 minutes",
+      "audioBase": "hkp-mount://files/listen",
+      "feedTitle": "Reading Radio",
+      "feedDescription": "Everything the radio has read aloud"
+    }
+  },
+  "runtimes": [
+    {
+      "id": "radio",
+      "name": "Radio",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    },
+    {
+      "id": "publish",
+      "name": "Published",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    },
+    {
+      "id": "forget",
+      "name": "Forget an episode",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    },
+    {
+      "id": "playlist",
+      "name": "Playlist",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    },
+    {
+      "id": "pending",
+      "name": "Being read",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    }
+  ],
+  "services": {
+    "radio": [
+      {
+        "uuid": "tick",
+        "serviceId": "timer",
+        "serviceName": "Every minute",
+        "state": {
+          "periodic": true,
+          "periodicValue": 60,
+          "periodicUnit": "s",
+          "running": true
+        }
+      },
+      {
+        "uuid": "feed",
+        "serviceId": "rss",
+        "serviceName": "The feed",
+        "state": {
+          "feeds": [
+            {
+              "url": "{{param.feedUrl}}",
+              "name": "{{param.feedName}}"
+            }
+          ],
+          "limit": 10,
+          "summaryChars": 1200
+        }
+      },
+      {
+        "uuid": "each",
+        "serviceId": "iterator",
+        "serviceName": "Each article",
+        "state": {
+          "pipeline": [
+            {
+              "instanceId": "name",
+              "serviceId": "map",
+              "serviceName": "Name it",
+              "state": {
+                "mode": "add",
+                "template": {
+                  "slug=": "slug(params.id || params.link)"
+                }
+              }
+            },
+            {
+              "instanceId": "claim",
+              "serviceId": "sql",
+              "serviceName": "Claim it, or skip it",
+              "state": {
+                "mode": "query",
+                "database": "{{param.database}}",
+                "schema": "CREATE TABLE IF NOT EXISTS episode (\n  slug     TEXT PRIMARY KEY,\n  guid     TEXT NOT NULL DEFAULT '',\n  title    TEXT NOT NULL DEFAULT '',\n  summary  TEXT NOT NULL DEFAULT '',\n  link     TEXT NOT NULL DEFAULT '',\n  feed     TEXT NOT NULL DEFAULT '',\n  published TEXT NOT NULL DEFAULT '',\n  claimed  TEXT NOT NULL DEFAULT (datetime('now')),\n  rendered TEXT,\n  bytes    INTEGER\n);\nCREATE TABLE IF NOT EXISTS voicing (\n  slug   TEXT PRIMARY KEY,\n  failed TEXT NOT NULL DEFAULT (datetime('now')),\n  error  TEXT NOT NULL DEFAULT ''\n);",
+                "statement": "INSERT INTO episode (slug, guid, title, summary, link, feed, published)\nVALUES (substr($slug, 1, 100), IFNULL($id, ''), IFNULL($title, ''), IFNULL($summary, ''),\n        IFNULL($link, ''), IFNULL($feed, ''), IFNULL($published, ''))\nON CONFLICT(slug) DO UPDATE SET claimed = datetime('now')\n  WHERE $retry = 1 AND episode.rendered IS NULL\nRETURNING 'episodes/' || slug || '.mp3' AS path, slug, title, summary"
+              }
+            },
+            {
+              "instanceId": "new",
+              "serviceId": "map",
+              "serviceName": "Only the new one",
+              "state": {
+                "mode": "replace",
+                "template": {
+                  "=": "params.count ? params.rows[0] : null"
+                }
+              }
+            },
+            {
+              "instanceId": "clear",
+              "serviceId": "sql",
+              "serviceName": "Forget a failure it is trying again",
+              "state": {
+                "mode": "run",
+                "emit": "input",
+                "database": "{{param.database}}",
+                "schema": "CREATE TABLE IF NOT EXISTS episode (\n  slug     TEXT PRIMARY KEY,\n  guid     TEXT NOT NULL DEFAULT '',\n  title    TEXT NOT NULL DEFAULT '',\n  summary  TEXT NOT NULL DEFAULT '',\n  link     TEXT NOT NULL DEFAULT '',\n  feed     TEXT NOT NULL DEFAULT '',\n  published TEXT NOT NULL DEFAULT '',\n  claimed  TEXT NOT NULL DEFAULT (datetime('now')),\n  rendered TEXT,\n  bytes    INTEGER\n);\nCREATE TABLE IF NOT EXISTS voicing (\n  slug   TEXT PRIMARY KEY,\n  failed TEXT NOT NULL DEFAULT (datetime('now')),\n  error  TEXT NOT NULL DEFAULT ''\n);",
+                "statement": "DELETE FROM voicing WHERE slug = $slug"
+              }
+            },
+            {
+              "instanceId": "voice",
+              "serviceId": "join",
+              "serviceName": "The voice",
+              "state": {
+                "as": "audio",
+                "onFailure": "merge",
+                "pipeline": [
+                  {
+                    "instanceId": "ask",
+                    "serviceId": "map",
+                    "serviceName": "What to say",
+                    "state": {
+                      "mode": "replace",
+                      "template": {
+                        "meta.method": "post",
+                        "body.path=": "params.path",
+                        "body.text=": "params.title + '. ' + withoutUrls(params.summary)"
+                      }
+                    }
+                  },
+                  {
+                    "instanceId": "render",
+                    "serviceId": "http-client",
+                    "serviceName": "The voice",
+                    "state": {
+                      "url": "{{param.voiceMount}}",
+                      "method": "post",
+                      "timeoutMs": 600000
+                    }
+                  }
+                ]
+              }
+            },
+            {
+              "instanceId": "outcome",
+              "serviceId": "tracks",
+              "serviceName": "Keep the audio, or say why there is none",
+              "state": {
+                "run": "serial",
+                "tracks": [
+                  {
+                    "name": "spoken",
+                    "pipeline": [
+                      {
+                        "instanceId": "spoken",
+                        "serviceId": "map",
+                        "serviceName": "Only audio is kept",
+                        "state": {
+                          "mode": "replace",
+                          "template": {
+                            "=": "params.audio && params.audio.meta && params.audio.meta.status === 200 && params.audio.binary ? params.audio : null"
+                          }
+                        }
+                      },
+                      {
+                        "instanceId": "keep",
+                        "serviceId": "map",
+                        "serviceName": "Where it goes",
+                        "state": {
+                          "mode": "replace",
+                          "template": {
+                            "op": "write",
+                            "path=": "params.meta.headers['x-episode-path']",
+                            "binary=": "params.binary"
+                          }
+                        }
+                      },
+                      {
+                        "instanceId": "store",
+                        "serviceId": "storage",
+                        "serviceName": "The library",
+                        "state": {
+                          "pipeline": [
+                            {
+                              "instanceId": "files",
+                              "serviceId": "filesystem",
+                              "serviceName": "Files",
+                              "state": {
+                                "volume": "{{param.volume}}"
+                              }
+                            }
+                          ]
+                        }
+                      },
+                      {
+                        "instanceId": "kept",
+                        "serviceId": "map",
+                        "serviceName": "What was kept",
+                        "state": {
+                          "mode": "replace",
+                          "template": {
+                            "path=": "params.body.path",
+                            "size=": "params.body.size"
+                          }
+                        }
+                      },
+                      {
+                        "instanceId": "note",
+                        "serviceId": "sql",
+                        "serviceName": "Mark it rendered",
+                        "state": {
+                          "mode": "run",
+                          "database": "{{param.database}}",
+                          "statement": "UPDATE episode\n   SET rendered = datetime('now'), bytes = $size\n WHERE 'episodes/' || slug || '.mp3' = $path"
+                        }
+                      }
+                    ]
+                  },
+                  {
+                    "name": "failed",
+                    "pipeline": [
+                      {
+                        "instanceId": "unspoken",
+                        "serviceId": "map",
+                        "serviceName": "Only what the voice did not speak",
+                        "state": {
+                          "mode": "replace",
+                          "template": {
+                            "=": "params.audio && params.audio.meta && params.audio.meta.status === 200 && params.audio.binary ? null : params"
+                          }
+                        }
+                      },
+                      {
+                        "instanceId": "why",
+                        "serviceId": "map",
+                        "serviceName": "Why",
+                        "state": {
+                          "mode": "replace",
+                          "template": {
+                            "slug=": "params.slug",
+                            "error=": "params.audio && params.audio.error ? params.audio.error : (params.audio && params.audio.meta && params.audio.meta.status !== 200 ? 'the voice answered HTTP ' + params.audio.meta.status : 'the voice answered without audio')"
+                          }
+                        }
+                      },
+                      {
+                        "instanceId": "record",
+                        "serviceId": "sql",
+                        "serviceName": "Record the failure",
+                        "state": {
+                          "mode": "run",
+                          "database": "{{param.database}}",
+                          "schema": "CREATE TABLE IF NOT EXISTS episode (\n  slug     TEXT PRIMARY KEY,\n  guid     TEXT NOT NULL DEFAULT '',\n  title    TEXT NOT NULL DEFAULT '',\n  summary  TEXT NOT NULL DEFAULT '',\n  link     TEXT NOT NULL DEFAULT '',\n  feed     TEXT NOT NULL DEFAULT '',\n  published TEXT NOT NULL DEFAULT '',\n  claimed  TEXT NOT NULL DEFAULT (datetime('now')),\n  rendered TEXT,\n  bytes    INTEGER\n);\nCREATE TABLE IF NOT EXISTS voicing (\n  slug   TEXT PRIMARY KEY,\n  failed TEXT NOT NULL DEFAULT (datetime('now')),\n  error  TEXT NOT NULL DEFAULT ''\n);",
+                          "statement": "INSERT INTO voicing (slug, failed, error) VALUES ($slug, datetime('now'), $error)\nON CONFLICT(slug) DO UPDATE SET failed = excluded.failed, error = excluded.error"
+                        }
+                      }
+                    ]
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      },
+      {
+        "uuid": "end",
+        "serviceId": "stopper",
+        "serviceName": "End of the round",
+        "state": {}
+      }
+    ],
+    "publish": [
+      {
+        "uuid": "pub-tick",
+        "serviceId": "timer",
+        "serviceName": "Every minute",
+        "state": {
+          "periodic": true,
+          "periodicValue": 60,
+          "periodicUnit": "s",
+          "running": true
+        }
+      },
+      {
+        "uuid": "pub-about",
+        "serviceId": "map",
+        "serviceName": "What the feed is called",
+        "state": {
+          "mode": "replace",
+          "template": {
+            "channelTitle": "{{param.feedTitle}}",
+            "channelDescription": "{{param.feedDescription}}",
+            "channelLink": "{{param.audioBase}}",
+            "audioBase": "{{param.audioBase}}"
+          }
+        }
+      },
+      {
+        "uuid": "pub-doc",
+        "serviceId": "sql",
+        "serviceName": "The episodes as a feed",
+        "state": {
+          "mode": "query",
+          "database": "{{param.database}}",
+          "schema": "CREATE TABLE IF NOT EXISTS episode (\n  slug     TEXT PRIMARY KEY,\n  guid     TEXT NOT NULL DEFAULT '',\n  title    TEXT NOT NULL DEFAULT '',\n  summary  TEXT NOT NULL DEFAULT '',\n  link     TEXT NOT NULL DEFAULT '',\n  feed     TEXT NOT NULL DEFAULT '',\n  published TEXT NOT NULL DEFAULT '',\n  claimed  TEXT NOT NULL DEFAULT (datetime('now')),\n  rendered TEXT,\n  bytes    INTEGER\n);",
+          "statement": "SELECT '<?xml version=\"1.0\" encoding=\"UTF-8\"?>'\n    || '<rss version=\"2.0\"><channel>'\n    || '<title><![CDATA[' || replace(IFNULL($channelTitle, ''), ']]>', ']]&gt;') || ']]></title>'\n    || '<link>' || replace(replace(replace(IFNULL($channelLink, ''), '&', '&amp;'), '<', '&lt;'), '>', '&gt;') || '</link>'\n    || '<description><![CDATA[' || replace(IFNULL($channelDescription, ''), ']]>', ']]&gt;') || ']]></description>'\n    || IFNULL(group_concat(item, '' ORDER BY sortKey DESC), '')\n    || '</channel></rss>' AS feed\n  FROM (\n    SELECT '<item>'\n        || '<title><![CDATA[' || replace(IFNULL(title, ''), ']]>', ']]&gt;') || ']]></title>'\n        || '<link>' || replace(replace(replace(IFNULL(link, ''), '&', '&amp;'), '<', '&lt;'), '>', '&gt;') || '</link>'\n        || '<guid isPermaLink=\"false\">' || replace(replace(replace(slug, '&', '&amp;'), '<', '&lt;'), '>', '&gt;') || '</guid>'\n        || '<pubDate>' || IFNULL(published, '') || '</pubDate>'\n        || '<description><![CDATA[' || replace(IFNULL(summary, ''), ']]>', ']]&gt;') || ']]></description>'\n        || '<enclosure url=\"' || replace(replace(replace(IFNULL($audioBase, '') || '/' || slug || '.mp3', '&', '&amp;'), '<', '&lt;'), '>', '&gt;')\n        || '\" type=\"audio/mpeg\" length=\"' || IFNULL(bytes, 0) || '\"/>'\n        || '</item>' AS item,\n           rendered AS sortKey\n      FROM episode\n     WHERE rendered IS NOT NULL\n     ORDER BY rendered DESC\n     LIMIT 100\n  )"
+        }
+      },
+      {
+        "uuid": "pub-wrap",
+        "serviceId": "map",
+        "serviceName": "As a document",
+        "state": {
+          "mode": "replace",
+          "template": {
+            "meta.status": 200,
+            "meta.contentType": "application/rss+xml; charset=utf-8",
+            "body=": "params.rows[0].feed"
+          }
+        }
+      },
+      {
+        "uuid": "pub-serve",
+        "serviceId": "http-server-subservices",
+        "serviceName": "Serve the feed",
+        "state": {
+          "bypass": false,
+          "mountName": "episodes",
+          "onProcess": [
+            {
+              "instanceId": "keep-episodes",
+              "serviceId": "hold",
+              "serviceName": "Keep the document",
+              "state": {
+                "slot": "document",
+                "op": "write"
+              }
+            }
+          ],
+          "onRequest": [
+            {
+              "instanceId": "serve-episodes",
+              "serviceId": "hold",
+              "serviceName": "Serve the document",
+              "state": {
+                "slot": "document",
+                "op": "read"
+              }
+            }
+          ]
+        }
+      }
+    ],
+    "forget": [
+      {
+        "uuid": "forget-which",
+        "serviceId": "map",
+        "serviceName": "Only a request naming an episode",
+        "state": {
+          "mode": "replace",
+          "template": {
+            "=": "params.slug ? params : null"
+          }
+        }
+      },
+      {
+        "uuid": "forget-row",
+        "serviceId": "sql",
+        "serviceName": "Out of the ledger",
+        "state": {
+          "mode": "query",
+          "database": "{{param.database}}",
+          "schema": "CREATE TABLE IF NOT EXISTS episode (\n  slug     TEXT PRIMARY KEY,\n  guid     TEXT NOT NULL DEFAULT '',\n  title    TEXT NOT NULL DEFAULT '',\n  summary  TEXT NOT NULL DEFAULT '',\n  link     TEXT NOT NULL DEFAULT '',\n  feed     TEXT NOT NULL DEFAULT '',\n  published TEXT NOT NULL DEFAULT '',\n  claimed  TEXT NOT NULL DEFAULT (datetime('now')),\n  rendered TEXT,\n  bytes    INTEGER\n);",
+          "statement": "DELETE FROM episode\n WHERE slug = $slug\nRETURNING 'episodes/' || slug || '.mp3' AS path"
+        }
+      },
+      {
+        "uuid": "forget-one",
+        "serviceId": "map",
+        "serviceName": "The episode it was",
+        "state": {
+          "mode": "replace",
+          "template": {
+            "=": "params.count ? params.rows[0] : null"
+          }
+        }
+      },
+      {
+        "uuid": "forget-op",
+        "serviceId": "map",
+        "serviceName": "Its audio",
+        "state": {
+          "mode": "replace",
+          "template": {
+            "op": "delete",
+            "path=": "params.path"
+          }
+        }
+      },
+      {
+        "uuid": "forget-file",
+        "serviceId": "storage",
+        "serviceName": "Out of the library",
+        "state": {
+          "pipeline": [
+            {
+              "serviceId": "filesystem",
+              "state": {
+                "volume": "{{param.volume}}"
+              }
+            }
+          ]
+        }
+      }
+    ],
+    "playlist": [
+      {
+        "uuid": "pl-tick",
+        "serviceId": "timer",
+        "serviceName": "Every ten seconds",
+        "state": {
+          "periodic": true,
+          "periodicValue": 10,
+          "periodicUnit": "s",
+          "running": true
+        }
+      },
+      {
+        "uuid": "pl-base",
+        "serviceId": "map",
+        "serviceName": "Where the audio lives",
+        "state": {
+          "mode": "replace",
+          "template": {
+            "base": "{{param.audioBase}}"
+          }
+        }
+      },
+      {
+        "uuid": "pl-rows",
+        "serviceId": "sql",
+        "serviceName": "The programme, newest first",
+        "state": {
+          "mode": "query",
+          "database": "{{param.database}}",
+          "schema": "CREATE TABLE IF NOT EXISTS episode (\n  slug     TEXT PRIMARY KEY,\n  guid     TEXT NOT NULL DEFAULT '',\n  title    TEXT NOT NULL DEFAULT '',\n  summary  TEXT NOT NULL DEFAULT '',\n  link     TEXT NOT NULL DEFAULT '',\n  feed     TEXT NOT NULL DEFAULT '',\n  published TEXT NOT NULL DEFAULT '',\n  claimed  TEXT NOT NULL DEFAULT (datetime('now')),\n  rendered TEXT,\n  bytes    INTEGER\n);",
+          "statement": "SELECT slug,\n       title,\n       IFNULL($base, '') || '/' || slug || '.mp3' AS url,\n       IFNULL(published, '') AS published\n  FROM episode\n WHERE rendered IS NOT NULL\n ORDER BY rendered DESC\n LIMIT 100"
+        }
+      },
+      {
+        "uuid": "pl-seen",
+        "serviceId": "monitor",
+        "serviceName": "The programme",
+        "state": {}
+      },
+      {
+        "uuid": "m3u-doc",
+        "serviceId": "sql",
+        "serviceName": "The programme as a playlist",
+        "state": {
+          "mode": "query",
+          "statement": "SELECT '#EXTM3U' || char(10)\n    || IFNULL(group_concat(entry, char(10) ORDER BY sortKey), '')\n    || char(10) AS playlist\n  FROM (\n    SELECT '#EXTINF:-1,' || replace(replace(IFNULL(json_extract(value, '$.title'), ''), char(13), ' '), char(10), ' ') || char(10)\n        || IFNULL(json_extract(value, '$.url'), '') AS entry,\n           key AS sortKey\n      FROM json_each($rows)\n  )"
+        }
+      },
+      {
+        "uuid": "m3u-wrap",
+        "serviceId": "map",
+        "serviceName": "As a playlist file",
+        "state": {
+          "mode": "replace",
+          "template": {
+            "meta.status": 200,
+            "meta.contentType": "audio/x-mpegurl; charset=utf-8",
+            "meta.headers.content-disposition": "inline; filename=\"radio.m3u\"",
+            "body=": "params.rows[0].playlist"
+          }
+        }
+      },
+      {
+        "uuid": "m3u-serve",
+        "serviceId": "http-server-subservices",
+        "serviceName": "Serve the playlist",
+        "state": {
+          "bypass": false,
+          "mountName": "playlist",
+          "onProcess": [
+            {
+              "instanceId": "keep-playlist",
+              "serviceId": "hold",
+              "serviceName": "Keep the document",
+              "state": {
+                "slot": "document",
+                "op": "write"
+              }
+            }
+          ],
+          "onRequest": [
+            {
+              "instanceId": "serve-playlist",
+              "serviceId": "hold",
+              "serviceName": "Serve the document",
+              "state": {
+                "slot": "document",
+                "op": "read"
+              }
+            }
+          ]
+        }
+      }
+    ],
+    "pending": [
+      {
+        "uuid": "pending-tick",
+        "serviceId": "timer",
+        "serviceName": "Every ten seconds",
+        "state": {
+          "periodic": true,
+          "periodicValue": 10,
+          "periodicUnit": "s",
+          "running": true
+        }
+      },
+      {
+        "uuid": "pending-rows",
+        "serviceId": "sql",
+        "serviceName": "Not on air yet",
+        "state": {
+          "mode": "query",
+          "database": "{{param.database}}",
+          "schema": "CREATE TABLE IF NOT EXISTS episode (\n  slug     TEXT PRIMARY KEY,\n  guid     TEXT NOT NULL DEFAULT '',\n  title    TEXT NOT NULL DEFAULT '',\n  summary  TEXT NOT NULL DEFAULT '',\n  link     TEXT NOT NULL DEFAULT '',\n  feed     TEXT NOT NULL DEFAULT '',\n  published TEXT NOT NULL DEFAULT '',\n  claimed  TEXT NOT NULL DEFAULT (datetime('now')),\n  rendered TEXT,\n  bytes    INTEGER\n);\nCREATE TABLE IF NOT EXISTS voicing (\n  slug   TEXT PRIMARY KEY,\n  failed TEXT NOT NULL DEFAULT (datetime('now')),\n  error  TEXT NOT NULL DEFAULT ''\n);",
+          "statement": "SELECT e.slug, e.guid, e.link, e.title, e.summary, e.feed, e.published,\n       CASE\n         WHEN v.slug IS NOT NULL THEN 'Failed: ' || v.error\n         WHEN e.claimed < datetime('now', '{{param.stuckAfter}}')\n           THEN 'Failed: no answer since ' || e.claimed\n         ELSE 'Being voiced since ' || e.claimed\n       END AS status,\n       CASE WHEN v.slug IS NOT NULL OR e.claimed < datetime('now', '{{param.stuckAfter}}')\n            THEN 0 ELSE 1 END AS settled\n  FROM episode e\n  LEFT JOIN voicing v ON v.slug = e.slug\n WHERE e.rendered IS NULL\n ORDER BY e.claimed DESC\n LIMIT 50"
+        }
+      }
+    ]
+  },
+  "facade": {
+    "layout": "single",
+    "panels": [
+      {
+        "id": "radio",
+        "title": "Radio",
+        "layout": {
+          "direction": "column",
+          "gap": 12,
+          "paddingX": 16,
+          "paddingY": 12,
+          "items": [
+            {
+              "direction": "row",
+              "gap": 10,
+              "align": "center",
+              "items": [
+                {
+                  "type": "button",
+                  "label": "Check the feed now",
+                  "actions": [
+                    {
+                      "type": "process",
+                      "serviceUuid": "feed",
+                      "payload": {}
+                    }
+                  ],
+                  "indicator": {
+                    "source": {
+                      "serviceUuid": "feed",
+                      "path": "fetching"
+                    },
+                    "statusColors": {
+                      "true": "#f59e0b",
+                      "false": "#22c55e"
+                    }
+                  }
+                },
+                {
+                  "type": "text",
+                  "label": "Articles seen",
+                  "source": {
+                    "serviceUuid": "feed",
+                    "path": "count"
+                  },
+                  "placeholder": "\u2014",
+                  "grow": true
+                }
+              ]
+            },
+            {
+              "type": "text",
+              "label": "Rendered this round",
+              "source": {
+                "serviceUuid": "each",
+                "path": "results"
+              },
+              "placeholder": "0",
+              "tone": "muted",
+              "fontSize": 12
+            },
+            {
+              "type": "text",
+              "placeholder": "Nothing is spoken twice: an article already in the ledger stops its own pass. The audio is written into the library volume, which the Library unit serves. It checks the feed every minute by itself; an article the voice could not speak waits below, with the reason, until you try it again.",
+              "tone": "muted",
+              "fontSize": 12
+            },
+            {
+              "type": "repeat",
+              "source": {
+                "serviceUuid": "pending-rows",
+                "path": "rows"
+              },
+              "gap": 0,
+              "template": {
+                "direction": "column",
+                "gap": 4,
+                "items": [
+                  {
+                    "type": "text",
+                    "placeholder": "{{item.title}}",
+                    "href": "{{item.link}}",
+                    "fontSize": 14
+                  },
+                  {
+                    "type": "text",
+                    "placeholder": "{{item.status}}",
+                    "tone": "muted",
+                    "fontSize": 11
+                  },
+                  {
+                    "type": "button",
+                    "label": "Retry",
+                    "disabled": "{{item.settled}}",
+                    "actions": [
+                      {
+                        "type": "process",
+                        "serviceUuid": "each.name",
+                        "payload": {
+                          "id": "{{item.guid}}",
+                          "link": "{{item.link}}",
+                          "title": "{{item.title}}",
+                          "summary": "{{item.summary}}",
+                          "feed": "{{item.feed}}",
+                          "published": "{{item.published}}",
+                          "retry": 1
+                        }
+                      },
+                      {
+                        "type": "process",
+                        "serviceUuid": "pending-rows",
+                        "payload": {}
+                      }
+                    ]
+                  }
+                ]
+              },
+              "stripe": {
+                "even": "rgba(127,127,127,0.10)",
+                "odd": "rgba(127,127,127,0.03)",
+                "padding": 10,
+                "radius": 6
+              }
+            },
+            {
+              "type": "text",
+              "label": "Feed",
+              "source": {
+                "serviceUuid": "pub-serve",
+                "path": "__hkpMount"
+              },
+              "placeholder": "not published yet",
+              "tone": "muted",
+              "fontSize": 11,
+              "wrap": true
+            }
+          ]
+        }
+      },
+      {
+        "id": "listen",
+        "title": "Listen",
+        "layout": {
+          "direction": "column",
+          "gap": 10,
+          "align": "stretch",
+          "paddingX": 16,
+          "paddingY": 12,
+          "items": [
+            {
+              "type": "text",
+              "placeholder": "Everything the radio has read, newest first. Press play once and it runs on by itself; a track finishing starts the next one, and an episode rendered while you listen joins the end.",
+              "tone": "muted",
+              "fontSize": 12
+            },
+            {
+              "type": "audio-player",
+              "source": {
+                "serviceUuid": "pl-seen",
+                "path": "rows"
+              },
+              "url": "{{item.url}}",
+              "title": "{{item.title}}",
+              "subtitle": "{{item.published}}",
+              "autoplay": true,
+              "trackActions": [
+                {
+                  "label": "Remove",
+                  "confirm": "Remove \u201c{{item.title}}\u201d? Its audio is deleted. While the article is still on the reading list, the radio reads it again on its next round.",
+                  "actions": [
+                    {
+                      "type": "process",
+                      "serviceUuid": "forget-which",
+                      "payload": {
+                        "slug": "{{item.slug}}"
+                      }
+                    }
+                  ]
+                }
+              ],
+              "placeholder": "Nothing has been read aloud yet."
+            },
+            {
+              "type": "text",
+              "label": "Playlist",
+              "source": {
+                "serviceUuid": "m3u-serve",
+                "path": "__hkpMount"
+              },
+              "placeholder": "not published yet",
+              "tone": "muted",
+              "fontSize": 11,
+              "wrap": true,
+              "copyable": true
+            },
+            {
+              "type": "text",
+              "placeholder": "That address is an M3U: open it in VLC, Music or any desktop player and the whole programme queues up there instead of here.",
+              "tone": "muted",
+              "fontSize": 11
+            }
+          ]
+        }
+      }
+    ],
+    "notices": [
+      {
+        "source": {
+          "serviceUuid": "feed",
+          "path": "error"
+        }
+      },
+      {
+        "source": {
+          "serviceUuid": "each",
+          "path": "error"
+        }
+      },
+      {
+        "source": {
+          "serviceUuid": "each.voice.render",
+          "path": "error"
+        },
+        "tone": "error"
+      }
+    ],
+    "init": [
+      {
+        "type": "process",
+        "serviceUuid": "pl-base",
+        "payload": {}
+      },
+      {
+        "type": "process",
+        "serviceUuid": "pending-rows",
+        "payload": {}
+      }
+    ]
+  }
+}