@readymadeit/mcp 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,555 @@
+{
+  "boardName": "Radio Editor",
+  "description": "A feed, briefed. Every minute it reads the feed it was given; any article it has not read before is fetched, read by a language model, and given a short brief written to be heard rather than read. What it publishes is the same feed again, with the brief where the feed's own line was.\n\nAn article appears in what it publishes **only once its brief is written**, so whatever reads that feed never sees an article before the editor has. That is the whole of its contract with the radio: the radio reads a feed, as it always did, and this one happens to say something worth hearing.\n\nThree things in its pipeline are worth reading closely. **The claim** is one SQL statement that takes an article it has not seen or hands back nothing, so an article already taken stops its own pass. **Two detours** \u2014 the page, then the brief \u2014 each go off and come back *beside* the article rather than instead of it, which is how the brief still knows which article it belongs to. And **a failure is recorded, not retried**: a page that cannot be read or fetched is noted, and the model briefs from the title and the feed's line alone; a brief that fails is kept on the desk with the reason the model or the API gave, and waits for a person \u2014 **Retry** runs that one article again, **Use the feed's line** publishes it with the line its feed gave it. A brief that started and never finished counts as failed after `stuckAfter`.\n\nThe model is Claude on hkp-node's `anthropic` backend, with the key from `{{secret.anthropic.key}}` in Settings \u2192 Secrets. A key that names a secret is that secret or nothing: hkp-node reads no key from its environment. To brief with a local model instead, set the `backend` param to `server`, `serverUrl` to an OpenAI-compatible server, and `apiKey` to empty (or to the token that server wants).\n\nNeeds hkp-node, kept as the remote `node`.",
+  "unit": {
+    "name": "editor",
+    "params": {
+      "feedUrl": "https://hnrss.org/frontpage",
+      "feedName": "Hacker News",
+      "database": "rss-editor",
+      "stuckAfter": "-10 minutes",
+      "backend": "anthropic",
+      "model": "claude-haiku-5-5",
+      "serverUrl": "",
+      "feedTitle": "Briefed",
+      "feedDescription": "Each article with a short brief, written to be heard",
+      "apiKey": "{{secret.anthropic.key}}"
+    }
+  },
+  "runtimes": [
+    {
+      "id": "edit",
+      "name": "Editor",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    },
+    {
+      "id": "briefs",
+      "name": "Briefed",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    },
+    {
+      "id": "fallback",
+      "name": "The feed's line",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    }
+  ],
+  "services": {
+    "edit": [
+      {
+        "uuid": "edit-tick",
+        "serviceId": "timer",
+        "serviceName": "Every minute",
+        "state": {
+          "periodic": true,
+          "periodicValue": 60,
+          "periodicUnit": "s",
+          "running": true
+        }
+      },
+      {
+        "uuid": "edit-feed",
+        "serviceId": "rss",
+        "serviceName": "The feed",
+        "state": {
+          "feeds": [
+            {
+              "url": "{{param.feedUrl}}",
+              "name": "{{param.feedName}}"
+            }
+          ],
+          "limit": 10,
+          "summaryChars": 400
+        }
+      },
+      {
+        "uuid": "edit-each",
+        "serviceId": "iterator",
+        "serviceName": "Each article",
+        "state": {
+          "pipeline": [
+            {
+              "instanceId": "name",
+              "serviceId": "map",
+              "serviceName": "Name it",
+              "state": {
+                "mode": "add",
+                "template": {
+                  "guid=": "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 brief (\n  guid       TEXT PRIMARY KEY,\n  link       TEXT NOT NULL DEFAULT '',\n  title      TEXT NOT NULL DEFAULT '',\n  blurb      TEXT NOT NULL DEFAULT '',\n  feed       TEXT NOT NULL DEFAULT '',\n  published  TEXT NOT NULL DEFAULT '',\n  seen       TEXT NOT NULL DEFAULT (datetime('now')),\n  started    TEXT,\n  failed     TEXT,\n  error      TEXT,\n  page_error TEXT,\n  brief      TEXT,\n  source     TEXT,\n  written    TEXT\n);\nCREATE INDEX IF NOT EXISTS brief_link ON brief(link);",
+                "statement": "INSERT INTO brief (guid, link, title, blurb, feed, published, started)\nVALUES ($guid, IFNULL($link, ''), IFNULL($title, ''), IFNULL($summary, ''),\n        IFNULL($feed, ''), IFNULL($published, ''), datetime('now'))\nON CONFLICT(guid) DO UPDATE\n   SET started = datetime('now'), failed = NULL, error = NULL, page_error = NULL\n WHERE $retry = 1 AND brief.written IS NULL\nRETURNING guid, title, link, blurb"
+              }
+            },
+            {
+              "instanceId": "new",
+              "serviceId": "map",
+              "serviceName": "Only the new one",
+              "state": {
+                "mode": "replace",
+                "template": {
+                  "=": "params.count ? params.rows[0] : null"
+                }
+              }
+            },
+            {
+              "instanceId": "page",
+              "serviceId": "join",
+              "serviceName": "The page",
+              "state": {
+                "as": "page",
+                "pipeline": [
+                  {
+                    "instanceId": "where",
+                    "serviceId": "map",
+                    "serviceName": "Its address",
+                    "state": {
+                      "mode": "replace",
+                      "template": {
+                        "meta.method": "get",
+                        "meta.url=": "params.link"
+                      }
+                    }
+                  },
+                  {
+                    "instanceId": "fetch",
+                    "serviceId": "http-client",
+                    "serviceName": "Fetch it",
+                    "state": {
+                      "url": "",
+                      "method": "get",
+                      "userAgent": "Mozilla/5.0 (compatible; ReadymadeRadioEditor/1.0)",
+                      "timeoutMs": 20000
+                    }
+                  },
+                  {
+                    "instanceId": "readable",
+                    "serviceId": "map",
+                    "serviceName": "Only a page",
+                    "state": {
+                      "mode": "replace",
+                      "template": {
+                        "=": "params.meta.status === 200 && params.body ? params : 'The article could not be read.'"
+                      }
+                    }
+                  },
+                  {
+                    "instanceId": "text",
+                    "serviceId": "document-extract",
+                    "serviceName": "Its text",
+                    "state": {
+                      "backend": "builtin",
+                      "ocr": "off",
+                      "maxChars": 16000
+                    }
+                  }
+                ],
+                "onFailure": "merge"
+              }
+            },
+            {
+              "instanceId": "brief",
+              "serviceId": "join",
+              "serviceName": "The brief",
+              "state": {
+                "as": "brief",
+                "pipeline": [
+                  {
+                    "instanceId": "ask",
+                    "serviceId": "map",
+                    "serviceName": "What to read",
+                    "state": {
+                      "mode": "replace",
+                      "template": {
+                        "prompt=": "'Title: ' + params.title + '\\n\\nThe feed says: ' + withoutUrls(params.blurb) + '\\n\\nThe article:\\n' + (params.page.text || 'The article could not be read.')"
+                      }
+                    }
+                  },
+                  {
+                    "instanceId": "write",
+                    "serviceId": "text-generation",
+                    "serviceName": "Write the brief",
+                    "state": {
+                      "backend": "{{param.backend}}",
+                      "model": "{{param.model}}",
+                      "serverUrl": "{{param.serverUrl}}",
+                      "apiKey": "{{param.apiKey}}",
+                      "systemPrompt": "You write the brief a radio presenter reads after an article's title. Say what the article reports or argues and why it matters, in two to four plain sentences and at most 80 words. It will be heard, not read: no markdown, lists, headings, links or quotation marks, and do not open with the title or with phrases like 'This article'. Use only what the text gives you. When the article text is missing or is not the article (an error page, a paywall, a cookie notice), work from the title and the feed's line alone and say less rather than guess.",
+                      "maxTokens": 2000,
+                      "temperature": 0.3,
+                      "stream": false
+                    }
+                  }
+                ],
+                "onFailure": "merge"
+              }
+            },
+            {
+              "instanceId": "keep",
+              "serviceId": "map",
+              "serviceName": "What happened",
+              "state": {
+                "mode": "replace",
+                "template": {
+                  "guid=": "params.guid",
+                  "brief=": "params.brief.text || null",
+                  "error=": "params.brief.error || null",
+                  "pageError=": "params.page.error || null"
+                }
+              }
+            },
+            {
+              "instanceId": "note",
+              "serviceId": "sql",
+              "serviceName": "Record it",
+              "state": {
+                "mode": "run",
+                "database": "{{param.database}}",
+                "schema": "CREATE TABLE IF NOT EXISTS brief (\n  guid       TEXT PRIMARY KEY,\n  link       TEXT NOT NULL DEFAULT '',\n  title      TEXT NOT NULL DEFAULT '',\n  blurb      TEXT NOT NULL DEFAULT '',\n  feed       TEXT NOT NULL DEFAULT '',\n  published  TEXT NOT NULL DEFAULT '',\n  seen       TEXT NOT NULL DEFAULT (datetime('now')),\n  started    TEXT,\n  failed     TEXT,\n  error      TEXT,\n  page_error TEXT,\n  brief      TEXT,\n  source     TEXT,\n  written    TEXT\n);\nCREATE INDEX IF NOT EXISTS brief_link ON brief(link);",
+                "statement": "UPDATE brief\n   SET brief      = $brief,\n       source     = CASE WHEN $brief IS NOT NULL THEN 'model' END,\n       written    = CASE WHEN $brief IS NOT NULL THEN datetime('now') END,\n       failed     = CASE WHEN $brief IS NULL THEN datetime('now') END,\n       error      = CASE WHEN $brief IS NULL THEN IFNULL($error, 'the brief came back empty') END,\n       page_error = $pageError\n WHERE guid = $guid"
+              }
+            }
+          ]
+        }
+      },
+      {
+        "uuid": "edit-end",
+        "serviceId": "stopper",
+        "serviceName": "End of the round",
+        "state": {}
+      }
+    ],
+    "briefs": [
+      {
+        "uuid": "briefs-tick",
+        "serviceId": "timer",
+        "serviceName": "Every ten seconds",
+        "state": {
+          "periodic": true,
+          "periodicValue": 10,
+          "periodicUnit": "s",
+          "running": true
+        }
+      },
+      {
+        "uuid": "rows",
+        "serviceId": "sql",
+        "serviceName": "The desk, newest first",
+        "state": {
+          "mode": "query",
+          "database": "{{param.database}}",
+          "schema": "CREATE TABLE IF NOT EXISTS brief (\n  guid       TEXT PRIMARY KEY,\n  link       TEXT NOT NULL DEFAULT '',\n  title      TEXT NOT NULL DEFAULT '',\n  blurb      TEXT NOT NULL DEFAULT '',\n  feed       TEXT NOT NULL DEFAULT '',\n  published  TEXT NOT NULL DEFAULT '',\n  seen       TEXT NOT NULL DEFAULT (datetime('now')),\n  started    TEXT,\n  failed     TEXT,\n  error      TEXT,\n  page_error TEXT,\n  brief      TEXT,\n  source     TEXT,\n  written    TEXT\n);\nCREATE INDEX IF NOT EXISTS brief_link ON brief(link);",
+          "statement": "SELECT guid, title, link, feed, blurb, published,\n       IFNULL(brief, '') AS brief,\n       CASE\n         WHEN written IS NOT NULL AND source = 'feed'\n           THEN 'The feed''s own line, chosen ' || written\n         WHEN written IS NOT NULL AND page_error IS NOT NULL\n           THEN 'Briefed ' || written || ' from the title and the feed''s line \u2014 the page: ' || page_error\n         WHEN written IS NOT NULL THEN 'Briefed ' || written\n         WHEN failed IS NOT NULL THEN 'Failed: ' || IFNULL(error, 'no reason given')\n         WHEN started < datetime('now', '{{param.stuckAfter}}')\n           THEN 'Failed: no answer since ' || started\n         ELSE 'Briefing\u2026 since ' || started\n       END AS status,\n       CASE WHEN written IS NULL\n             AND (failed IS NOT NULL OR started < datetime('now', '{{param.stuckAfter}}'))\n            THEN 0 ELSE 1 END AS settled\n  FROM brief\n ORDER BY seen DESC\n LIMIT 50"
+        }
+      },
+      {
+        "uuid": "briefs-seen",
+        "serviceId": "monitor",
+        "serviceName": "The desk",
+        "state": {}
+      },
+      {
+        "uuid": "briefs-about",
+        "serviceId": "map",
+        "serviceName": "What the feed is called",
+        "state": {
+          "mode": "replace",
+          "template": {
+            "channelTitle": "{{param.feedTitle}}",
+            "channelDescription": "{{param.feedDescription}}",
+            "channelLink": "hkp-mount://briefs/briefs-serve"
+          }
+        }
+      },
+      {
+        "uuid": "briefs-doc",
+        "serviceId": "sql",
+        "serviceName": "The briefed articles as a feed",
+        "state": {
+          "mode": "query",
+          "database": "{{param.database}}",
+          "schema": "CREATE TABLE IF NOT EXISTS brief (\n  guid       TEXT PRIMARY KEY,\n  link       TEXT NOT NULL DEFAULT '',\n  title      TEXT NOT NULL DEFAULT '',\n  blurb      TEXT NOT NULL DEFAULT '',\n  feed       TEXT NOT NULL DEFAULT '',\n  published  TEXT NOT NULL DEFAULT '',\n  seen       TEXT NOT NULL DEFAULT (datetime('now')),\n  started    TEXT,\n  failed     TEXT,\n  error      TEXT,\n  page_error TEXT,\n  brief      TEXT,\n  source     TEXT,\n  written    TEXT\n);\nCREATE INDEX IF NOT EXISTS brief_link ON brief(link);",
+          "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(guid, '&', '&amp;'), '<', '&lt;'), '>', '&gt;') || '</guid>'\n        || '<pubDate>' || IFNULL(published, '') || '</pubDate>'\n        || '<category><![CDATA[' || replace(IFNULL(feed, ''), ']]>', ']]&gt;') || ']]></category>'\n        || '<description><![CDATA[' || replace(COALESCE(NULLIF(brief, ''), blurb, ''), ']]>', ']]&gt;') || ']]></description>'\n        || '</item>' AS item,\n           seen AS sortKey\n      FROM brief\n     WHERE written IS NOT NULL\n     ORDER BY seen DESC\n     LIMIT 100\n  )"
+        }
+      },
+      {
+        "uuid": "briefs-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": "briefs-serve",
+        "serviceId": "http-server-subservices",
+        "serviceName": "Serve the feed",
+        "state": {
+          "bypass": false,
+          "mountName": "briefs",
+          "onProcess": [
+            {
+              "instanceId": "keep-briefs",
+              "serviceId": "hold",
+              "serviceName": "Keep the document",
+              "state": {
+                "slot": "document",
+                "op": "write"
+              }
+            }
+          ],
+          "onRequest": [
+            {
+              "instanceId": "serve-briefs",
+              "serviceId": "hold",
+              "serviceName": "Serve the document",
+              "state": {
+                "slot": "document",
+                "op": "read"
+              }
+            }
+          ]
+        }
+      }
+    ],
+    "fallback": [
+      {
+        "uuid": "fb-which",
+        "serviceId": "map",
+        "serviceName": "Only a request naming an article",
+        "state": {
+          "mode": "replace",
+          "template": {
+            "=": "params.useFeedLine && params.guid ? params : null"
+          }
+        }
+      },
+      {
+        "uuid": "fb-row",
+        "serviceId": "sql",
+        "serviceName": "The feed's line as its brief",
+        "state": {
+          "mode": "run",
+          "database": "{{param.database}}",
+          "schema": "CREATE TABLE IF NOT EXISTS brief (\n  guid       TEXT PRIMARY KEY,\n  link       TEXT NOT NULL DEFAULT '',\n  title      TEXT NOT NULL DEFAULT '',\n  blurb      TEXT NOT NULL DEFAULT '',\n  feed       TEXT NOT NULL DEFAULT '',\n  published  TEXT NOT NULL DEFAULT '',\n  seen       TEXT NOT NULL DEFAULT (datetime('now')),\n  started    TEXT,\n  failed     TEXT,\n  error      TEXT,\n  page_error TEXT,\n  brief      TEXT,\n  source     TEXT,\n  written    TEXT\n);\nCREATE INDEX IF NOT EXISTS brief_link ON brief(link);",
+          "statement": "UPDATE brief\n   SET brief = blurb, source = 'feed', written = datetime('now'),\n       failed = NULL, error = NULL\n WHERE guid = $guid AND written IS NULL"
+        }
+      }
+    ]
+  },
+  "facade": {
+    "layout": "single",
+    "panels": [
+      {
+        "id": "editor",
+        "title": "Editor",
+        "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": "edit-feed",
+                      "payload": {}
+                    }
+                  ],
+                  "indicator": {
+                    "source": {
+                      "serviceUuid": "edit-feed",
+                      "path": "fetching"
+                    },
+                    "statusColors": {
+                      "true": "#f59e0b",
+                      "false": "#22c55e"
+                    }
+                  }
+                },
+                {
+                  "type": "text",
+                  "label": "Articles in the feed",
+                  "source": {
+                    "serviceUuid": "edit-feed",
+                    "path": "count"
+                  },
+                  "placeholder": "\u2014",
+                  "grow": true
+                }
+              ]
+            },
+            {
+              "type": "text",
+              "placeholder": "Every article the editor has taken from its feed, newest first, and where it is: being briefed, briefed, or failed \u2014 with the reason. It checks the feed every minute by itself. A failed brief waits for you: try it again, or publish it with the line its feed gave it.",
+              "tone": "muted",
+              "fontSize": 12
+            },
+            {
+              "type": "repeat",
+              "source": {
+                "serviceUuid": "briefs-seen",
+                "path": "rows"
+              },
+              "gap": 0,
+              "template": {
+                "direction": "column",
+                "gap": 4,
+                "items": [
+                  {
+                    "type": "text",
+                    "placeholder": "{{item.title}}",
+                    "href": "{{item.link}}",
+                    "fontSize": 14
+                  },
+                  {
+                    "type": "text",
+                    "placeholder": "{{item.feed}} \u00b7 {{item.status}}",
+                    "tone": "muted",
+                    "fontSize": 11
+                  },
+                  {
+                    "type": "text",
+                    "placeholder": "{{item.brief}}",
+                    "fontSize": 13
+                  },
+                  {
+                    "direction": "row",
+                    "gap": 8,
+                    "items": [
+                      {
+                        "type": "button",
+                        "label": "Retry",
+                        "disabled": "{{item.settled}}",
+                        "actions": [
+                          {
+                            "type": "process",
+                            "serviceUuid": "edit-each.name",
+                            "payload": {
+                              "id": "{{item.guid}}",
+                              "link": "{{item.link}}",
+                              "title": "{{item.title}}",
+                              "summary": "{{item.blurb}}",
+                              "feed": "{{item.feed}}",
+                              "published": "{{item.published}}",
+                              "retry": 1
+                            }
+                          },
+                          {
+                            "type": "process",
+                            "serviceUuid": "rows",
+                            "payload": {}
+                          }
+                        ]
+                      },
+                      {
+                        "type": "button",
+                        "label": "Use the feed's line",
+                        "disabled": "{{item.settled}}",
+                        "actions": [
+                          {
+                            "type": "process",
+                            "serviceUuid": "fb-which",
+                            "payload": {
+                              "guid": "{{item.guid}}",
+                              "useFeedLine": true
+                            }
+                          },
+                          {
+                            "type": "process",
+                            "serviceUuid": "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": "briefs-serve",
+                "path": "__hkpMount"
+              },
+              "placeholder": "not published yet",
+              "tone": "muted",
+              "fontSize": 11,
+              "wrap": true,
+              "copyable": true
+            }
+          ]
+        }
+      }
+    ],
+    "notices": [
+      {
+        "source": {
+          "serviceUuid": "edit-feed",
+          "path": "error"
+        }
+      },
+      {
+        "source": {
+          "serviceUuid": "edit-each",
+          "path": "error"
+        }
+      },
+      {
+        "source": {
+          "serviceUuid": "edit-each.brief.write",
+          "path": "error"
+        },
+        "tone": "error"
+      }
+    ],
+    "init": [
+      {
+        "type": "process",
+        "serviceUuid": "rows",
+        "payload": {}
+      }
+    ]
+  }
+}