@readymadeit/mcp 0.0.0-stage → 0.1.0

package/bundle/boards/offer-intake-imap-demo-board.json

@@ -0,0 +1,289 @@
+{
+  "boardName": "Offer Intake (IMAP)",
+  "description": "Enquiries arrive as email and wait. A person approves the ones worth processing; each approved one is read, extracted into fields, and written on. The mailbox is watched over IMAP IDLE, so new mail pushes itself into the board — there is nothing to poll and nothing to expose. Set host, username and password on the Mailbox service (the password is write-only and never saved back into this board). Extraction runs against a local model, so start one first: ./build/bin/llama-server -m ~/Development/claude/models/Qwen3-0.6B-Q8_0.gguf --port 8081",
+  "runtimes": [
+    {
+      "id": "intake",
+      "name": "1 · Intake",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    },
+    {
+      "id": "queue",
+      "name": "2 · Waiting",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    },
+    {
+      "id": "process",
+      "name": "3 · Processing",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    },
+    {
+      "id": "requeue",
+      "name": "4 · Back to waiting",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    }
+  ],
+  "services": {
+    "intake": [
+      {
+        "uuid": "mailbox",
+        "serviceId": "imap-email",
+        "serviceName": "Mailbox",
+        "state": {
+          "host": "",
+          "port": 993,
+          "username": "",
+          "tls": true,
+          "mailbox": "INBOX"
+        }
+      },
+      {
+        "uuid": "dump",
+        "serviceId": "store",
+        "serviceName": "Dump",
+        "state": {
+          "mode": "put",
+          "keyFrom": "messageId"
+        }
+      },
+      {
+        "uuid": "after-intake",
+        "serviceId": "stopper",
+        "serviceName": "Stored — Nothing Else Runs"
+      }
+    ],
+    "queue": [
+      {
+        "uuid": "refresh",
+        "serviceId": "timer",
+        "serviceName": "Queue Refresh",
+        "state": {
+          "periodic": true,
+          "periodicValue": 5,
+          "periodicUnit": "s",
+          "start": true
+        }
+      },
+      {
+        "uuid": "queue",
+        "serviceId": "store",
+        "serviceName": "Waiting",
+        "state": {
+          "mode": "list",
+          "show": "all",
+          "limit": 100
+        }
+      },
+      {
+        "uuid": "after-queue",
+        "serviceId": "stopper",
+        "serviceName": "The Panel Reads This"
+      }
+    ],
+    "process": [
+      {
+        "uuid": "approved",
+        "serviceId": "store",
+        "serviceName": "Approved",
+        "state": {
+          "mode": "release"
+        }
+      },
+      {
+        "uuid": "as-prompt",
+        "serviceId": "map",
+        "serviceName": "As Prompt",
+        "state": {
+          "mode": "replace",
+          "template": {
+            "key=": "params.key",
+            "text=": "'From: ' + (params.value.from || '(unknown)') + '\\nSubject: ' + (params.value.subject || '(none)') + '\\n\\n' + (params.value.text || params.value.body || JSON.stringify(params.value))"
+          }
+        }
+      },
+      {
+        "uuid": "extract",
+        "serviceId": "text-generation",
+        "serviceName": "Extract Offer",
+        "state": {
+          "backend": "server",
+          "serverUrl": "http://127.0.0.1:8081",
+          "model": "qwen3-0.6b",
+          "systemPrompt": "Extract the booking request from this enquiry. Leave a field out when the message does not state it — never guess.",
+          "thinking": false,
+          "maxTokens": 1024,
+          "jsonSchema": {
+            "type": "object",
+            "properties": {
+              "hotel": {
+                "type": "string"
+              },
+              "rooms": {
+                "type": "integer"
+              },
+              "roomType": {
+                "type": "string"
+              },
+              "arrival": {
+                "type": "string",
+                "description": "ISO date"
+              },
+              "departure": {
+                "type": "string",
+                "description": "ISO date"
+              },
+              "breakfastIncluded": {
+                "type": "boolean"
+              },
+              "specialRequests": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "hotel",
+              "rooms"
+            ]
+          }
+        }
+      },
+      {
+        "uuid": "result",
+        "serviceId": "monitor",
+        "serviceName": "Extracted",
+        "state": {
+          "logToBoard": true
+        }
+      },
+      {
+        "uuid": "settle",
+        "serviceId": "store",
+        "serviceName": "Acknowledge",
+        "state": {
+          "mode": "ack"
+        }
+      },
+      {
+        "uuid": "after-settle",
+        "serviceId": "stopper",
+        "serviceName": "Done — Nothing Else Runs"
+      }
+    ],
+    "requeue": [
+      {
+        "uuid": "return",
+        "serviceId": "store",
+        "serviceName": "Return To Queue",
+        "state": {
+          "mode": "requeue"
+        }
+      }
+    ]
+  },
+  "facade": {
+    "layout": "single",
+    "panels": [
+      {
+        "id": "approval",
+        "title": "Enquiries waiting",
+        "layout": {
+          "direction": "column",
+          "items": [
+            {
+              "type": "data-table",
+              "source": {
+                "serviceUuid": "queue",
+                "path": "records"
+              },
+              "selectable": true,
+              "rowKey": "key",
+              "selectionState": "picked",
+              "columns": [
+                "state",
+                "key",
+                "value.from",
+                "value.subject",
+                "createdAt"
+              ],
+              "pageSize": 10
+            },
+            {
+              "direction": "row",
+              "items": [
+                {
+                  "type": "button",
+                  "label": "Process selected",
+                  "actions": [
+                    {
+                      "type": "process",
+                      "serviceUuid": "approved",
+                      "payload": {
+                        "keys": {
+                          "$state": "picked"
+                        }
+                      }
+                    }
+                  ]
+                },
+                {
+                  "type": "button",
+                  "label": "Return to queue",
+                  "actions": [
+                    {
+                      "type": "process",
+                      "serviceUuid": "return",
+                      "payload": {
+                        "keys": {
+                          "$state": "picked"
+                        }
+                      }
+                    }
+                  ]
+                },
+                {
+                  "type": "status-indicator",
+                  "source": {
+                    "serviceUuid": "extract",
+                    "path": "status"
+                  },
+                  "statusColors": {
+                    "idle": "#22c55e",
+                    "generating": "#eab308",
+                    "error": "#ef4444"
+                  }
+                },
+                {
+                  "type": "text",
+                  "source": {
+                    "serviceUuid": "extract",
+                    "path": "error"
+                  },
+                  "tone": "error",
+                  "placeholder": "Ready"
+                }
+              ]
+            }
+          ]
+        }
+      }
+    ]
+  }
+}

package/bundle/boards/offer-intake-imap-hetzner-demo-board.json

@@ -0,0 +1,354 @@
+{
+  "runtimes": [
+    {
+      "id": "intake",
+      "name": "1 · Intake",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    },
+    {
+      "id": "queue",
+      "name": "2 · Waiting",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    },
+    {
+      "id": "process",
+      "name": "3 · Processing",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    },
+    {
+      "id": "requeue",
+      "name": "4 · Back to waiting",
+      "type": "rest",
+      "remote": "node",
+      "state": {
+        "wrapServices": false
+      }
+    }
+  ],
+  "services": {
+    "intake": [
+      {
+        "uuid": "mailbox",
+        "serviceId": "imap-email",
+        "serviceName": "IMAP Email",
+        "state": {
+          "host": "imap.gmail.com",
+          "port": 993,
+          "username": "bstckbrln@gmail.com",
+          "tls": true,
+          "mailbox": "INBOX",
+          "running": false,
+          "error": "",
+          "password": "{{secret.gmail.imap}}",
+          "passwordConfigured": false
+        }
+      },
+      {
+        "uuid": "dump",
+        "serviceId": "store",
+        "serviceName": "Store",
+        "state": {
+          "mode": "put",
+          "namespace": "",
+          "key": "",
+          "keyFrom": "messageId",
+          "valueFrom": "",
+          "limit": 0,
+          "show": "waiting",
+          "lastCount": 0,
+          "error": ""
+        }
+      },
+      {
+        "uuid": "after-intake",
+        "serviceId": "stopper",
+        "serviceName": "Stopper",
+        "state": {
+          "bypass": false
+        }
+      }
+    ],
+    "queue": [
+      {
+        "uuid": "refresh",
+        "serviceId": "timer",
+        "serviceName": "Timer",
+        "state": {
+          "periodic": true,
+          "periodicValue": 5,
+          "periodicUnit": "s",
+          "oneShotDelay": 0,
+          "oneShotDelayUnit": "ms",
+          "running": true,
+          "counter": 455
+        }
+      },
+      {
+        "uuid": "queue",
+        "serviceId": "store",
+        "serviceName": "Store",
+        "state": {
+          "mode": "list",
+          "namespace": "",
+          "key": "",
+          "keyFrom": "",
+          "valueFrom": "",
+          "limit": 100,
+          "show": "all",
+          "lastCount": 0,
+          "error": ""
+        }
+      },
+      {
+        "uuid": "after-queue",
+        "serviceId": "stopper",
+        "serviceName": "Stopper",
+        "state": {
+          "bypass": false
+        }
+      }
+    ],
+    "process": [
+      {
+        "uuid": "approved",
+        "serviceId": "store",
+        "serviceName": "Store",
+        "state": {
+          "mode": "release",
+          "namespace": "",
+          "key": "",
+          "keyFrom": "",
+          "valueFrom": "",
+          "limit": 0,
+          "show": "waiting",
+          "lastCount": 0,
+          "error": ""
+        }
+      },
+      {
+        "uuid": "as-prompt",
+        "serviceId": "map",
+        "serviceName": "Map",
+        "state": {
+          "mode": "replace",
+          "arrayMode": "array",
+          "template": {
+            "key=": "params.key",
+            "text=": "'From: ' + (params.value.from || '(unknown)') + '\\nSubject: ' + (params.value.subject || '(none)') + '\\n\\n' + (params.value.text || params.value.body || JSON.stringify(params.value))"
+          },
+          "sensingMode": false
+        }
+      },
+      {
+        "uuid": "extract",
+        "serviceId": "text-generation",
+        "serviceName": "Text Generation",
+        "state": {
+          "backend": "server",
+          "apiKey": "{{secret.hetzner.token}}",
+          "apiKeyConfigured": true,
+          "serverUrl": "https://inference.hetzner.com/api/v1",
+          "endpoint": "https://inference.hetzner.com/api/v1/chat/completions",
+          "model": "Qwen3.8-27B",
+          "systemPrompt": "Extract the booking request from this enquiry. Leave a field out when the message does not state it — never guess.",
+          "temperature": 0.7,
+          "topP": 0.95,
+          "topK": 20,
+          "maxTokens": 4096,
+          "timeoutSec": 300,
+          "stream": true,
+          "thinking": false,
+          "thinkingBudgetTokens": 1024,
+          "jsonSchema": {
+            "type": "object",
+            "properties": {
+              "hotel": {
+                "type": "string"
+              },
+              "rooms": {
+                "type": "integer"
+              },
+              "roomType": {
+                "type": "string"
+              },
+              "arrival": {
+                "type": "string",
+                "description": "ISO date"
+              },
+              "departure": {
+                "type": "string",
+                "description": "ISO date"
+              },
+              "breakfastIncluded": {
+                "type": "boolean"
+              },
+              "specialRequests": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": ["hotel", "rooms"]
+          },
+          "status": "idle",
+          "error": ""
+        }
+      },
+      {
+        "uuid": "result",
+        "serviceId": "monitor",
+        "serviceName": "Monitor",
+        "state": {
+          "fileLogPath": "",
+          "logToConsole": false,
+          "renderTextEditor": true,
+          "logToBoard": true
+        }
+      },
+      {
+        "uuid": "settle",
+        "serviceId": "store",
+        "serviceName": "Store",
+        "state": {
+          "mode": "ack",
+          "namespace": "",
+          "key": "",
+          "keyFrom": "",
+          "valueFrom": "",
+          "limit": 0,
+          "show": "waiting",
+          "lastCount": 0,
+          "error": ""
+        }
+      },
+      {
+        "uuid": "after-settle",
+        "serviceId": "stopper",
+        "serviceName": "Stopper",
+        "state": {
+          "bypass": false
+        }
+      }
+    ],
+    "requeue": [
+      {
+        "uuid": "return",
+        "serviceId": "store",
+        "serviceName": "Store",
+        "state": {
+          "mode": "requeue",
+          "namespace": "",
+          "key": "",
+          "keyFrom": "",
+          "valueFrom": "",
+          "limit": 0,
+          "show": "waiting",
+          "lastCount": 0,
+          "error": ""
+        }
+      }
+    ]
+  },
+  "description": "Enquiries arrive as email and wait. A person approves the ones worth processing; each approved one is read, extracted into fields, and written on. The mailbox is watched over IMAP IDLE, so new mail pushes itself into the board — there is nothing to poll and nothing to expose. Set host, username and password on the Mailbox service (the password is write-only and never saved back into this board). Extraction runs against a local model, so start one first: ./build/bin/llama-server -m ~/Development/claude/models/Qwen3-0.6B-Q8_0.gguf --port 8081",
+  "facade": {
+    "layout": "single",
+    "panels": [
+      {
+        "id": "approval",
+        "title": "Enquiries waiting",
+        "layout": {
+          "direction": "column",
+          "items": [
+            {
+              "type": "data-table",
+              "source": {
+                "serviceUuid": "queue",
+                "path": "records"
+              },
+              "selectable": true,
+              "rowKey": "key",
+              "selectionState": "picked",
+              "columns": [
+                "state",
+                "key",
+                "value.from",
+                "value.subject",
+                "createdAt"
+              ],
+              "pageSize": 10
+            },
+            {
+              "direction": "row",
+              "items": [
+                {
+                  "type": "button",
+                  "label": "Process selected",
+                  "actions": [
+                    {
+                      "type": "process",
+                      "serviceUuid": "approved",
+                      "payload": {
+                        "keys": {
+                          "$state": "picked"
+                        }
+                      }
+                    }
+                  ]
+                },
+                {
+                  "type": "button",
+                  "label": "Return to queue",
+                  "actions": [
+                    {
+                      "type": "process",
+                      "serviceUuid": "return",
+                      "payload": {
+                        "keys": {
+                          "$state": "picked"
+                        }
+                      }
+                    }
+                  ]
+                },
+                {
+                  "type": "status-indicator",
+                  "source": {
+                    "serviceUuid": "extract",
+                    "path": "status"
+                  },
+                  "statusColors": {
+                    "idle": "#22c55e",
+                    "generating": "#eab308",
+                    "error": "#ef4444"
+                  }
+                },
+                {
+                  "type": "text",
+                  "source": {
+                    "serviceUuid": "extract",
+                    "path": "error"
+                  },
+                  "tone": "error",
+                  "placeholder": "Ready"
+                }
+              ]
+            }
+          ]
+        }
+      }
+    ]
+  }
+}

package/bundle/boards/p2p-receiver-demo-board.json

@@ -0,0 +1,65 @@
+{
+  "boardName": "P2P Receiver",
+  "facade": {
+    "layout": "single",
+    "panels": [
+      {
+        "id": "receiver",
+        "title": "Received from peer",
+        "layout": {
+          "direction": "column",
+          "gap": 12,
+          "padding": 16,
+          "items": [
+            {
+              "type": "text-input",
+              "label": "Your name",
+              "placeholder": "The name senders will send to…",
+              "submitLabel": "Set name",
+              "action": {
+                "serviceUuid": "receiver-peer-svc",
+                "configure": { "peerName": "$$input" }
+              }
+            },
+            {
+              "type": "message-list",
+              "grow": true,
+              "source": { "serviceUuid": "receiver-monitor-svc" }
+            }
+          ]
+        }
+      }
+    ]
+  },
+  "runtimes": [
+    {
+      "id": "receiver-browser",
+      "name": "Browser",
+      "type": "browser",
+      "state": { "wrapServices": false, "minimized": false }
+    }
+  ],
+  "services": {
+    "receiver-browser": [
+      {
+        "uuid": "receiver-peer-svc",
+        "serviceId": "hookup.to/service/peer-socket",
+        "serviceName": "Peer Socket",
+        "state": {
+          "mode": "Receive only",
+          "peerName": "hkp-p2p-receiver",
+          "targetPeer": "hkp-p2p-sender",
+          "extractIncomingData": true,
+          "peerHost": "peerjs.hookitapp.com",
+          "peerPath": "/",
+          "peerSecure": true
+        }
+      },
+      {
+        "uuid": "receiver-monitor-svc",
+        "serviceId": "hookup.to/service/monitor",
+        "serviceName": "Monitor"
+      }
+    ]
+  }
+}