slotlock 0.7.0 → 0.9.0

package/dashboard-markdown.js

@@ -0,0 +1,157 @@
+// The assistant's replies are Markdown. This renders the part of it a chat reply uses (paragraphs,
+// headings, lists, quotes, rules, tables, code, bold, italic, strikethrough, http(s) links) as HTML,
+// escaping everything first, so no input reaches the page as markup.
+//
+// It is one self-contained function on purpose: the dashboard's app.js embeds its source
+// (Function.prototype.toString) to render a reply while it streams, and the server renders the
+// stored reply with the very same function, so both always agree. Keep it free of imports and of
+// anything outside its own body.
+/** Safe HTML for a chat reply written in Markdown. */
+export function renderSlotlockMarkdown(source) {
+    const text = String(source).replace(/\u0000/g, '').replace(/\r\n?/g, '\n');
+    const escape = (value) => value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+    const inline = (value) => {
+        const codes = [];
+        let out = value.replace(/`([^`\n]+)`/g, (_match, code) => {
+            codes.push(`<code>${escape(code)}</code>`);
+            return `\u0000${codes.length - 1}\u0000`;
+        });
+        const links = [];
+        out = out.replace(/\[([^\]\n]+)\]\((https?:\/\/[^\s)]+)\)/g, (_match, label, url) => {
+            links.push(`<a href="${escape(url)}" rel="noopener noreferrer">${escape(label)}</a>`);
+            return `\u0001${links.length - 1}\u0001`;
+        });
+        out = escape(out)
+            .replace(/\*\*(?=\S)([^\n]*?\S)\*\*/g, '<strong>$1</strong>')
+            .replace(/__(?=\S)([^\n]*?\S)__/g, '<strong>$1</strong>')
+            .replace(/~~(?=\S)([^\n]*?\S)~~/g, '<del>$1</del>')
+            .replace(/(^|[^*\w])\*(?=[^\s*])([^*\n]*?[^\s*])\*(?!\*)/g, '$1<em>$2</em>')
+            .replace(/(^|[^_\w])_(?=[^\s_])([^_\n]*?[^\s_])_(?![_\w])/g, '$1<em>$2</em>');
+        return out
+            .replace(/\u0001(\d+)\u0001/g, (_match, index) => {
+            const link = links[Number(index)] ?? '';
+            // A link's label keeps its own emphasis out: it was escaped whole.
+            return link;
+        })
+            .replace(/\u0000(\d+)\u0000/g, (_match, index) => codes[Number(index)] ?? '');
+    };
+    const cells = (line) => line
+        .trim()
+        .replace(/^\|/, '')
+        .replace(/\|$/, '')
+        .split('|')
+        .map((cell) => cell.trim());
+    const isRule = (line) => /^\s*\|?\s*:?-+:?\s*(\|\s*:?-+:?\s*)*\|?\s*$/.test(line);
+    const listItem = /^(\s*)([-*+]|\d{1,9}[.)])\s+(.*)$/;
+    const lines = text.split('\n');
+    const blocks = [];
+    let paragraph = [];
+    const flush = () => {
+        if (paragraph.length > 0)
+            blocks.push(`<p>${paragraph.map(inline).join('<br>')}</p>`);
+        paragraph = [];
+    };
+    for (let i = 0; i < lines.length;) {
+        const line = lines[i] ?? '';
+        const fence = /^\s*(```|~~~)/.exec(line);
+        if (fence) {
+            flush();
+            const close = fence[1] ?? '```';
+            const body = [];
+            i += 1;
+            while (i < lines.length && !(lines[i] ?? '').trim().startsWith(close)) {
+                body.push(lines[i] ?? '');
+                i += 1;
+            }
+            i += 1;
+            blocks.push(`<pre><code>${escape(body.join('\n'))}</code></pre>`);
+            continue;
+        }
+        if (line.trim() === '') {
+            flush();
+            i += 1;
+            continue;
+        }
+        const heading = /^\s{0,3}(#{1,6})\s+(.*?)\s*#*\s*$/.exec(line);
+        if (heading) {
+            flush();
+            blocks.push(`<h4>${inline(heading[2] ?? '')}</h4>`);
+            i += 1;
+            continue;
+        }
+        if (/^\s{0,3}([-*_])(\s*\1){2,}\s*$/.test(line) && !listItem.test(line.replace(/\s+$/, '') + ' x')) {
+            flush();
+            blocks.push('<hr>');
+            i += 1;
+            continue;
+        }
+        if (line.includes('|') && isRule(lines[i + 1] ?? '') && cells(line).length > 1) {
+            flush();
+            const head = cells(line);
+            const rows = [];
+            i += 2;
+            while (i < lines.length && (lines[i] ?? '').includes('|') && (lines[i] ?? '').trim() !== '') {
+                rows.push(cells(lines[i] ?? ''));
+                i += 1;
+            }
+            blocks.push(`<div class="md-table"><table><thead><tr>${head.map((cell) => `<th>${inline(cell)}</th>`).join('')}</tr></thead><tbody>${rows
+                .map((row) => `<tr>${head.map((_cell, index) => `<td>${inline(row[index] ?? '')}</td>`).join('')}</tr>`)
+                .join('')}</tbody></table></div>`);
+            continue;
+        }
+        if (/^\s{0,3}>/.test(line)) {
+            flush();
+            const quoted = [];
+            while (i < lines.length && /^\s{0,3}>/.test(lines[i] ?? '')) {
+                quoted.push((lines[i] ?? '').replace(/^\s{0,3}>\s?/, ''));
+                i += 1;
+            }
+            blocks.push(`<blockquote>${quoted.map(inline).join('<br>')}</blockquote>`);
+            continue;
+        }
+        if (listItem.test(line)) {
+            flush();
+            // Lists nest by indentation; each level is the kind (ordered or not) of its first item.
+            let html = '';
+            const open = [];
+            while (i < lines.length) {
+                const current = lines[i] ?? '';
+                const item = listItem.exec(current);
+                if (!item) {
+                    // A wrapped line continues the item above it; a blank line or anything else ends the list.
+                    if (current.trim() !== '' && /^\s+\S/.test(current) && open.length > 0) {
+                        html += `<br>${inline(current.trim())}`;
+                        i += 1;
+                        continue;
+                    }
+                    break;
+                }
+                const indent = (item[1] ?? '').replace(/\t/g, '    ').length;
+                const tag = /\d/.test(item[2] ?? '') ? 'ol' : 'ul';
+                const top = open.at(-1);
+                if (!top || indent > top.indent + 1) {
+                    if (top)
+                        html = html.replace(/<\/li>$/, '');
+                    html += `<${tag}>`;
+                    open.push({ indent, tag });
+                }
+                else {
+                    while (open.length > 1 && indent < (open.at(-1)?.indent ?? 0) - 1) {
+                        html += `</li></${open.pop()?.tag}>`;
+                    }
+                    html += '</li>';
+                }
+                html += `<li>${inline(item[3] ?? '')}`;
+                i += 1;
+            }
+            while (open.length > 0)
+                html += `</li></${open.pop()?.tag}>`;
+            blocks.push(html);
+            continue;
+        }
+        paragraph.push(line.trim());
+        i += 1;
+    }
+    flush();
+    return blocks.join('');
+}

package/dashboard-settings-ui.d.ts

@@ -0,0 +1 @@
+export declare const SLOTLOCK_SETTINGS_CSS = "\n.settings { display: grid; grid-template-columns: 176px minmax(0, 640px); gap: var(--space-8); align-items: start; }\n.subnav { display: grid; gap: 2px; position: sticky; top: var(--space-6); }\n.subnav a { display: flex; align-items: center; gap: var(--space-2); height: 32px; padding: 0 var(--space-3); border-radius: var(--radius-sm); color: var(--ink-2); font-size: 14px; text-decoration: none; }\n.subnav a:hover { background: var(--hover); color: var(--ink); }\n.subnav a[aria-current=\"page\"] { background: var(--surface); color: var(--ink); font-weight: 500; box-shadow: inset 0 0 0 1px var(--line); }\n.subnav .nav-dot { width: 6px; height: 6px; border-radius: 50%; margin-left: auto; background: var(--good); }\n.settings-body { display: grid; gap: var(--space-6); min-width: 0; }\n.settings-body > .notice { margin: 0; }\n.card-head { margin: 0 0 calc(var(--space-2) - var(--space-6)); font-size: 13px; font-weight: 600; color: var(--ink-3); }\n.set-card { background: var(--surface); border: 1px solid var(--line); border-radius: 10px; overflow: hidden; margin: 0; }\n.row { display: grid; grid-template-columns: minmax(120px, 160px) minmax(0, 1fr); gap: var(--space-4); align-items: center; min-height: 56px; padding: 12px 20px; border-top: 1px solid var(--line-soft); }\n.row.stack { grid-template-columns: minmax(0, 1fr); gap: var(--space-3); align-items: start; padding-top: 16px; padding-bottom: 16px; }\n.row:first-child { border-top: 0; }\n.row-label { font-size: 14px; font-weight: 500; color: var(--ink); }\n.row-value { font-size: 14px; color: var(--ink); min-width: 0; overflow-wrap: anywhere; }\n.row-value.muted { color: var(--ink-2); }\n.row input:not([type=\"radio\"]):not([type=\"checkbox\"]), .row select { width: 100%; }\n.mono { font-family: var(--mono); font-size: 13px; }\n.card-foot { display: flex; align-items: center; justify-content: space-between; gap: var(--space-4); padding: 12px 20px; border-top: 1px solid var(--line); background: color-mix(in srgb, var(--surface) 70%, var(--canvas)); }\n.card-foot .fine { margin: 0; }\n.card-foot .primary { flex: none; }\n.status-head { display: grid; grid-template-columns: 32px minmax(0, 1fr) auto auto; gap: var(--space-3); align-items: center; padding: 16px 20px; }\n.status-head form { margin: 0; }\n.mono-tile { display: grid; place-items: center; width: 32px; height: 32px; border-radius: var(--radius); background: var(--sunken); border: 1px solid var(--line); color: var(--ink); font-weight: 600; font-size: 14px; }\n.status-name { display: grid; gap: 2px; min-width: 0; }\n.status-name strong { font-size: 15px; font-weight: 600; color: var(--ink); }\n.status-name code { color: var(--ink-3); font-size: 12.5px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; background: none; padding: 0; }\n.badge { display: inline-flex; align-items: center; gap: 6px; height: 22px; padding: 0 8px; border-radius: var(--radius-full); font-size: 12px; font-weight: 500; color: var(--ink-2); background: var(--sunken); white-space: nowrap; }\n.badge::before { content: \"\"; width: 6px; height: 6px; border-radius: 50%; background: var(--ink-3); }\n.badge.ok { color: var(--good); background: color-mix(in srgb, var(--good) 14%, transparent); }\n.badge.ok::before { background: var(--good); }\n.badge.bad { color: var(--bad); background: color-mix(in srgb, var(--bad) 14%, transparent); }\n.badge.bad::before { background: var(--bad); }\n.status-card .notice { margin: 0; border-radius: 0; border-width: 1px 0 0; box-shadow: none; font-size: 13px; padding: 10px 20px; }\n.status-card .notice.done { color: var(--ink); }\n.tiles { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: var(--space-2); }\n.tile { position: relative; display: flex; align-items: center; gap: var(--space-2); height: 40px; padding: 0 10px; border: 1px solid var(--line); border-radius: var(--radius); background: var(--surface); font-size: 14px; color: var(--ink); cursor: pointer; transition: border-color var(--fast) var(--ease), background var(--fast) var(--ease); }\n.tile:hover { background: var(--hover); }\n.tile input { position: absolute; opacity: 0; pointer-events: none; }\n.tile .tile-mark { display: grid; place-items: center; flex: none; width: 20px; height: 20px; border-radius: 5px; background: var(--sunken); color: var(--ink-2); font-size: 11px; font-weight: 600; }\n.tile:has(input:checked) { border-color: var(--accent); box-shadow: inset 0 0 0 1px var(--accent); }\n.tile:has(input:checked) .tile-mark { background: var(--accent); color: var(--surface); }\n.tile:has(input:focus-visible) { box-shadow: 0 0 0 3px var(--ring); }\n.provider-form:not(:has(input[name=\"preset\"][value=\"custom\"]:checked)) .custom-only { display: none; }\n.segmented { justify-self: start; display: inline-flex; padding: 2px; border: 1px solid var(--line); border-radius: var(--radius); background: var(--sunken); gap: 2px; }\n.segmented label { position: relative; display: inline-flex; align-items: center; height: 30px; padding: 0 12px; border-radius: 6px; font-size: 13px; color: var(--ink-2); cursor: pointer; }\n.segmented input { position: absolute; opacity: 0; pointer-events: none; }\n.segmented label:has(input:checked) { background: var(--surface); color: var(--ink); box-shadow: 0 0 0 1px var(--line); }\n.field-with-button { display: flex; gap: var(--space-2); align-items: center; }\n.field-with-button input { flex: 1; min-width: 0; }\n.field-with-button button { flex: none; }\n.key-set { display: flex; align-items: center; gap: var(--space-3); flex-wrap: wrap; }\n.key-set code { background: none; padding: 0; color: var(--ink-2); letter-spacing: 0.04em; }\n.key-set details { display: contents; }\n.key-set details > summary { list-style: none; cursor: pointer; color: var(--accent); font-size: 13px; }\n.key-set details > summary::-webkit-details-marker { display: none; }\n.key-set details[open] > summary { display: none; }\n.key-set details[open] input { flex-basis: 100%; }\n.danger-row { display: flex; align-items: center; justify-content: space-between; gap: var(--space-4); padding: 14px 20px; }\n.danger-row strong { font-size: 14px; font-weight: 500; color: var(--ink); }\n.danger-row details.act > summary { color: var(--bad); }\n@media (max-width: 760px) {\n  .settings { grid-template-columns: minmax(0, 1fr); gap: var(--space-4); }\n  .subnav { position: static; display: flex; overflow-x: auto; gap: 0; border-bottom: 1px solid var(--line); scrollbar-width: none; }\n  .subnav::-webkit-scrollbar { display: none; }\n  .subnav a { height: 40px; border-radius: 0; flex: none; }\n  .subnav a[aria-current=\"page\"] { background: none; box-shadow: inset 0 -2px 0 var(--accent); }\n  .row { grid-template-columns: minmax(0, 1fr); gap: var(--space-2); padding: 12px 16px; }\n  .tiles { grid-template-columns: repeat(2, minmax(0, 1fr)); }\n  .status-head { grid-template-columns: 32px minmax(0, 1fr) auto; padding: 14px 16px; }\n  .status-head form { grid-column: 1 / -1; }\n  .card-foot { flex-direction: column; align-items: stretch; padding: 12px 16px; }\n  .card-foot .primary { height: 44px; }\n}\n";

package/dashboard-settings-ui.js

@@ -0,0 +1,78 @@
+// The dashboard Settings pages' styles: a section list beside one column of cards, label-left rows,
+// provider tiles, and the assistant's status card. dashboard.ts renders the pages.
+export const SLOTLOCK_SETTINGS_CSS = `
+.settings { display: grid; grid-template-columns: 176px minmax(0, 640px); gap: var(--space-8); align-items: start; }
+.subnav { display: grid; gap: 2px; position: sticky; top: var(--space-6); }
+.subnav a { display: flex; align-items: center; gap: var(--space-2); height: 32px; padding: 0 var(--space-3); border-radius: var(--radius-sm); color: var(--ink-2); font-size: 14px; text-decoration: none; }
+.subnav a:hover { background: var(--hover); color: var(--ink); }
+.subnav a[aria-current="page"] { background: var(--surface); color: var(--ink); font-weight: 500; box-shadow: inset 0 0 0 1px var(--line); }
+.subnav .nav-dot { width: 6px; height: 6px; border-radius: 50%; margin-left: auto; background: var(--good); }
+.settings-body { display: grid; gap: var(--space-6); min-width: 0; }
+.settings-body > .notice { margin: 0; }
+.card-head { margin: 0 0 calc(var(--space-2) - var(--space-6)); font-size: 13px; font-weight: 600; color: var(--ink-3); }
+.set-card { background: var(--surface); border: 1px solid var(--line); border-radius: 10px; overflow: hidden; margin: 0; }
+.row { display: grid; grid-template-columns: minmax(120px, 160px) minmax(0, 1fr); gap: var(--space-4); align-items: center; min-height: 56px; padding: 12px 20px; border-top: 1px solid var(--line-soft); }
+.row.stack { grid-template-columns: minmax(0, 1fr); gap: var(--space-3); align-items: start; padding-top: 16px; padding-bottom: 16px; }
+.row:first-child { border-top: 0; }
+.row-label { font-size: 14px; font-weight: 500; color: var(--ink); }
+.row-value { font-size: 14px; color: var(--ink); min-width: 0; overflow-wrap: anywhere; }
+.row-value.muted { color: var(--ink-2); }
+.row input:not([type="radio"]):not([type="checkbox"]), .row select { width: 100%; }
+.mono { font-family: var(--mono); font-size: 13px; }
+.card-foot { display: flex; align-items: center; justify-content: space-between; gap: var(--space-4); padding: 12px 20px; border-top: 1px solid var(--line); background: color-mix(in srgb, var(--surface) 70%, var(--canvas)); }
+.card-foot .fine { margin: 0; }
+.card-foot .primary { flex: none; }
+.status-head { display: grid; grid-template-columns: 32px minmax(0, 1fr) auto auto; gap: var(--space-3); align-items: center; padding: 16px 20px; }
+.status-head form { margin: 0; }
+.mono-tile { display: grid; place-items: center; width: 32px; height: 32px; border-radius: var(--radius); background: var(--sunken); border: 1px solid var(--line); color: var(--ink); font-weight: 600; font-size: 14px; }
+.status-name { display: grid; gap: 2px; min-width: 0; }
+.status-name strong { font-size: 15px; font-weight: 600; color: var(--ink); }
+.status-name code { color: var(--ink-3); font-size: 12.5px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; background: none; padding: 0; }
+.badge { display: inline-flex; align-items: center; gap: 6px; height: 22px; padding: 0 8px; border-radius: var(--radius-full); font-size: 12px; font-weight: 500; color: var(--ink-2); background: var(--sunken); white-space: nowrap; }
+.badge::before { content: ""; width: 6px; height: 6px; border-radius: 50%; background: var(--ink-3); }
+.badge.ok { color: var(--good); background: color-mix(in srgb, var(--good) 14%, transparent); }
+.badge.ok::before { background: var(--good); }
+.badge.bad { color: var(--bad); background: color-mix(in srgb, var(--bad) 14%, transparent); }
+.badge.bad::before { background: var(--bad); }
+.status-card .notice { margin: 0; border-radius: 0; border-width: 1px 0 0; box-shadow: none; font-size: 13px; padding: 10px 20px; }
+.status-card .notice.done { color: var(--ink); }
+.tiles { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: var(--space-2); }
+.tile { position: relative; display: flex; align-items: center; gap: var(--space-2); height: 40px; padding: 0 10px; border: 1px solid var(--line); border-radius: var(--radius); background: var(--surface); font-size: 14px; color: var(--ink); cursor: pointer; transition: border-color var(--fast) var(--ease), background var(--fast) var(--ease); }
+.tile:hover { background: var(--hover); }
+.tile input { position: absolute; opacity: 0; pointer-events: none; }
+.tile .tile-mark { display: grid; place-items: center; flex: none; width: 20px; height: 20px; border-radius: 5px; background: var(--sunken); color: var(--ink-2); font-size: 11px; font-weight: 600; }
+.tile:has(input:checked) { border-color: var(--accent); box-shadow: inset 0 0 0 1px var(--accent); }
+.tile:has(input:checked) .tile-mark { background: var(--accent); color: var(--surface); }
+.tile:has(input:focus-visible) { box-shadow: 0 0 0 3px var(--ring); }
+.provider-form:not(:has(input[name="preset"][value="custom"]:checked)) .custom-only { display: none; }
+.segmented { justify-self: start; display: inline-flex; padding: 2px; border: 1px solid var(--line); border-radius: var(--radius); background: var(--sunken); gap: 2px; }
+.segmented label { position: relative; display: inline-flex; align-items: center; height: 30px; padding: 0 12px; border-radius: 6px; font-size: 13px; color: var(--ink-2); cursor: pointer; }
+.segmented input { position: absolute; opacity: 0; pointer-events: none; }
+.segmented label:has(input:checked) { background: var(--surface); color: var(--ink); box-shadow: 0 0 0 1px var(--line); }
+.field-with-button { display: flex; gap: var(--space-2); align-items: center; }
+.field-with-button input { flex: 1; min-width: 0; }
+.field-with-button button { flex: none; }
+.key-set { display: flex; align-items: center; gap: var(--space-3); flex-wrap: wrap; }
+.key-set code { background: none; padding: 0; color: var(--ink-2); letter-spacing: 0.04em; }
+.key-set details { display: contents; }
+.key-set details > summary { list-style: none; cursor: pointer; color: var(--accent); font-size: 13px; }
+.key-set details > summary::-webkit-details-marker { display: none; }
+.key-set details[open] > summary { display: none; }
+.key-set details[open] input { flex-basis: 100%; }
+.danger-row { display: flex; align-items: center; justify-content: space-between; gap: var(--space-4); padding: 14px 20px; }
+.danger-row strong { font-size: 14px; font-weight: 500; color: var(--ink); }
+.danger-row details.act > summary { color: var(--bad); }
+@media (max-width: 760px) {
+  .settings { grid-template-columns: minmax(0, 1fr); gap: var(--space-4); }
+  .subnav { position: static; display: flex; overflow-x: auto; gap: 0; border-bottom: 1px solid var(--line); scrollbar-width: none; }
+  .subnav::-webkit-scrollbar { display: none; }
+  .subnav a { height: 40px; border-radius: 0; flex: none; }
+  .subnav a[aria-current="page"] { background: none; box-shadow: inset 0 -2px 0 var(--accent); }
+  .row { grid-template-columns: minmax(0, 1fr); gap: var(--space-2); padding: 12px 16px; }
+  .tiles { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+  .status-head { grid-template-columns: 32px minmax(0, 1fr) auto; padding: 14px 16px; }
+  .status-head form { grid-column: 1 / -1; }
+  .card-foot { flex-direction: column; align-items: stretch; padding: 12px 16px; }
+  .card-foot .primary { height: 44px; }
+}
+`;

package/dashboard.d.ts

@@ -4,13 +4,16 @@ import { type SlotlockAgentCalendarBackend, type SlotlockAgentOperation, type Sl
 import { type SlotlockAssistantStore } from './assistant.js';
 import { type SlotlockRate } from './config.js';
 import { type SlotlockBookingRules } from './booking-rules.js';
-import { type SlotlockTenantPlan } from './plans.js';
+import { type SlotlockPlan, type SlotlockTenantPlan } from './plans.js';
 import { type SlotlockLocation, type SlotlockResourceGroup, type SlotlockResourceProfileInput } from './resource-profile.js';
 import { type SlotlockUsageRow } from './usage.js';
 import { type CreateWebhookEndpointResult, type SlotlockChange, type SlotlockWebhookEndpoint } from './event-feed.js';
 import type { SlotlockSql, SlotlockStore, SlotlockWaitlistEntry } from './store.js';
+import type { SlotlockAvailabilityDefaults, SlotlockAvailabilityExceptionInput, SlotlockHolidayCalendar, SlotlockOverrideResources } from './availability-store.js';
+import { type SlotlockAvailabilityException } from './hours.js';
+import { type SlotlockHolidaySource } from './holiday-import.js';
 import { type SlotlockSandboxScenario } from './sandbox.js';
-import type { Interval, SlotlockAgendaEntry, SlotlockApproval, SlotlockResource, SlotlockBookingRuleDefaults, WeeklyAvailabilityRule } from './types.js';
+import type { Interval, SlotlockAgendaEntry, SlotlockApproval, SlotlockContact, SlotlockResource, SlotlockBookingRuleDefaults, WeeklyAvailabilityRule } from './types.js';
 /** Resources one dashboard tenant may hold. */
 export declare const SLOTLOCK_DASHBOARD_MAX_RESOURCES = 500;
 /**
@@ -30,13 +33,51 @@ export interface SlotlockDashboardResources {
      */
     add(tenantRef: string, externalRef: string, timezone: string, actor?: string): Promise<SlotlockResource>;
     /**
-     * Set the bookable hours of one of the tenant's resources (`{ id }`) or of all of them; `null`
-     * hands them back to the server's and `[]` closes. Returns how many resources changed: 0 for an
-     * id that is not the tenant's.
+     * Set the bookable hours of one of the tenant's resources (`{ id }`), one of its locations
+     * (`{ location }`), or the tenant's own (`'all'`), which every resource without its own inherits
+     * (RFC 0004 B2); `null` hands them to what is above and `[]` closes. For the tenant's, `override`
+     * says what becomes of resources' own hours (SlotlockOverrideResources: `none` keeps them).
+     * Returns 0 for an id or location that is not the tenant's, else at least 1 (for the tenant's, how
+     * many resources they now apply to).
      */
     setHours(tenantRef: string, target: {
         id: string;
-    } | 'all', rules: WeeklyAvailabilityRule[] | null, actor?: string): Promise<number>;
+    } | {
+        location: string;
+    } | 'all', rules: WeeklyAvailabilityRule[] | null, actor?: string, override?: SlotlockOverrideResources): Promise<number>;
+    /** The people the tenant keeps to tell about bookings (RFC 0004 P3), and forgetting one. */
+    contacts?: {
+        list(tenantRef: string, limit: number, after?: string): Promise<SlotlockContact[]>;
+        forget(tenantRef: string, ref: string, actor?: string): Promise<{
+            deleted: boolean;
+            bookings: number;
+        }>;
+    };
+    /** The tenant's stored hours and its closures and special hours (RFC 0004 B1, B2). */
+    hours?: {
+        defaults(tenantRef: string): Promise<SlotlockAvailabilityDefaults>;
+        exceptions(tenantRef: string, limit: number): Promise<SlotlockAvailabilityException[]>;
+        addException(tenantRef: string, exception: Omit<SlotlockAvailabilityExceptionInput, 'tenantRef'>, actor?: string): Promise<SlotlockAvailabilityException>;
+        deleteException(tenantRef: string, id: string, actor?: string): Promise<boolean>;
+        /**
+         * Import a holiday calendar (its text, or a URL with `byUrl`): each all-day event closes its
+         * days for the next two years. Kept by name at its scope, so importing it again updates it and
+         * removes the holidays it dropped; `subscribe` imports a URL again every 30 days.
+         */
+        importHolidays(tenantRef: string, source: SlotlockHolidaySource, scope: {
+            location?: string;
+            resourceId?: string;
+        }, actor?: string): Promise<{
+            imported: number;
+            skipped: number;
+            removed: number;
+        }>;
+        /** Whether importHolidays reads calendars by URL. */
+        byUrl?: boolean;
+        /** The tenant's holiday calendars, and deleting one with its closures (false: not the tenant's). */
+        calendars?(tenantRef: string): Promise<SlotlockHolidayCalendar[]>;
+        deleteCalendar?(tenantRef: string, id: string, actor?: string): Promise<boolean>;
+    };
     /** What occupies the tenant's resources in `window`, by start: the overview's agenda. */
     agenda?(tenantRef: string, window: Interval, limit: number): Promise<SlotlockAgendaEntry[]>;
     /** The tenant's latest changes, newest first: the overview's activity. */
@@ -229,13 +270,38 @@ export interface SlotlockDashboardAssistantOptions {
     turnTimeoutMs?: number;
     /** Model calls one message may make (8 by default, at most 20). */
     maxSteps?: number;
-    /** How long a conversation is kept after its last message: 2 hours by default. */
+    /**
+     * How long a conversation is kept after its last message (1 second to 3,650 days). Without it, a
+     * member keeps each conversation until they delete it, up to SLOTLOCK_ASSISTANT_MAX_CHATS.
+     */
     conversationTtlMs?: number;
 }
 /**
- * Hosted Slotlock's plans (plans.ts) and their billing: a Plan page with the tenant's plan and use,
+ * Hosted Slotlock's plans (plans.ts) and their billing: a Usage page with the tenant's plan and use,
  * Upgrade (to a checkout page) and Manage (to a billing portal). Off unless set.
  */
+/**
+ * The tenant's plan and the deployment's default, read whether or not anything sells plans: with it
+ * the dashboard shows a Usage page (plan, limits and this month's use) and puts a tenant new to
+ * plans on the default before it adds what plans limit.
+ */
+export interface SlotlockDashboardPlans {
+    /** The tenant's plan (its own, or the default once it applies), or null (the server's limits apply). */
+    plan(tenantRef: string): Promise<SlotlockTenantPlan | null>;
+    /** Puts a tenant new to plans on the default plan before it adds a key, resource or webhook endpoint. */
+    enrol?(tenantRef: string): Promise<void>;
+    /** The deployment's default plan and the date it applies to every tenant, or null. */
+    planDefault?(): Promise<{
+        plan: SlotlockPlan;
+        limits: SlotlockTenantPlan['limits'];
+        appliesFrom: Date;
+    } | null>;
+    /**
+     * Where asking for another plan goes (an https or mailto URL) when nothing sells plans here: with
+     * it, the Usage page offers Developer or Team by asking.
+     */
+    contact?: string;
+}
 export interface SlotlockDashboardBilling {
     /** The tenant's plan (its own, or the default), or null when it has none (the server's limits apply). */
     plan(tenantRef: string): Promise<SlotlockTenantPlan | null>;
@@ -359,15 +425,17 @@ export interface SlotlockDashboardOptions {
     availability?: readonly WeeklyAvailabilityRule[];
     /** The chat assistant; off unless set. */
     assistant?: SlotlockDashboardAssistantOptions;
-    /** Plans and billing (hosted Slotlock); off unless set. */
+    /** Plans (hosted Slotlock): a Usage page, and enrolment on the default plan. Off unless set. */
+    plans?: SlotlockDashboardPlans;
+    /** Paying for plans through Stripe (hosted Slotlock); off unless set. Implies `plans` from its own. */
     billing?: SlotlockDashboardBilling;
     /**
-     * The deployment meters usage (SLOTLOCK_USAGE=on): the Plan page shows this month's, from the
+     * The deployment meters usage (SLOTLOCK_USAGE=on): the Usage page shows this month's, from the
      * resources adapter's `usage`.
      */
     usage?: boolean;
     /**
-     * The deployment holds tenants to their plans' monthly quotas (SLOTLOCK_QUOTAS=on): the Plan page
+     * The deployment holds tenants to their plans' monthly quotas (SLOTLOCK_QUOTAS=on): the Usage page
      * shows this month's use against them, and warns from 80%. Needs `usage`.
      */
     quotas?: boolean;
@@ -400,6 +468,11 @@ export declare function createSlotlockDashboardResources(store: SlotlockStore, o
      * through: with it, the dashboard lists approvals and decides them.
      */
     agentBackend?: SlotlockAgentCalendarBackend;
+    /**
+     * Fetches holiday calendars by URL (the guarded fetch under `serve`): with it, Closures imports
+     * and subscribes to a calendar's address.
+     */
+    holidayFetch?: typeof fetch;
 }): SlotlockDashboardResources;
 /**
  * Records accepted write confirmations (`SlotlockAgentConfirmationOptions.consumeAcceptance`) in