Waters ChurchandClaude Fable 5.1
babe8263eb
Each campus signs its booth machine into Slack as the account named for the location, so a message from ProdDash reads as "Apollo Beach" rather than as whoever is at the desk. modules/slack (1.0.0) is three tiles from one module: the live transcript of one channel, a free-text Send tile and a Quick-replies grid — the last two behind a PIN pad, auto-locking after a configurable idle time. Server: one user (xoxp-) or bot (xoxb-) token, identified with auth.test; conversations.history polled every N seconds (thread replies via conversations.replies, capped per poll), diffed and fanned out as one `state` SSE snapshot; mrkdwn rendered to safe text on the server; sends through chat.postMessage (username/icon for a bot with "Send as"); PIN compared in constant time with a 5-wrong → 30 s lockout, 32-byte unlock tokens with a sliding expiry, 1 message/s, every send logged; readable messages for invalid_auth / token_revoked / missing_scope / not_in_channel / ratelimited; health reflects token → channel → poll → sending. SLACK_API_BASE points it at tools/slack-mock.js (new). Shell: the admin config form gains a multi-line field type `text` (a textarea; one item per line by convention) — used for the quick replies. Documented in the module guide; the mock is listed in CLAUDE.md. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
101 lines
3.9 KiB
JSON
101 lines
3.9 KiB
JSON
{
|
||
"id": "slack",
|
||
"name": "Slack",
|
||
"version": "1.0.0",
|
||
"proddash": ">=1.4.0",
|
||
"description": "A Slack channel's live transcript, plus PIN-protected sending as this location",
|
||
"client": "client.js",
|
||
"server": "server.js",
|
||
"style": "style.css",
|
||
"minSize": { "w": 2, "h": 2 },
|
||
"defaultSize": { "w": 4, "h": 4 },
|
||
"configGroups": {
|
||
"Slack account": {
|
||
"collapsed": "whenSet",
|
||
"help": "Create a Slack app in the workspace (api.slack.com/apps → Create New App → From scratch) and, under OAuth & Permissions → User Token Scopes, add channels:history, channels:read, groups:history, groups:read, chat:write and users:read (users:read.email is not needed). Sign in to Slack as this location's account — the one named for the campus — open the app's OAuth & Permissions page and press Install to Workspace (or Reinstall to Workspace), then copy the User OAuth Token (xoxp-…) it shows and paste it here: messages from this machine are then literally from the location. A bot token (xoxb-…) works too; it posts as the app, with \"Send as\" naming the location."
|
||
},
|
||
"Sending": {
|
||
"toggle": "sendEnabled",
|
||
"help": "Messages leave this machine only from a Send or Quick replies tile, and only after the PIN is entered on that tile — every tile asks again after Auto-lock minutes without a send. Sending stays refused until a 4–8 digit PIN is set here. Quick replies are one per line, Label | Message, with an optional | #channel-name to send that one somewhere other than the transcript channel."
|
||
}
|
||
},
|
||
"configSchema": {
|
||
"token": {
|
||
"type": "password",
|
||
"label": "Token",
|
||
"default": "",
|
||
"group": "Slack account",
|
||
"help": "The location account's User OAuth Token (xoxp-…, recommended) or a Bot User OAuth Token (xoxb-…)."
|
||
},
|
||
"sendAs": {
|
||
"type": "string",
|
||
"label": "Send as",
|
||
"default": "",
|
||
"group": "Slack account",
|
||
"help": "Only used with a bot token — a user token always sends as its own account; needs the chat:write.customize scope."
|
||
},
|
||
"channel": {
|
||
"type": "select",
|
||
"label": "Channel",
|
||
"default": "",
|
||
"group": "Channel",
|
||
"optionsRoute": "/channels",
|
||
"help": "The channel the transcript shows and messages go to by default. Only channels the account has joined are listed — join one in Slack first."
|
||
},
|
||
"pollSeconds": {
|
||
"type": "number",
|
||
"label": "Refresh interval (s)",
|
||
"default": 2,
|
||
"group": "Transcript",
|
||
"help": "How often the channel is re-read (1 s at the fastest)."
|
||
},
|
||
"historyCount": {
|
||
"type": "number",
|
||
"label": "Messages kept",
|
||
"default": 40,
|
||
"group": "Transcript"
|
||
},
|
||
"includeReplies": {
|
||
"type": "switch",
|
||
"label": "Thread replies",
|
||
"default": false,
|
||
"group": "Transcript"
|
||
},
|
||
"sendEnabled": {
|
||
"type": "switch",
|
||
"label": "Sending",
|
||
"default": false,
|
||
"group": "Sending"
|
||
},
|
||
"pin": {
|
||
"type": "password",
|
||
"label": "PIN",
|
||
"default": "",
|
||
"group": "Sending",
|
||
"help": "4–8 digits; asked every time a send tile opens."
|
||
},
|
||
"pinIdleMinutes": {
|
||
"type": "number",
|
||
"label": "Auto-lock (min)",
|
||
"default": 10,
|
||
"group": "Sending"
|
||
},
|
||
"quickReplies": {
|
||
"type": "text",
|
||
"label": "Quick replies",
|
||
"default": "",
|
||
"group": "Sending",
|
||
"help": "One per line: Label | Message. Add | #channel-name to send one somewhere else."
|
||
}
|
||
},
|
||
"instanceGroups": {
|
||
"Transcript": { "collapsed": false }
|
||
},
|
||
"instanceSchema": {
|
||
"textSize": { "type": "number", "label": "Text size (px)", "default": 14 },
|
||
"showTimes": { "type": "switch", "label": "Timestamps", "default": true, "group": "Transcript" },
|
||
"showNames": { "type": "switch", "label": "Names", "default": true, "group": "Transcript" },
|
||
"showSystem": { "type": "switch", "label": "System lines", "default": true, "group": "Transcript" }
|
||
}
|
||
}
|