windsor-bot 0.1.0

package/dist/web/app.js

@@ -0,0 +1,325 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+/** @jsxImportSource preact */
+import { render } from 'preact';
+import { useEffect, useState } from 'preact/hooks';
+const S = {
+    box: { background: '#151922', border: '1px solid #2b3340', borderRadius: '10px', padding: '16px', marginBottom: '16px' },
+    input: { background: '#0f1115', color: '#f5f7fa', border: '1px solid #354051', borderRadius: '6px', padding: '8px 10px', width: '100%', boxSizing: 'border-box' },
+    btn: { background: '#2e7dff', color: '#fff', border: 'none', borderRadius: '6px', padding: '8px 14px', cursor: 'pointer', marginRight: '8px' },
+    btnDanger: { background: '#c0392b', color: '#fff', border: 'none', borderRadius: '6px', padding: '4px 10px', cursor: 'pointer' },
+    label: { display: 'block', marginBottom: '12px' },
+    labelText: { display: 'block', marginBottom: '4px', color: '#b4bdc8' },
+    select: { background: '#0f1115', color: '#f5f7fa', border: '1px solid #354051', borderRadius: '6px', padding: '8px 10px' },
+    th: { textAlign: 'left', padding: '8px', borderBottom: '1px solid #2b3340' },
+    td: { padding: '8px', borderBottom: '1px solid #1a2030', verticalAlign: 'top', wordBreak: 'break-word' },
+    row: { cursor: 'pointer', background: 'transparent' },
+    rowHover: { background: '#1a2030' },
+    grid2: { display: 'grid', gridTemplateColumns: '1fr 1fr', gap: '12px' },
+    grid3: { display: 'grid', gridTemplateColumns: '1fr 1fr 1fr', gap: '8px', alignItems: 'end' },
+    err: { color: '#ff8080', margin: '8px 0' },
+    ok: { color: '#8ff0a4', margin: '8px 0' },
+    mono: { fontFamily: 'monospace', fontSize: '0.85em' },
+};
+async function apiFetch(url, options) {
+    const res = await fetch(url, options);
+    const json = await res.json();
+    if (!res.ok)
+        throw new Error(json.error ?? 'Request failed');
+    return json;
+}
+function jsonPost(url, body) {
+    return apiFetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+}
+function jsonPut(url, body) {
+    return apiFetch(url, {
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+}
+async function jsonDelete(url) {
+    return apiFetch(url, { method: 'DELETE' });
+}
+function Field({ label, type = 'text', value, onChange, placeholder }) {
+    return (_jsxs("label", { style: S.label, children: [_jsx("span", { style: S.labelText, children: label }), _jsx("input", { type: type, value: value, placeholder: placeholder ?? '', onInput: e => onChange(e.currentTarget.value), style: S.input })] }));
+}
+function CheckField({ label, checked, onChange }) {
+    return (_jsxs("label", { style: { ...S.label, display: 'flex', alignItems: 'center', gap: '8px', cursor: 'pointer' }, children: [_jsx("input", { type: "checkbox", checked: checked, onChange: e => onChange(e.currentTarget.checked) }), label] }));
+}
+function BehaviorConfig({ config, onChange }) {
+    const t = config.type;
+    return (_jsxs("div", { style: { paddingTop: '12px' }, children: [(t === 'immediate-print' || t === 'accumulating-list' || t === 'recurring-print') && (_jsxs(_Fragment, { children: [_jsx(Field, { label: "Header", value: config.header ?? '', onChange: v => { const c = { ...config }; if (v) {
+                            c.header = v;
+                        }
+                        else {
+                            delete c.header;
+                        } onChange(c); }, placeholder: "Optional header text" }), _jsx(Field, { label: "Footer", value: config.footer ?? '', onChange: v => { const c = { ...config }; if (v) {
+                            c.footer = v;
+                        }
+                        else {
+                            delete c.footer;
+                        } onChange(c); }, placeholder: "Optional footer text" }), _jsx(CheckField, { label: "Include metadata footer", checked: config.includeMetadata ?? false, onChange: v => onChange({ ...config, includeMetadata: v }) })] })), (t === 'immediate-print' || t === 'recurring-print') && (_jsx(CheckField, { label: "Include AI-generated icon (requires OpenAI key)", checked: config.includeIcon ?? false, onChange: v => onChange({ ...config, includeIcon: v }) })), t === 'accumulating-list' && (_jsx(CheckField, { label: "Include checklist boxes", checked: config.includeChecklist ?? false, onChange: v => onChange({ ...config, includeChecklist: v }) }))] }));
+}
+function ChannelRow({ mapping, onDelete, onUpdate }) {
+    const [expanded, setExpanded] = useState(false);
+    const [hovered, setHovered] = useState(false);
+    return (_jsxs("tbody", { children: [_jsxs("tr", { style: hovered ? S.rowHover : S.row, onClick: () => setExpanded(!expanded), onMouseEnter: () => setHovered(true), onMouseLeave: () => setHovered(false), children: [_jsxs("td", { style: S.td, children: ["# ", mapping.channelName] }), _jsx("td", { style: S.td, children: mapping.config.type }), _jsx("td", { style: { ...S.td, textAlign: 'right' }, children: _jsx("button", { style: S.btnDanger, onClick: e => { e.stopPropagation(); onDelete(); }, children: "Delete" }) })] }), expanded && (_jsx("tr", { children: _jsx("td", { colSpan: 3, style: { ...S.td, background: '#0f1115', padding: '16px' }, children: _jsx(BehaviorConfig, { config: mapping.config, onChange: c => onUpdate(c) }) }) }))] }));
+}
+function BotSetup({ config, onSave }) {
+    const [discordToken, setDiscordToken] = useState(config?.discordToken ?? '');
+    const [serverId, setServerId] = useState(config?.serverId ?? '');
+    const [openaiKey, setOpenaiKey] = useState(config?.openaiKey ?? '');
+    const [diagnosticsPort, setDiagnosticsPort] = useState(String(config?.diagnosticsPort ?? 8080));
+    const [msg, setMsg] = useState('');
+    const [err, setErr] = useState('');
+    const [saving, setSaving] = useState(false);
+    useEffect(() => {
+        setDiscordToken(config?.discordToken ?? '');
+        setServerId(config?.serverId ?? '');
+        setOpenaiKey(config?.openaiKey ?? '');
+        setDiagnosticsPort(String(config?.diagnosticsPort ?? 8080));
+    }, [config?.discordToken, config?.openaiKey, config?.serverId, config?.diagnosticsPort]);
+    async function save() {
+        setSaving(true);
+        setErr('');
+        setMsg('');
+        try {
+            const body = {
+                discordToken: discordToken.trim(),
+                openaiKey: openaiKey.trim(),
+                serverId: serverId.trim() || null,
+                diagnosticsPort: Number(diagnosticsPort),
+            };
+            await jsonPost('/api/config', body);
+            setMsg('Saved.');
+            onSave();
+        }
+        catch (e) {
+            setErr(e instanceof Error ? e.message : String(e));
+        }
+        finally {
+            setSaving(false);
+        }
+    }
+    return (_jsxs("section", { style: S.box, children: [_jsx("h2", { style: { marginTop: 0 }, children: "Bot Setup" }), config && _jsxs("p", { style: { color: '#b4bdc8', marginTop: 0 }, children: ["Config: ", config.configPath] }), err && _jsx("p", { style: S.err, children: err }), msg && _jsx("p", { style: S.ok, children: msg }), _jsx(Field, { label: "Discord Token", value: discordToken, onChange: setDiscordToken, placeholder: "Discord bot token" }), _jsx(Field, { label: "Server ID (required)", value: serverId, onChange: setServerId, placeholder: "Required \u2014 Discord server ID" }), _jsx(Field, { label: "OpenAI Key", value: openaiKey, onChange: setOpenaiKey, placeholder: "OpenAI API key" }), _jsx(Field, { label: "Diagnostics Port", type: "number", value: diagnosticsPort, onChange: setDiagnosticsPort, placeholder: "8080" }), _jsx("button", { style: S.btn, onClick: () => void save(), disabled: saving, children: saving ? 'Saving…' : 'Save' })] }));
+}
+function ChannelBehaviors({ refreshKey }) {
+    const [data, setData] = useState(null);
+    const [err, setErr] = useState('');
+    const [addChannelId, setAddChannelId] = useState('');
+    const [addBehavior, setAddBehavior] = useState('immediate-print');
+    async function load() {
+        try {
+            const d = await apiFetch('/api/channels');
+            setData(d);
+        }
+        catch (e) {
+            setErr(e instanceof Error ? e.message : String(e));
+        }
+    }
+    useEffect(() => { void load(); }, [refreshKey]);
+    async function addMapping() {
+        if (!addChannelId)
+            return;
+        const dc = data?.discordChannels.find(c => c.id === addChannelId);
+        if (!dc)
+            return;
+        const defaultConfig = addBehavior === 'immediate-print'
+            ? { type: 'immediate-print', includeIcon: false, includeMetadata: false }
+            : addBehavior === 'accumulating-list'
+                ? { type: 'accumulating-list', includeChecklist: false, includeMetadata: false }
+                : addBehavior === 'recurring-print'
+                    ? { type: 'recurring-print', includeIcon: false, includeMetadata: false }
+                    : { type: 'on-demand' };
+        await jsonPost('/api/channels', { channelId: dc.id, channelName: dc.name, config: defaultConfig });
+        setAddChannelId('');
+        await load();
+    }
+    async function deleteChannel(id) {
+        await jsonDelete(`/api/channels/${id}`);
+        await load();
+    }
+    async function updateChannel(id, config) {
+        await jsonPut(`/api/channels/${id}`, { config });
+        await load();
+    }
+    async function refreshFromDiscord() {
+        try {
+            const d = await apiFetch('/api/channels/refresh', { method: 'POST' });
+            setData(d);
+        }
+        catch (e) {
+            setErr(e instanceof Error ? e.message : String(e));
+        }
+    }
+    return (_jsxs("section", { style: S.box, children: [_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: '12px', marginBottom: '12px' }, children: [_jsx("h2", { style: { marginTop: 0, marginBottom: 0 }, children: "Channel Behaviors" }), _jsx("button", { style: { ...S.btn, marginRight: 0 }, onClick: () => void refreshFromDiscord(), children: "Refresh Channels" })] }), err && _jsx("p", { style: S.err, children: err }), _jsxs("table", { style: { width: '100%', borderCollapse: 'collapse', marginBottom: '16px' }, children: [_jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { style: S.th, children: "Channel" }), _jsx("th", { style: S.th, children: "Behavior" }), _jsx("th", { style: { ...S.th, textAlign: 'right' }, children: "Actions" })] }) }), data?.channels.map(m => (_jsx(ChannelRow, { mapping: m, onDelete: () => void deleteChannel(m.channelId), onUpdate: c => void updateChannel(m.channelId, c) }, m.channelId))), (!data || data.channels.length === 0) && (_jsx("tbody", { children: _jsx("tr", { children: _jsx("td", { colSpan: 3, style: { ...S.td, color: '#b4bdc8' }, children: "No channel mappings yet." }) }) }))] }), _jsxs("div", { style: S.grid3, children: [_jsxs("label", { style: S.label, children: [_jsx("span", { style: S.labelText, children: "Channel" }), _jsxs("select", { style: S.select, value: addChannelId, onChange: e => setAddChannelId(e.currentTarget.value), children: [_jsx("option", { value: "", children: "Select channel\u2026" }), data?.unmapped.map(c => _jsxs("option", { value: c.id, children: ["#", c.name] }, c.id))] })] }), _jsxs("label", { style: S.label, children: [_jsx("span", { style: S.labelText, children: "Behavior" }), _jsxs("select", { style: S.select, value: addBehavior, onChange: e => setAddBehavior(e.currentTarget.value), children: [_jsx("option", { value: "immediate-print", children: "\uD83D\uDDA8\uFE0F Immediate Print" }), _jsx("option", { value: "accumulating-list", children: "\uD83D\uDED2 Accumulating List" }), _jsx("option", { value: "recurring-print", children: "\uD83D\uDD04 Recurring Print" }), _jsx("option", { value: "on-demand", children: "\uD83D\uDCAC On-Demand" })] })] }), _jsx("button", { style: S.btn, onClick: () => void addMapping(), disabled: !addChannelId, children: "Add" })] })] }));
+}
+function PrintModeSection() {
+    const [printConfig, setPrintConfig] = useState(null);
+    const [mode, setMode] = useState('escp');
+    // escp fields
+    const [serialPort, setSerialPort] = useState('/dev/ttyUSB0');
+    // cups fields
+    const [printerName, setPrinterName] = useState('');
+    const [paperSize, setPaperSize] = useState('Letter');
+    const [paperName, setPaperName] = useState('');
+    const [msg, setMsg] = useState('');
+    const [err, setErr] = useState('');
+    const [saving, setSaving] = useState(false);
+    const [testing, setTesting] = useState(false);
+    async function load() {
+        try {
+            const d = await apiFetch('/api/print-config');
+            if (d.printConfig) {
+                setPrintConfig(d.printConfig);
+                setMode(d.printConfig.mode);
+                if (d.printConfig.mode === 'escp')
+                    setSerialPort(d.printConfig.serialPort);
+                if (d.printConfig.mode === 'cups') {
+                    setPrinterName(d.printConfig.printerName);
+                    setPaperSize(d.printConfig.paperSize);
+                    setPaperName(d.printConfig.paperName);
+                }
+            }
+        }
+        catch (e) {
+            setErr(e instanceof Error ? e.message : String(e));
+        }
+    }
+    useEffect(() => { void load(); }, []);
+    async function save() {
+        setSaving(true);
+        setErr('');
+        setMsg('');
+        try {
+            let cfg;
+            if (mode === 'escp') {
+                cfg = { mode: 'escp', serialPort: serialPort.trim() };
+            }
+            else if (mode === 'cups') {
+                cfg = { mode: 'cups', printerName: printerName.trim(), paperSize: paperSize.trim(), paperName: paperName.trim() };
+            }
+            else {
+                cfg = { mode: 'imagefeed' };
+            }
+            await jsonPost('/api/print-config', { printConfig: cfg });
+            setPrintConfig(cfg);
+            setMsg('Print mode saved.');
+        }
+        catch (e) {
+            setErr(e instanceof Error ? e.message : String(e));
+        }
+        finally {
+            setSaving(false);
+        }
+    }
+    async function testPrint() {
+        setTesting(true);
+        setErr('');
+        setMsg('');
+        try {
+            await jsonPost('/api/printer/test', {});
+            setMsg(mode === 'imagefeed' ? 'Test job added to image feed.' : 'Test page sent to printer.');
+        }
+        catch (e) {
+            setErr(e instanceof Error ? e.message : String(e));
+        }
+        finally {
+            setTesting(false);
+        }
+    }
+    const modeLabel = {
+        escp: '🔌 ESC/P via Serial Port',
+        cups: '📄 PDF via CUPS',
+        imagefeed: '🖼️ Image Feed (testing)',
+    };
+    return (_jsxs("section", { style: S.box, children: [_jsx("h2", { style: { marginTop: 0 }, children: "Print Mode" }), err && _jsx("p", { style: S.err, children: err }), msg && _jsx("p", { style: S.ok, children: msg }), _jsxs("label", { style: S.label, children: [_jsx("span", { style: S.labelText, children: "Output Mode" }), _jsx("select", { style: S.select, value: mode, onChange: e => setMode(e.currentTarget.value), children: ['escp', 'cups', 'imagefeed'].map(m => (_jsx("option", { value: m, children: modeLabel[m] }, m))) })] }), mode === 'escp' && (_jsx(Field, { label: "Serial Port", value: serialPort, onChange: setSerialPort, placeholder: "e.g. /dev/ttyUSB0 or COM3" })), mode === 'cups' && _jsxs(_Fragment, { children: [_jsx(Field, { label: "CUPS Printer Name", value: printerName, onChange: setPrinterName, placeholder: "e.g. TM-T88V" }), _jsx(Field, { label: "Paper Size", value: paperSize, onChange: setPaperSize, placeholder: "e.g. Letter, A4, 80x297mm" }), _jsx(Field, { label: "Paper Name (display label)", value: paperName, onChange: setPaperName, placeholder: "e.g. Receipt Roll" })] }), mode === 'imagefeed' && (_jsxs("p", { style: { color: '#b4bdc8', marginTop: 0 }, children: ["Print jobs will be rendered as PNGs and shown at", ' ', _jsx("a", { href: "/feed", target: "_blank", rel: "noopener noreferrer", children: "/feed" }), "."] })), _jsxs("div", { style: { display: 'flex', gap: '8px', marginTop: '8px' }, children: [_jsx("button", { style: S.btn, onClick: () => void save(), disabled: saving, children: saving ? 'Saving…' : 'Save' }), _jsx("button", { style: { ...S.btn, background: '#1a7a3a' }, onClick: () => void testPrint(), disabled: testing || !printConfig, title: !printConfig ? 'Save a mode first' : '', children: testing ? 'Printing…' : 'Print Test Page' })] })] }));
+}
+function SecuritySection({ onSave }) {
+    const [password, setPassword] = useState('');
+    const [msg, setMsg] = useState('');
+    const [err, setErr] = useState('');
+    const [saving, setSaving] = useState(false);
+    async function save() {
+        setSaving(true);
+        setErr('');
+        setMsg('');
+        try {
+            await jsonPost('/api/config', { password });
+            setPassword('');
+            setMsg(password ? 'Password set.' : 'Password cleared.');
+            onSave();
+        }
+        catch (e) {
+            setErr(e instanceof Error ? e.message : String(e));
+        }
+        finally {
+            setSaving(false);
+        }
+    }
+    return (_jsxs("section", { style: S.box, children: [_jsx("h2", { style: { marginTop: 0 }, children: "Security" }), err && _jsx("p", { style: S.err, children: err }), msg && _jsx("p", { style: S.ok, children: msg }), _jsx(Field, { label: "Control Panel Password", type: "password", value: password, onChange: setPassword, placeholder: "Leave blank to remove password" }), _jsx("button", { style: S.btn, onClick: () => void save(), disabled: saving, children: saving ? 'Saving…' : 'Set Password' })] }));
+}
+function LogSection() {
+    const [events, setEvents] = useState([]);
+    const [status, setStatus] = useState(null);
+    async function load() {
+        const d = await apiFetch('/api/events');
+        setEvents(d.events);
+        setStatus(d.status);
+    }
+    useEffect(() => {
+        void load();
+        const t = setInterval(() => void load(), 4000);
+        return () => clearInterval(t);
+    }, []);
+    const typeColor = {
+        startup: '#8ab4ff',
+        success: '#8ff0a4',
+        error: '#ff8080',
+        print: '#ffd580',
+        info: '#b4bdc8',
+        command: '#d2a8ff',
+    };
+    return (_jsxs("section", { style: S.box, children: [_jsx("h2", { style: { marginTop: 0 }, children: "Bot Status & Log" }), status && (_jsxs("dl", { style: { display: 'grid', gridTemplateColumns: '140px 1fr', gap: '4px 12px', marginBottom: '16px' }, children: [_jsx("dt", { style: { color: '#b4bdc8' }, children: "Connected" }), _jsx("dd", { style: { margin: 0 }, children: status.connected ? '✅ yes' : '❌ no' }), _jsx("dt", { style: { color: '#b4bdc8' }, children: "Bot" }), _jsx("dd", { style: { margin: 0 }, children: status.tag ?? '—' }), _jsx("dt", { style: { color: '#b4bdc8' }, children: "Started" }), _jsx("dd", { style: { margin: 0 }, children: status.startedAt ?? '—' }), _jsx("dt", { style: { color: '#b4bdc8' }, children: "Server ID" }), _jsx("dd", { style: { margin: 0 }, children: status.configuredServerId ?? '—' }), _jsx("dt", { style: { color: '#b4bdc8' }, children: "Servers" }), _jsx("dd", { style: { margin: 0 }, children: status.guilds.join(', ') || '—' })] })), _jsx("div", { style: { maxHeight: '400px', overflow: 'auto', border: '1px solid #2b3340', borderRadius: '8px' }, children: events.length === 0 ? (_jsx("p", { style: { padding: '12px', margin: 0, color: '#b4bdc8' }, children: "No events yet." })) : (_jsxs("table", { style: { width: '100%', borderCollapse: 'collapse' }, children: [_jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { style: S.th, children: "Time" }), _jsx("th", { style: S.th, children: "Type" }), _jsx("th", { style: S.th, children: "Message" })] }) }), _jsx("tbody", { children: events.map((e, i) => (_jsxs("tr", { children: [_jsx("td", { style: { ...S.td, ...S.mono, whiteSpace: 'nowrap' }, children: e.timestamp }), _jsx("td", { style: { ...S.td, color: typeColor[e.type] ?? '#b4bdc8' }, children: e.type }), _jsx("td", { style: S.td, children: e.message })] }, String(i)))) })] })) })] }));
+}
+function RestartSection() {
+    const [msg, setMsg] = useState('');
+    const [err, setErr] = useState('');
+    const [restarting, setRestarting] = useState(false);
+    async function restart() {
+        setRestarting(true);
+        setErr('');
+        setMsg('');
+        try {
+            await jsonPost('/api/restart', {});
+            setMsg('Restart signal sent. The server will restart shortly.');
+        }
+        catch (e) {
+            setErr(e instanceof Error ? e.message : String(e));
+            setRestarting(false);
+        }
+    }
+    return (_jsxs("section", { style: S.box, children: [_jsx("h2", { style: { marginTop: 0 }, children: "Server Control" }), err && _jsx("p", { style: S.err, children: err }), msg && _jsx("p", { style: S.ok, children: msg }), _jsx("button", { style: { ...S.btn, background: '#8a6d00' }, onClick: () => void restart(), disabled: restarting, children: restarting ? 'Restarting…' : 'Restart Server' })] }));
+}
+function App() {
+    const [config, setConfig] = useState(null);
+    const [refreshKey, setRefreshKey] = useState(0);
+    async function loadConfig() {
+        const d = await apiFetch('/api/config');
+        setConfig(d);
+    }
+    useEffect(() => { void loadConfig(); }, []);
+    function handleSave() {
+        void loadConfig();
+        setRefreshKey(k => k + 1);
+    }
+    return (_jsxs("main", { style: { maxWidth: '860px', margin: '0 auto', padding: '24px' }, children: [_jsx("h1", { style: { marginTop: 0 }, children: "\uD83D\uDDA8\uFE0F Windsor Control Panel" }), _jsx(BotSetup, { config: config, onSave: handleSave }), _jsx(ChannelBehaviors, { refreshKey: refreshKey }), _jsx(PrintModeSection, {}), _jsx(SecuritySection, { onSave: () => void loadConfig() }), _jsx(LogSection, {}), _jsx(RestartSection, {})] }));
+}
+const root = document.getElementById('app');
+if (!root)
+    throw new Error('Missing #app');
+render(_jsx(App, {}), root);

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "windsor-bot",
+  "version": "0.1.0",
+  "description": "Self-hosted Discord bot automation for household list and todo printing",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "prepare": "tsc",
+    "build": "tsc",
+    "dev": "node src/index.ts",
+    "test": "node --test src/tests/*.test.ts"
+  },
+  "bin": {
+    "windsor-bot": "./dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SeaRyanC/windsor-bot.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/SeaRyanC/windsor-bot/issues"
+  },
+  "homepage": "https://github.com/SeaRyanC/windsor-bot#readme",
+  "devDependencies": {
+    "@types/node": "^26.1.2",
+    "typescript": "^7.0.2"
+  },
+  "dependencies": {
+    "@types/pdfkit": "^0.17.6",
+    "@types/qrcode": "^1.5.6",
+    "discord.js": "^14.27.0",
+    "esbuild": "^0.28.1",
+    "escpos-buffer": "^4.1.0",
+    "jimp": "^1.6.1",
+    "openai": "^7.3.0",
+    "pdfkit": "^0.19.1",
+    "preact": "^10.29.7",
+    "qrcode": "^1.5.4",
+    "serialport": "^13.0.0",
+    "zod": "^4.4.3"
+  }
+}

package/scripts/download-pokemon-sprites.mjs

@@ -0,0 +1,38 @@
+// Downloads Gen 1 GameBoy (yellow/gray) sprites for all 151 Kanto pokemon.
+// Run once: node scripts/download-pokemon-sprites.mjs
+
+import { mkdir, writeFile, access } from 'fs/promises';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const OUT_DIR = join(__dirname, '../src/commands/pokemon-sprites');
+
+const BASE_URL = 'https://raw.githubusercontent.com/PokeAPI/sprites/master/sprites/pokemon/versions/generation-i/yellow/gray';
+
+await mkdir(OUT_DIR, { recursive: true });
+
+let ok = 0, skipped = 0, failed = 0;
+
+for (let id = 1; id <= 151; id++) {
+    const dest = join(OUT_DIR, `${id}.png`);
+    try {
+        await access(dest);
+        skipped++;
+        continue;
+    } catch { /* not downloaded yet */ }
+
+    const url = `${BASE_URL}/${id}.png`;
+    const res = await fetch(url);
+    if (!res.ok) {
+        console.error(`FAIL #${id}: HTTP ${res.status}`);
+        failed++;
+        continue;
+    }
+    const buf = Buffer.from(await res.arrayBuffer());
+    await writeFile(dest, buf);
+    process.stdout.write(`\r${id}/151`);
+    ok++;
+}
+
+console.log(`\nDone. Downloaded: ${ok}, Skipped (already existed): ${skipped}, Failed: ${failed}`);

package/src/ai.ts

@@ -0,0 +1,214 @@
+import { createHash } from 'crypto';
+import { mkdir, writeFile, readFile, access } from 'fs/promises';
+import { join } from 'path';
+import OpenAI from 'openai';
+import { zodResponseFormat } from 'openai/helpers/zod.js';
+import { z } from 'zod/v4';
+import { getCurrentConfig, updateConfig } from './config.ts';
+import { logEvent } from './server.ts';
+
+const MODEL = 'gpt-5.4-nano';
+const IMAGE_MODEL = 'gpt-image-1-mini';
+const TOKEN_LIMIT_24H = 200_000;
+
+
+export function trackTokenUsage(tokens: number): void {
+    const config = getCurrentConfig();
+    const entry = { timestamp: new Date().toISOString(), tokens };
+    const usage = [...config.tokenUsage, entry];
+    // Keep only entries from the last 24 hours
+    const cutoff = new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString();
+    const pruned = usage.filter(e => e.timestamp >= cutoff);
+    void updateConfig({ tokenUsage: pruned });
+}
+
+export function getTokenUsage24h(): number {
+    const config = getCurrentConfig();
+    const cutoff = new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString();
+    return config.tokenUsage
+        .filter(e => e.timestamp >= cutoff)
+        .reduce((sum, e) => sum + e.tokens, 0);
+}
+
+export async function isOverTokenLimit(): Promise<boolean> {
+    const used = getTokenUsage24h();
+    if (used >= TOKEN_LIMIT_24H) {
+        logEvent('error', `Token limit exceeded (${used} tokens in last 24h). Deleting OpenAI key.`);
+        const config = getCurrentConfig();
+        const updated = { ...config };
+        delete updated.openaiKey;
+        await updateConfig(updated);
+        return true;
+    }
+    return false;
+}
+
+
+function getClient(): OpenAI | null {
+    const key = getCurrentConfig().openaiKey;
+    if (!key) return null;
+    return new OpenAI({ apiKey: key });
+}
+
+
+const ScheduleSchema = z.object({
+    'message without schedule': z.string(),
+    'next occurrence': z.string(),
+});
+
+type ScheduleResult = z.infer<typeof ScheduleSchema>;
+
+export interface ParsedSchedule {
+    message: string;
+    nextOccurrence: Date;
+}
+
+function parseOccurrenceDate(str: string): Date | null {
+    try {
+        const d = new Date(str);
+        if (!isNaN(d.getTime())) return d;
+    } catch {
+        // ignore
+    }
+    return null;
+}
+
+export async function parseRecurringSchedule(userMessage: string, now: Date): Promise<ParsedSchedule | null> {
+    const client = getClient();
+    if (!client) return null;
+
+    if (await isOverTokenLimit()) return null;
+
+    const nowStr = formatScheduleDate(now);
+    const prompt = `The user has asked for a recurring printout. It is currently ${nowStr}. Tell me the next time that I should do this, and what the non-schedule part of the message was (verbatim). If the user didn't specify a time of day, use 8:00 AM. Here's the user's message: ${userMessage}`;
+
+    const results: ScheduleResult[] = [];
+    const ATTEMPTS = 5;
+
+    for (let i = 0; i < ATTEMPTS; i++) {
+        try {
+            const completion = await client.chat.completions.create({
+                model: MODEL,
+                reasoning_effort: 'low',
+                messages: [{ role: 'user', content: prompt }],
+                response_format: zodResponseFormat(ScheduleSchema, 'schedule'),
+            } as Parameters<typeof client.chat.completions.create>[0]) as import("openai/resources/chat/completions/completions.js").ChatCompletion;
+            const content = completion.choices[0]?.message?.content;
+            if (content) {
+                const parsed = ScheduleSchema.parse(JSON.parse(content));
+                results.push(parsed);
+                const tokens = (completion as { usage?: { total_tokens?: number } }).usage?.total_tokens ?? 0;
+                trackTokenUsage(tokens);
+            }
+        } catch (err) {
+            logEvent('error', `Schedule parsing attempt ${i + 1} failed: ${err}`);
+        }
+    }
+
+    if (results.length < 3) return null;
+
+    // Majority voting: need 60% consistency for each field
+    const messageCounts = new Map<string, number>();
+    const occurrenceCounts = new Map<string, number>();
+
+    for (const r of results) {
+        messageCounts.set(r['message without schedule'], (messageCounts.get(r['message without schedule']) ?? 0) + 1);
+        occurrenceCounts.set(r['next occurrence'], (occurrenceCounts.get(r['next occurrence']) ?? 0) + 1);
+    }
+
+    const threshold = ATTEMPTS * 0.6;
+
+    let bestMessage: string | null = null;
+    for (const [msg, count] of messageCounts) {
+        if (count >= threshold) { bestMessage = msg; break; }
+    }
+
+    let bestOccurrence: string | null = null;
+    for (const [occ, count] of occurrenceCounts) {
+        if (count >= threshold) { bestOccurrence = occ; break; }
+    }
+
+    if (!bestMessage || !bestOccurrence) return null;
+
+    const occDate = parseOccurrenceDate(bestOccurrence);
+    if (!occDate) return null;
+
+    return { message: bestMessage, nextOccurrence: occDate };
+}
+
+function formatScheduleDate(date: Date): string {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    let hours = date.getHours();
+    const minutes = String(date.getMinutes()).padStart(2, '0');
+    const ampm = hours >= 12 ? 'PM' : 'AM';
+    hours = hours % 12 || 12;
+    return `${year}-${month}-${day} ${hours}:${minutes} ${ampm}`;
+}
+
+export { formatScheduleDate };
+
+export async function getNextOccurrence(originalMessage: string, now: Date): Promise<Date | null> {
+    const result = await parseRecurringSchedule(originalMessage, now);
+    return result ? result.nextOccurrence : null;
+}
+
+export async function generateIcon(text: string, cacheDir: string): Promise<string | null> {
+    const prompt = `Black-on-transparent line drawing icon for the TODO item: "${text}". Do not produce any text. Use big, thick lines. No fine detailing.`;
+    const hash = createHash('sha1').update(prompt).digest('hex').slice(0, 9);
+    const filename = `${hash}.png`;
+    const cachePath = join(cacheDir, filename);
+
+    // Check cache first
+    try {
+        await access(cachePath);
+        return cachePath;
+    } catch {
+        // not cached
+    }
+
+    const client = getClient();
+    if (!client) return null;
+
+    if (await isOverTokenLimit()) return null;
+
+    for (let attempt = 0; attempt < 3; attempt++) {
+        try {
+            const response = await client.images.generate({
+                model: IMAGE_MODEL,
+                prompt,
+                n: 1,
+                size: '1024x1024',
+                quality: 'low',
+                background: 'transparent',
+                output_format: 'png',
+            } as Parameters<typeof client.images.generate>[0]) as import("openai/resources/images.js").ImagesResponse;
+
+            const imageData = response.data?.[0];
+            if (!imageData) throw new Error('No image data returned');
+
+            let imageBuffer: Buffer;
+            if ('b64_json' in imageData && imageData.b64_json) {
+                imageBuffer = Buffer.from(imageData.b64_json, 'base64');
+            } else if ('url' in imageData && imageData.url) {
+                const res = await fetch(imageData.url);
+                imageBuffer = Buffer.from(await res.arrayBuffer());
+            } else {
+                throw new Error('No image URL or base64 data');
+            }
+
+            await mkdir(cacheDir, { recursive: true });
+            await writeFile(cachePath, imageBuffer);
+            return cachePath;
+        } catch (err) {
+            logEvent('error', `Icon generation attempt ${attempt + 1} failed: ${err}`);
+            if (attempt === 2) return null;
+        }
+    }
+
+    return null;
+}
+
+// suppress unused import warning
+void readFile;