@songsid/agend 2.3.0-beta.8 → 2.3.0

package/dist/task-board-summary.d.ts

@@ -0,0 +1,101 @@
+import type { Card, Project, ProjectStats } from "./scheduler/task-board.js";
+/** Cards listed per section; the rest are counted. */
+export declare const SUMMARY_LISTED = 10;
+/**
+ * `defaults.task_board.summary_at`: `"HH:MM"` (24 h) → itself, `"off"` (any case) or not set → null (off); anything
+ * else → undefined (the validator refuses it; the clock then sends nothing). Off unless set (2.3.0-beta.25, the
+ * user's call after beta.24's task-board flood, #2425): a fleet that wants the summary names its time.
+ */
+export declare function summaryTime(value: unknown): string | null | undefined;
+/** The wall clock at `now` in `zone` ("YYYY-MM-DD", "HH:MM"); a zone the runtime does not know reads as UTC. */
+export declare function wallClock(now: Date, zone: string): {
+    date: string;
+    time: string;
+};
+/** When the last summary went out: its local date and the end of the time it covered. */
+export interface SummaryMark {
+    date: string;
+    until: string;
+}
+/** The mark on disk (`<dataDir>/task-board-summary.json`); a missing or unreadable file is no mark. */
+export declare function summaryMarkFile(path: string): {
+    read(): SummaryMark | null;
+    write(mark: SummaryMark): void;
+};
+export interface SummaryClockDeps {
+    /** `defaults.task_board.summary_at` as it is now ("HH:MM"), or null when off. Read at every look. */
+    at(): string | null;
+    zone(): string;
+    now(): Date;
+    mark: {
+        read(): SummaryMark | null;
+        write(mark: SummaryMark): void;
+    };
+    /** Gather and post the summary of [since, until). */
+    send(since: Date, until: Date): void;
+    /** A look that threw (the data directory gone, a board that cannot be read): logged, and the next look tries again. */
+    failed?(err: unknown): void;
+    setInterval?(fn: () => void, ms: number): unknown;
+    clearInterval?(handle: unknown): void;
+}
+export declare class TaskBoardSummaryClock {
+    private readonly deps;
+    private timer;
+    private first;
+    constructor(deps: SummaryClockDeps);
+    /** A look 5 s after start (a summary missed while the fleet was down), then every minute. */
+    start(): void;
+    stop(): void;
+    /** One look: true when a summary was due today and is now handled (sent, or quiet). */
+    tick(): boolean;
+}
+export interface ProjectLine {
+    name: string;
+    percent: number;
+    done: number;
+    total: number;
+    waiting: number;
+    blocked: number;
+}
+export interface BoardSummary {
+    since: Date;
+    until: Date;
+    review: Card[];
+    blocked: Card[];
+    done: Card[];
+    created: Card[];
+    projects: ProjectLine[];
+}
+export interface SummaryRead {
+    /** What waits for the person now (TaskBoard.waitingForPerson): review cards that need them, blocked cards they handed out. */
+    waiting: Card[];
+    done: Card[];
+    created: Card[];
+    /** Every live main task's project and assignee: a project's line goes to the chats whose instances hold one. */
+    mains: Array<{
+        projectId: number | null;
+        assignee: string | null;
+    }>;
+}
+/**
+ * One chat's summary: the cards `inChat` keeps (by assignee), and the active projects one of its cards' main tasks is
+ * in, with the project's numbers over all its cards (projectStats).
+ */
+export declare function buildSummary(read: SummaryRead, since: Date, until: Date, opts: {
+    inChat(assignee: string | null): boolean;
+    projects: Project[];
+    stats: Record<string, ProjectStats>;
+}): BoardSummary;
+/** Nothing waits and nothing moved: no summary that day. */
+export declare function isQuiet(s: BoardSummary): boolean;
+type T = (key: string, ...args: (string | number)[]) => string;
+/**
+ * The summary as plain text in the fleet's language (no markup: Telegram, Discord and the web chat read it the same).
+ * `projectOf`: a main task's project name.
+ */
+export declare function renderSummary(s: BoardSummary, opts: {
+    zone: string;
+    t: T;
+    projectOf(card: Card): string | null;
+}): string;
+export {};

package/dist/task-board-summary.js

@@ -0,0 +1,177 @@
+/**
+ * #2246 step 3: the task board's daily summary for the person, as taskhall sends it. Once a day at
+ * `defaults.task_board.summary_at` (the fleet's zone): what waits for their confirmation and what is blocked now, what
+ * got done and what was opened since the last summary, and each project's progress. Each chat world's General gets the
+ * cards of its own instances (a card nobody in a world holds goes to the primary one); the web chat's Generals too.
+ *
+ * The clock is taskhall's: it looks every minute, sends at most once a calendar day, and a summary missed while the
+ * fleet was down goes out when it is back that day, covering the time since the last one (at most a week). A quiet day
+ * (nothing waits, nothing moved) sends nothing. The first summary after this ships waits for the next morning.
+ */
+import { atomicWriteFileSync } from "./atomic-write.js";
+import { readFileSync } from "node:fs";
+/** Cards listed per section; the rest are counted. */
+export const SUMMARY_LISTED = 10;
+const WEEK_MS = 7 * 86_400_000;
+/**
+ * `defaults.task_board.summary_at`: `"HH:MM"` (24 h) → itself, `"off"` (any case) or not set → null (off); anything
+ * else → undefined (the validator refuses it; the clock then sends nothing). Off unless set (2.3.0-beta.25, the
+ * user's call after beta.24's task-board flood, #2425): a fleet that wants the summary names its time.
+ */
+export function summaryTime(value) {
+    if (value === undefined || value === null)
+        return null;
+    if (typeof value !== "string")
+        return undefined;
+    const v = value.trim().toLowerCase();
+    if (v === "off")
+        return null;
+    return /^([01]\d|2[0-3]):[0-5]\d$/.test(v) ? v : undefined;
+}
+/** The wall clock at `now` in `zone` ("YYYY-MM-DD", "HH:MM"); a zone the runtime does not know reads as UTC. */
+export function wallClock(now, zone) {
+    let wall;
+    try {
+        wall = now.toLocaleString("sv-SE", { timeZone: zone, hour12: false });
+    }
+    catch {
+        wall = now.toLocaleString("sv-SE", { timeZone: "UTC", hour12: false });
+    }
+    return { date: wall.slice(0, 10), time: wall.slice(11, 16) };
+}
+/** The mark on disk (`<dataDir>/task-board-summary.json`); a missing or unreadable file is no mark. */
+export function summaryMarkFile(path) {
+    return {
+        read() {
+            try {
+                const m = JSON.parse(readFileSync(path, "utf8"));
+                return typeof m.date === "string" && typeof m.until === "string" ? { date: m.date, until: m.until } : null;
+            }
+            catch {
+                return null;
+            }
+        },
+        write(mark) { atomicWriteFileSync(path, JSON.stringify(mark) + "\n"); },
+    };
+}
+export class TaskBoardSummaryClock {
+    deps;
+    timer = null;
+    first = null;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** A look 5 s after start (a summary missed while the fleet was down), then every minute. */
+    start() {
+        if (this.timer)
+            return;
+        const every = this.deps.setInterval ?? ((fn, ms) => { const h = setInterval(fn, ms); h.unref?.(); return h; });
+        const look = () => { try {
+            this.tick();
+        }
+        catch (err) {
+            this.deps.failed?.(err);
+        } };
+        this.timer = every(look, 60_000);
+        this.first = setTimeout(look, 5_000);
+        this.first.unref?.();
+    }
+    stop() {
+        if (this.timer)
+            (this.deps.clearInterval ?? ((h) => clearInterval(h)))(this.timer);
+        if (this.first)
+            clearTimeout(this.first);
+        this.timer = null;
+        this.first = null;
+    }
+    /** One look: true when a summary was due today and is now handled (sent, or quiet). */
+    tick() {
+        const at = this.deps.at();
+        if (!at)
+            return false;
+        const now = this.deps.now();
+        const wall = wallClock(now, this.deps.zone());
+        if (wall.time < at)
+            return false;
+        const last = this.deps.mark.read();
+        if (last?.date === wall.date)
+            return false;
+        // Marked before it is sent: a send that throws does not repeat every minute.
+        this.deps.mark.write({ date: wall.date, until: now.toISOString() });
+        if (!last)
+            return false; // the first day: nothing to look back on yet; the next one covers from now
+        const since = Math.min(Math.max(Date.parse(last.until) || 0, now.getTime() - WEEK_MS), now.getTime());
+        this.deps.send(new Date(since), now);
+        return true;
+    }
+}
+/** Main tasks first, then by number. */
+const byNumber = (a, b) => (a.kind === b.kind ? 0 : a.kind === "main" ? -1 : 1) || Number(a.code.slice(2)) - Number(b.code.slice(2));
+/**
+ * One chat's summary: the cards `inChat` keeps (by assignee), and the active projects one of its cards' main tasks is
+ * in, with the project's numbers over all its cards (projectStats).
+ */
+export function buildSummary(read, since, until, opts) {
+    const mine = (cards) => cards.filter((c) => opts.inChat(c.assignee)).sort(byNumber);
+    const here = new Set(read.mains.filter((m) => m.projectId !== null && opts.inChat(m.assignee)).map((m) => m.projectId));
+    return {
+        since, until,
+        review: mine(read.waiting.filter((c) => c.status === "review")),
+        blocked: mine(read.waiting.filter((c) => c.status === "blocked")),
+        done: mine(read.done),
+        created: mine(read.created),
+        projects: opts.projects.filter((p) => !p.archived && here.has(p.id)).flatMap((p) => {
+            const st = opts.stats[String(p.id)];
+            return st && st.mains ? [{ name: p.name, percent: st.percent, done: st.units.done, total: st.units.total, waiting: st.waiting, blocked: st.blocked }] : [];
+        }),
+    };
+}
+/** Nothing waits and nothing moved: no summary that day. */
+export function isQuiet(s) {
+    return !s.review.length && !s.blocked.length && !s.done.length && !s.created.length;
+}
+const short = (s, n) => (Array.from(s).length > n ? Array.from(s).slice(0, n - 1).join("") + "…" : s);
+/** `M/D HH:MM` in the fleet's zone. */
+function shortTime(d, zone) {
+    const { date, time } = wallClock(d, zone);
+    return `${Number(date.slice(5, 7))}/${Number(date.slice(8, 10))} ${time}`;
+}
+/**
+ * The summary as plain text in the fleet's language (no markup: Telegram, Discord and the web chat read it the same).
+ * `projectOf`: a main task's project name.
+ */
+export function renderSummary(s, opts) {
+    const { t } = opts;
+    const ref = (c) => t("board_summary.card", c.code, short(c.title, 30))
+        + (c.kind === "main" ? (opts.projectOf(c) ? ` · ${opts.projectOf(c)}` : "") : c.assignee ? ` @${c.assignee}` : "");
+    const list = (cards, line) => {
+        const out = cards.slice(0, SUMMARY_LISTED).map((c) => `• ${line(c)}`);
+        if (cards.length > SUMMARY_LISTED)
+            out.push(`• ${t("board_summary.more", cards.length - SUMMARY_LISTED)}`);
+        return out;
+    };
+    // Finished and new: a main task a line each, sub tasks folded into one line of numbers.
+    const folded = (cards) => {
+        const mains = cards.filter((c) => c.kind === "main"), subs = cards.filter((c) => c.kind === "sub");
+        const out = list(mains, ref);
+        if (subs.length) {
+            const codes = subs.slice(0, SUMMARY_LISTED).map((c) => c.code).join(t("board_summary.join"));
+            out.push(`• ${t(subs.length > SUMMARY_LISTED ? "board_summary.subs_more" : "board_summary.subs", subs.length, codes)}`);
+        }
+        return out;
+    };
+    const blocks = [t("board_summary.title", shortTime(s.since, opts.zone), shortTime(s.until, opts.zone))];
+    const section = (title, lines) => { if (lines.length)
+        blocks.push([title, ...lines].join("\n")); };
+    section(t("board_summary.review", s.review.length), list(s.review, ref));
+    section(t("board_summary.blocked", s.blocked.length), list(s.blocked, (c) => ref(c) + (c.kind === "main" && c.assignee ? ` @${c.assignee}` : "") + (c.blockedReason ? t("board_summary.reason", short(c.blockedReason, 60)) : "")));
+    section(t("board_summary.done", s.done.length), folded(s.done));
+    section(t("board_summary.created", s.created.length), folded(s.created));
+    section(t("board_summary.projects"), s.projects.map((p) => {
+        const extra = [p.waiting ? t("board_summary.project_waiting", p.waiting) : "", p.blocked ? t("board_summary.project_blocked", p.blocked) : ""].filter(Boolean);
+        return `• ${t("board_summary.project", p.name, p.percent, p.done, p.total)}${extra.length ? t("board_summary.project_extra", extra.join(t("board_summary.join"))) : ""}`;
+    }));
+    blocks.push(t("board_summary.footer"));
+    return blocks.join("\n\n");
+}
+//# sourceMappingURL=task-board-summary.js.map

package/dist/task-board-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-board-summary.js","sourceRoot":"","sources":["../src/task-board-summary.ts"],"names":[],"mappings":"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"}

package/dist/task-board-tool.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The `task` tool's board actions (step 2, docs/design/task-board.md), for both of the tool's doors — the MCP tool
+ * over IPC (FleetManager.handleTaskCrud) and `agend-agent task` over HTTP (handleTaskCrudHttp):
+ *
+ * - `mine` — the caller's work; `projects` — the board's projects;
+ * - `move` — a card to another status, with the reason, result or comment the move needs;
+ * - `create` or `update` naming a board field (a project, a parent, a checklist, state, a log line, a comment…);
+ * - `get` of a card on the board — the card as text, with the comments new to its assignee.
+ *
+ * Everything else is the tool's own and is answered as before (undefined here). The caller is the instance the tool
+ * belongs to; the board's rules (scheduler/task-board.ts) decide what it may do. Answers are plain text.
+ */
+import type { SchedulerDb } from "./scheduler/db.js";
+export declare function boardToolAction(db: SchedulerDb, instance: string, args: Record<string, unknown>): string | undefined;
+/** The activity log's line for a board action that changed work (as `created task:` / `claimed:` / `completed:` for plain tasks). */
+export declare function boardActivity(args: Record<string, unknown>): string | null;
+/**
+ * #2303: how many handed-out board cards an instance may have in progress at once — its `board_cards_at_once`, else
+ * 1 (the validator holds it to a whole number of at least 1; anything else here counts as 1).
+ */
+export declare function boardCardLimit(fleet: {
+    instances?: Record<string, {
+        board_cards_at_once?: unknown;
+    } | undefined>;
+} | null | undefined, name: string): number;

package/dist/task-board-tool.js

@@ -0,0 +1,155 @@
+import { CARD_PRIORITIES, CARD_SIZES, CARD_STATUSES, TaskBoardError } from "./scheduler/task-board.js";
+import { cardLine, cardText, myWorkText, projectsText, writeText } from "./scheduler/task-board-text.js";
+/** A `create` naming one of these opens a board card; without them it is the tool's plain task. */
+const BOARD_CREATE = ["project", "parent", "scope", "acceptance", "context", "needs_review", "size", "dispatcher"];
+/** An `update` naming one of these edits the card on the board's terms; without them it is the tool's plain update. */
+const BOARD_UPDATE = ["title", "description", "scope", "context", "state", "acceptance", "check", "uncheck", "log", "comment", "needs_review", "size", "depends_on", "version", "dispatcher"];
+/** Words agents bring from other boards. */
+const STATUS_ALIAS = { todo: "open", "to do": "open", doing: "claimed", in_progress: "claimed", "in progress": "claimed", waiting: "review" };
+const str = (v) => (typeof v === "string" ? v : undefined);
+const strs = (v) => (Array.isArray(v) && v.every((x) => typeof x === "string") ? v : undefined);
+const nums = (v) => (Array.isArray(v) && v.every((x) => typeof x === "number") ? v : undefined);
+const int = (v) => (typeof v === "number" && Number.isInteger(v) ? v : undefined);
+const bool = (v) => (typeof v === "boolean" ? v : undefined);
+// A dispatcher of null is a value (nobody), not an absent field.
+const has = (args, keys) => keys.some((k) => args[k] !== undefined && (args[k] !== null || k === "dispatcher"));
+function status(v, param = "to") {
+    const s = typeof v === "string" ? v.trim().toLowerCase() : "";
+    const known = CARD_STATUSES.includes(s) ? s : STATUS_ALIAS[s];
+    if (!known)
+        throw new TaskBoardError("invalid", `"${param}" is one of ${CARD_STATUSES.join(", ")}`);
+    return known;
+}
+const priority = (v) => (CARD_PRIORITIES.includes(v) ? v : undefined);
+/** An instance's name; null, "" or "none": nobody. */
+const dispatcher = (v) => {
+    if (v === undefined)
+        return undefined;
+    const name = typeof v === "string" ? v.trim() : "";
+    return !name || name.toLowerCase() === "none" ? null : { kind: "instance", name };
+};
+const size = (v) => (v === null || v === "" ? null : CARD_SIZES.includes(v) ? v : undefined);
+function need(v, what) {
+    const s = str(v)?.trim();
+    if (!s)
+        throw new TaskBoardError("invalid", `${what} is required`);
+    return s;
+}
+export function boardToolAction(db, instance, args) {
+    const board = db.board;
+    const actor = { kind: "instance", name: instance };
+    switch (args.action) {
+        case "mine":
+            return myWorkText(board, instance, board.myWork(instance));
+        case "projects":
+            return projectsText(board.listProjects(true), board.projectStats());
+        case "move": {
+            const id = need(args.id, "id");
+            let to = status(args.to ?? args.status);
+            // As the tool's `done`: finishing a card that waits for someone's confirmation hands it to them (review) — unless
+            // the caller is the one who confirms it (#2434: an agent's card, by its dispatcher; nobody's, by its assignee).
+            if (to === "done") {
+                const held = board.findCard(id);
+                if (held?.needsReview && held.status !== "review" && !board.confirms(held, actor))
+                    to = "review";
+            }
+            const { card, from, notes } = board.moveCard(actor, id, to, {
+                reason: str(args.reason), result: str(args.result), comment: str(args.comment), version: int(args.version),
+            });
+            return writeText(card, notes, from);
+        }
+        case "create": {
+            if (!has(args, BOARD_CREATE))
+                return undefined;
+            const spec = {
+                title: need(args.title, "title"),
+                goal: str(args.description),
+                scope: str(args.scope),
+                context: str(args.context),
+                acceptance: strs(args.acceptance),
+                priority: priority(args.priority),
+                size: size(args.size) ?? undefined,
+                dependsOn: strs(args.depends_on),
+                needsReview: bool(args.needs_review),
+                dispatcher: dispatcher(args.dispatcher),
+                ...(str(args.parent) ? { parent: str(args.parent) } : { project: str(args.project) ?? (typeof args.project === "number" ? args.project : undefined) }),
+                ...(args.assignee !== undefined ? { assignee: str(args.assignee) ?? null } : {}),
+            };
+            const { cards, notes } = board.createCards(actor, { cards: [spec] });
+            return writeText(cards[0], notes);
+        }
+        case "update": {
+            if (!has(args, BOARD_UPDATE))
+                return undefined;
+            const patch = {
+                version: int(args.version),
+                title: str(args.title),
+                goal: str(args.description),
+                scope: str(args.scope),
+                context: str(args.context),
+                state: str(args.state),
+                result: str(args.result),
+                acceptance: strs(args.acceptance),
+                check: nums(args.check),
+                uncheck: nums(args.uncheck),
+                log: str(args.log),
+                comment: str(args.comment),
+                needsReview: bool(args.needs_review),
+                dispatcher: dispatcher(args.dispatcher),
+                size: size(args.size),
+                priority: priority(args.priority),
+                dependsOn: strs(args.depends_on),
+                ...(args.assignee !== undefined ? { assignee: str(args.assignee) ?? null } : {}),
+            };
+            if (args.status === undefined) {
+                const { card, notes } = board.updateCard(actor, need(args.id, "id"), patch);
+                return writeText(card, notes);
+            }
+            // A status given with the fields: the fields, then the move as the tool's plain update makes it (the board's
+            // rules, the gate) — one write, so a refused move keeps the fields unchanged too.
+            const to = status(args.status, "status");
+            const { card, from } = board.atomically(() => {
+                const { card: edited } = board.updateCard(actor, need(args.id, "id"), patch);
+                if (to !== edited.status)
+                    db.updateTask(edited.uuid, { status: to }, actor);
+                return { card: board.getCard(edited.uuid), from: edited.status };
+            });
+            return writeText(card, board.takeNotes(), from);
+        }
+        case "list": {
+            if (!has(args, ["project", "parent"]))
+                return undefined;
+            const filterStatus = args.filter_status === undefined ? undefined : (Array.isArray(args.filter_status) ? args.filter_status : [args.filter_status]).map((v) => status(v, "filter_status"));
+            const project = args.project === "" || args.project === "none" ? null : (str(args.project) ?? (typeof args.project === "number" ? args.project : undefined));
+            const { cards, total } = board.listCards({ project, parent: str(args.parent), assignee: str(args.filter_assignee) || undefined, status: filterStatus });
+            if (!cards.length)
+                return "No cards match.";
+            return [...cards.map((c) => cardLine(c)), ...(total > cards.length ? [`… ${total - cards.length} more: narrow with filter_status or filter_assignee`] : [])].join("\n");
+        }
+        case "get": {
+            const card = board.findCard(need(args.id, "id"));
+            return card && board.isOnBoard(card) ? cardText(board, card) : undefined;
+        }
+        default:
+            return undefined;
+    }
+}
+/** The activity log's line for a board action that changed work (as `created task:` / `claimed:` / `completed:` for plain tasks). */
+export function boardActivity(args) {
+    const id = typeof args.id === "string" ? args.id : "";
+    if (args.action === "create" && has(args, BOARD_CREATE) && typeof args.title === "string")
+        return `created task: ${args.title}`;
+    if (args.action !== "move")
+        return null;
+    const to = typeof args.to === "string" ? args.to : typeof args.status === "string" ? args.status : "";
+    return { claimed: `claimed: ${id}`, done: `completed: ${id}`, review: `submitted for review: ${id}`, blocked: `blocked: ${id}`, cancelled: `cancelled: ${id}`, open: `put back: ${id}` }[STATUS_ALIAS[to] ?? to] ?? null;
+}
+/**
+ * #2303: how many handed-out board cards an instance may have in progress at once — its `board_cards_at_once`, else
+ * 1 (the validator holds it to a whole number of at least 1; anything else here counts as 1).
+ */
+export function boardCardLimit(fleet, name) {
+    const own = fleet?.instances && Object.prototype.hasOwnProperty.call(fleet.instances, name) ? fleet.instances[name]?.board_cards_at_once : undefined;
+    return typeof own === "number" && Number.isInteger(own) && own >= 1 ? own : 1;
+}
+//# sourceMappingURL=task-board-tool.js.map

package/dist/task-board-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-board-tool.js","sourceRoot":"","sources":["../src/task-board-tool.ts"],"names":[],"mappings":"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"}

package/dist/task-board-waker.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Waking an instance when someone else changes a card it owns or handed out (step 2, docs/design/task-board.md). The
+ * board decides who hears what (TaskBoard's settleWakes); this gathers an instance's news for `gatherMs` (10 s) into
+ * one message — dragging five cards, or opening a whole plan, is one wake — checks again that each piece still stands
+ * when it goes out (wakeHolds), and hands it to the fleet as a notice from AgEnD: the delivery outbox holds it until
+ * the instance can take it, across a restart too. What is gathered but not yet handed over is lost on a stop; the card
+ * keeps the news (`task mine`, the comments new to its assignee).
+ */
+import type { Wake } from "./scheduler/task-board.js";
+import { type Card } from "./scheduler/task-board.js";
+export interface TaskBoardWakerDeps {
+    /** Hand `message` to the instance for good (the fleet's durable delivery); false when it could not be taken. */
+    deliver(instance: string, message: string, key: string): boolean;
+    /** Whether the board may wake this name: a fleet instance (an assignee can be any name). */
+    isInstance(name: string): boolean;
+    /** What of a wake still stands now (TaskBoard.wakeHolds), and the card, to say what it lacks. */
+    holds(wake: Wake): Wake | null;
+    card(uuid: string): Card | undefined;
+    /**
+     * #2352: whether the person has this card's Needs you buttons in `instance`'s own channel (it is the card's lane):
+     * then a dispatcher's wake says so instead of asking it to tell the person.
+     */
+    buttonsHere?(instance: string, uuid: string): boolean;
+    log(level: "info" | "warn", message: string, extra?: Record<string, unknown>): void;
+    gatherMs?: number;
+    timers?: {
+        set(fn: () => void, ms: number): unknown;
+        clear(handle: unknown): void;
+    };
+    now?: () => number;
+}
+/**
+ * One message for an instance's gathered news: a line per card (a main task assigned with its sub tasks is one line),
+ * or — a whole plan assigned at once — a count, so it does not read as everything to do right now.
+ */
+export declare function wakeMessage(wakes: Wake[], card?: (uuid: string) => Card | undefined, 
+/** #2352: the person has this wake's card's buttons in the woken instance's channel. */
+buttonsHere?: (w: Wake) => boolean): string;
+export declare class TaskBoardWaker {
+    private readonly deps;
+    private readonly gathering;
+    private stopped;
+    private seq;
+    private readonly timers;
+    constructor(deps: TaskBoardWakerDeps);
+    /** A committed write's wakes: gathered per instance, a card's news merged (each reason keeps its own words). */
+    note(wakes: readonly Wake[]): void;
+    /** Nothing more is sent (the fleet is stopping); news still gathering is dropped — the cards keep it. */
+    stop(): void;
+    private flush;
+}