@songsid/agend 2.1.12-beta.9 → 2.2.0-alpha.1

package/dist/needs-you-hub.js

@@ -0,0 +1,370 @@
+/**
+ * #1386: the fleet side of "Needs you". One derivation (needs-you.ts), recomputed on change, rendered to:
+ * - each world's live message in its General and, optionally, its admins' DMs — only that world's items (§5.0, §5);
+ * - the web, globally: SSE `needs` and a `needs` field on /ui/poll (§6).
+ * Plus Acknowledge for delivery items, from a world's live message (its admins, its items) or from the web (any).
+ *
+ * The Acknowledge capabilities live in this hub's own registry, not in the fleet's prompt map: the map's walkers
+ * (per-instance clear, shutdown retire, prompt expiry) edit the message an entry points at, and the live message must
+ * only ever be edited by its own renderer. The checks are the same as every other button's: a 128-bit nonce, bound
+ * to the world, chat, thread and message that showed it, and fleet admin of that world.
+ */
+import { randomBytes } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { writeFileAtomic } from "./backend/kiro-engine-ledger.js";
+import { deriveNeedsYou, itemsForWorld, renderLiveMessage, renderSignature, messageLink, instanceLink, } from "./needs-you.js";
+import { NeedsYouLiveMessage, canonicalTarget } from "./needs-you-live.js";
+export const NEEDS_ACK_PREFIX = "needs-ack:";
+const ACK_RE = /^needs-ack:([0-9a-f]{32}):ack$/;
+const BACKSTOP_MS = 10_000;
+const ATTENTION_WINDOW_MS = 24 * 60 * 60_000;
+/** awaiting_input pings (DM, browser) only once it has lasted this long; the list itself is never delayed (§6.3). */
+export const AWAITING_PING_MIN_MS = 5_000;
+const DM_MIN_MS = 60_000;
+/** An Acknowledge button's capability lapses this long after it was minted, whether or not a renewal replaced it. */
+export const ACK_TTL_MS = 15 * 60_000;
+/** What a renderer is built for, besides its adapter: platform and group. */
+function placeKey(place) {
+    return `${place.type}|${place.groupId ?? ""}`;
+}
+export class NeedsYouHub {
+    ctx;
+    items = [];
+    webSignature = "";
+    worldSignature = new Map();
+    worldSeen = new Map();
+    /** Each world's renderer, pinned to the adapter and place it was built for (#1398 review): a replaced adapter or
+     *  moved place gets a new renderer, and the old one can no longer publish. */
+    live = new Map();
+    acks = new Map();
+    dmSeen = new Map();
+    dmLastAt = new Map();
+    /** Per world: the ids waiting to be DMed, and the one timer that will send them. */
+    dmPending = new Map();
+    dmTimer = new Map();
+    pending = null;
+    backstop = null;
+    stopped = false;
+    /** The first computation after start: what waits then is not news (a restart edits, it does not post or DM). */
+    seeded = false;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    start() {
+        this.recompute();
+        const tick = () => { this.backstop = this.ctx.setTimer(tick, BACKSTOP_MS); this.recompute(); };
+        this.backstop = this.ctx.setTimer(tick, BACKSTOP_MS);
+    }
+    /** Something that may change the list happened: recompute once, soon (coalesced). */
+    poke() {
+        if (this.stopped || this.pending !== null)
+            return;
+        this.pending = this.ctx.setTimer(() => { this.pending = null; this.recompute(); }, 0);
+    }
+    /** The current list for the web (global, §5.0). */
+    webItems() {
+        return this.items.map(({ promptAt: _promptAt, ...rest }) => rest);
+    }
+    recompute() {
+        if (this.stopped)
+            return;
+        const now = this.ctx.now();
+        let deliveries = [];
+        try {
+            deliveries = this.ctx.deliveries(new Date(now - ATTENTION_WINDOW_MS).toISOString());
+        }
+        catch (err) {
+            this.ctx.log("warn", "Needs you: could not read the delivery outbox", { err: String(err?.message ?? err) });
+        }
+        this.items = deriveNeedsYou({ prompts: this.ctx.prompts(), instances: this.ctx.instances(), deliveries, ownerOf: i => this.ctx.ownerOf(i) });
+        const webSig = renderSignature(this.items, now);
+        if (webSig !== this.webSignature) {
+            this.webSignature = webSig;
+            this.ctx.emitSse("needs", { items: this.webItems() });
+        }
+        const settings = this.ctx.settings();
+        const worlds = this.ctx.worlds();
+        const worldIds = new Set(worlds.map(w => w.id));
+        for (const [id, pinned] of this.live) {
+            const current = worlds.find(w => w.id === id);
+            if (!settings.liveMessage || !current) {
+                this.live.delete(id);
+                this.worldSignature.delete(id);
+                void pinned.renderer.disable();
+            }
+            else if (current.adapter !== pinned.adapter || placeKey(current.place) !== pinned.placeKey) {
+                // Another adapter (or place) under the same id: the old renderer stops without touching anything — its adapter
+                // may be gone — and a new one picks up from the persisted pointer.
+                this.live.delete(id);
+                this.worldSignature.delete(id);
+                pinned.renderer.abandon();
+            }
+        }
+        if (!settings.dm)
+            for (const id of [...this.dmPending.keys()])
+                this.cancelDms(id);
+        for (const id of [...this.dmPending.keys()])
+            if (!worldIds.has(id))
+                this.cancelDms(id);
+        const seeding = !this.seeded;
+        this.seeded = true;
+        for (const world of worlds) {
+            const mine = itemsForWorld(this.items, world.id);
+            if (seeding) {
+                this.worldSeen.set(world.id, new Set(mine.map(i => i.id)));
+                this.dmSeen.set(world.id, new Set(mine.map(i => i.id)));
+            }
+            const seen = this.worldSeen.get(world.id) ?? new Set();
+            const fresh = mine.filter(i => !seen.has(i.id));
+            this.worldSeen.set(world.id, new Set(mine.map(i => i.id)));
+            if (settings.liveMessage) {
+                let pinned = this.live.get(world.id);
+                if (!pinned) {
+                    pinned = { renderer: this.makeLive(world), adapter: world.adapter, placeKey: placeKey(world.place) };
+                    this.live.set(world.id, pinned);
+                }
+                const sig = renderSignature(mine, now);
+                if (sig !== this.worldSignature.get(world.id)) {
+                    this.worldSignature.set(world.id, sig);
+                    pinned.renderer.changed(fresh.length > 0);
+                }
+            }
+            if (settings.dm)
+                this.queueDms(world, mine, now);
+        }
+    }
+    // ── Live messages ──────────────────────────────────────────────────────────────────────────────────────────
+    pointerPath() { return join(this.ctx.dataDir, "needs-you-message.json"); }
+    readPointers() {
+        try {
+            const parsed = JSON.parse(readFileSync(this.pointerPath(), "utf8"));
+            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+                return {};
+            const out = {};
+            for (const [world, p] of Object.entries(parsed)) {
+                const v = p;
+                if (v && typeof v.chatId === "string" && typeof v.messageId === "string" && (v.threadId === undefined || typeof v.threadId === "string")) {
+                    out[world] = { chatId: v.chatId, messageId: v.messageId, ...(v.threadId !== undefined ? { threadId: v.threadId } : {}) };
+                }
+            }
+            return out;
+        }
+        catch {
+            return {};
+        }
+    }
+    writePointer(world, pointer) {
+        const all = this.readPointers();
+        if (pointer)
+            all[world] = pointer;
+        else
+            delete all[world];
+        try {
+            writeFileAtomic(this.pointerPath(), JSON.stringify(all, null, 2) + "\n");
+        }
+        catch (err) {
+            this.ctx.log("warn", "Needs you: could not save where the live message is", { world, err: String(err?.message ?? err) });
+        }
+    }
+    lineTitle(item) { return this.ctx.t(`needs.reason.${item.reason}`); }
+    makeLive(world) {
+        const ctx = this.ctx;
+        const owner = Symbol(world.id);
+        return new NeedsYouLiveMessage({
+            world: world.id,
+            now: () => ctx.mono(),
+            setTimer: (fn, ms) => ctx.setTimer(fn, ms),
+            clearTimer: h => ctx.clearTimer(h),
+            target: () => { const t = ctx.noticeTarget(world.id); return t ? canonicalTarget(t) : null; },
+            enabled: () => ctx.settings().liveMessage,
+            stopping: () => ctx.stopping() || this.stopped,
+            // The same world means the same adapter object and place it was built for, not just the same id.
+            worldExists: () => ctx.worlds().some(w => w.id === world.id && w.adapter === world.adapter && placeKey(w.place) === placeKey(world.place)),
+            content: () => {
+                const mine = itemsForWorld(this.items, world.id);
+                const lines = mine.map(item => ({
+                    item, title: this.lineTitle(item),
+                    link: item.promptAt ? messageLink(world.place, item.promptAt) : instanceLink(world.place, ctx.instanceTopic(item.instance)),
+                }));
+                const rendered = renderLiveMessage(lines, ctx.now(), (k, ...a) => ctx.t(k, ...a));
+                return { empty: mine.length === 0, ...rendered };
+            },
+            post: async (target, text, choices) => {
+                const sent = await world.adapter.notifyAlert(target.chatId, { type: "needs_you", instanceName: "", message: text, choices }, target.threadId ? { threadId: target.threadId } : undefined);
+                return { ...canonicalTarget(target), messageId: sent.messageId };
+            },
+            edit: async (pointer, text, choices) => {
+                if (!world.adapter.editAlert)
+                    throw new Error("adapter cannot edit an alert");
+                await world.adapter.editAlert(pointer.chatId, pointer.messageId, { type: "needs_you", instanceName: "", message: text, choices }, pointer.threadId ? { threadId: pointer.threadId } : undefined);
+            },
+            remove: async (pointer) => { await world.adapter.deleteMessage?.(pointer.chatId, pointer.messageId, pointer.threadId); },
+            loadPointer: () => this.readPointers()[world.id] ?? null,
+            savePointer: pointer => this.writePointer(world.id, pointer),
+            mintAcks: (generation, place, items) => this.mintAcks(world.id, owner, generation, place, items),
+            revokeAcks: () => this.revokeAcks(owner),
+            log: (message, extra) => ctx.log("info", `Needs you: ${message}`, extra),
+            text: { stopped: ctx.t("needs.live_stopped"), off: ctx.t("needs.live_off") },
+        });
+    }
+    mintAcks(world, owner, generation, place, items) {
+        const minted = [];
+        const choices = items.filter(i => i.deliveryId).map(item => {
+            const nonce = randomBytes(16).toString("hex");
+            const entry = {
+                world, owner, generation, deadline: this.ctx.mono() + ACK_TTL_MS, chatId: place.chatId, ...(place.threadId !== undefined ? { threadId: place.threadId } : {}),
+                ...(place.messageId ? { messageId: place.messageId } : {}), deliveryId: item.deliveryId, instance: item.instance,
+            };
+            this.acks.set(nonce, entry);
+            minted.push(entry);
+            return { id: `${NEEDS_ACK_PREFIX}${nonce}:ack`, label: this.ctx.t("needs.ack_button", item.instance) };
+        });
+        return { choices, bind: pointer => { for (const e of minted)
+                e.messageId = pointer.messageId; } };
+    }
+    revokeAcks(owner) {
+        for (const [nonce, e] of this.acks)
+            if (e.owner === owner)
+                this.acks.delete(nonce);
+    }
+    // ── Acknowledge ────────────────────────────────────────────────────────────────────────────────────────────
+    /**
+     * A click on a live message's Acknowledge. true when it was ours (handled, whatever the answer), false otherwise.
+     * Stale capabilities (an older render, a replaced message, a restart) only answer the clicker: the live message is
+     * never edited from here — that would strip the current keyboard of the same message.
+     */
+    handleCallback(data, adapterId) {
+        if (!data.callbackData.startsWith(NEEDS_ACK_PREFIX))
+            return false;
+        const m = ACK_RE.exec(data.callbackData);
+        const entry = m ? this.acks.get(m[1]) : undefined;
+        if (entry && this.ctx.mono() >= entry.deadline)
+            this.acks.delete(m[1]);
+        // Unknown, revoked, lapsed — or not yet bound to the message its post returned: no authority yet.
+        if (!m || !entry || this.ctx.mono() >= entry.deadline || entry.messageId === undefined) {
+            data.ack?.(this.ctx.t("needs.ack_stale"));
+            return true;
+        }
+        const wrongPlace = entry.world !== adapterId || entry.chatId !== data.chatId
+            || (entry.threadId !== undefined && data.threadId !== entry.threadId)
+            || data.messageId !== entry.messageId;
+        if (wrongPlace) {
+            data.ack?.(this.ctx.t("buttons.wrong_place"));
+            return true;
+        }
+        if (!data.userId || !this.ctx.isFleetAdmin(data.userId, adapterId)) {
+            data.ack?.(this.ctx.t("buttons.admin_only"));
+            return true;
+        }
+        // §5.0: the item must still belong to this world.
+        if (this.ctx.ownerOf(entry.instance) !== adapterId) {
+            data.ack?.(this.ctx.t("needs.ack_not_this_world"));
+            return true;
+        }
+        const platform = this.ctx.worlds().find(w => w.id === adapterId)?.place.type ?? "chat";
+        data.ack?.(this.ctx.t(`needs.ack_${this.acknowledge(entry.deliveryId, `${platform}:${data.userId}`)}`));
+        return true;
+    }
+    /** The web's Acknowledge: any item (the web is global, §5.0). `principal` is "web:<session handle>" or "cli". */
+    webAcknowledge(itemId, principal) {
+        const m = /^delivery:([A-Za-z0-9._:-]{1,128})$/.exec(itemId);
+        if (!m)
+            return { status: 400, message: "Not an item that can be acknowledged" };
+        const listed = this.items.some(i => i.id === itemId);
+        if (!listed)
+            return { status: 409, message: this.ctx.t("needs.ack_already") };
+        const outcome = this.acknowledge(m[1], principal);
+        return { status: outcome === "failed" ? 500 : 200, message: this.ctx.t(`needs.ack_${outcome}`) };
+    }
+    /** done: this call acknowledged it; already: acknowledged, delivered or gone meanwhile; failed: not recorded. */
+    acknowledge(deliveryId, by) {
+        let done;
+        try {
+            done = this.ctx.acknowledge(deliveryId, by);
+        }
+        catch (err) {
+            this.ctx.log("warn", "Needs you: could not record an acknowledgement", { deliveryId, err: String(err?.message ?? err) });
+            return "failed";
+        }
+        this.poke();
+        if (done)
+            this.ctx.log("info", "Needs you: delivery acknowledged", { deliveryId, by });
+        return done ? "done" : "already";
+    }
+    // ── DMs (§5.5) ─────────────────────────────────────────────────────────────────────────────────────────────
+    queueDms(world, mine, now) {
+        const seen = this.dmSeen.get(world.id) ?? new Set();
+        const due = mine.filter(i => !seen.has(i.id) && (i.type !== "awaiting_input" || now - i.since >= AWAITING_PING_MIN_MS));
+        for (const i of due)
+            seen.add(i.id);
+        // Forget ids that are gone, so a recurrence (a new id anyway) is not confused with an old one.
+        const listed = new Set(mine.map(i => i.id));
+        for (const id of [...seen])
+            if (!listed.has(id))
+                seen.delete(id);
+        this.dmSeen.set(world.id, seen);
+        if (due.length === 0)
+            return;
+        const pending = this.dmPending.get(world.id) ?? new Set();
+        for (const i of due)
+            pending.add(i.id);
+        this.dmPending.set(world.id, pending);
+        this.scheduleDms(world.id);
+    }
+    /** One timer per world; it sends at once when the minute since the last DM has passed. */
+    scheduleDms(worldId) {
+        if (this.dmTimer.has(worldId))
+            return;
+        const last = this.dmLastAt.get(worldId) ?? -Infinity;
+        const wait = Math.max(0, last + DM_MIN_MS - this.ctx.mono());
+        this.dmTimer.set(worldId, this.ctx.setTimer(() => { this.dmTimer.delete(worldId); this.flushDms(worldId); }, wait));
+    }
+    cancelDms(worldId) {
+        const timer = this.dmTimer.get(worldId);
+        if (timer !== undefined)
+            this.ctx.clearTimer(timer);
+        this.dmTimer.delete(worldId);
+        this.dmPending.delete(worldId);
+    }
+    /**
+     * Send what is pending — re-resolved now (#1398 review): only items still listed AND still owned by this world, to
+     * this world's admins as they are now, through its current adapter; nothing at all once DMs are off, the world is
+     * gone, or the hub is stopped.
+     */
+    flushDms(worldId) {
+        const ids = this.dmPending.get(worldId) ?? new Set();
+        this.dmPending.delete(worldId);
+        if (this.stopped || ids.size === 0 || !this.ctx.settings().dm || this.ctx.stopping())
+            return;
+        const world = this.ctx.worlds().find(w => w.id === worldId);
+        if (!world || !world.adapter.sendDirect)
+            return;
+        // Owned by this world NOW — asked of the fleet per item, not taken from the last derivation (#1398 review r2).
+        const still = this.items.filter(i => ids.has(i.id) && this.ctx.ownerOf(i.instance) === worldId);
+        if (still.length === 0)
+            return;
+        this.dmLastAt.set(worldId, this.ctx.mono());
+        const text = [this.ctx.t("needs.dm_header", still.length), ...still.slice(0, 10).map(item => {
+                const link = item.promptAt ? messageLink(world.place, item.promptAt) : instanceLink(world.place, this.ctx.instanceTopic(item.instance));
+                return `• ${item.instance} — ${this.lineTitle(item)}${link ? ` · ${link}` : ""}`;
+            })].join("\n");
+        for (const admin of this.ctx.fleetAdmins(worldId)) {
+            // Telegram: only an admin who has started the bot can be messaged; the send fails otherwise, and that is fine.
+            world.adapter.sendDirect(admin, text).catch(err => this.ctx.log("debug", "Needs you: DM not delivered", { world: worldId, err: String(err?.message ?? err) }));
+        }
+    }
+    /** Shutdown: every live message says so, without buttons; no further renders or DMs. */
+    async stop() {
+        this.stopped = true;
+        if (this.pending !== null)
+            this.ctx.clearTimer(this.pending);
+        if (this.backstop !== null)
+            this.ctx.clearTimer(this.backstop);
+        for (const id of [...this.dmPending.keys(), ...this.dmTimer.keys()])
+            this.cancelDms(id);
+        await Promise.all([...this.live.values()].map(p => p.renderer.retire()));
+        this.acks.clear();
+    }
+}
+//# sourceMappingURL=needs-you-hub.js.map

package/dist/needs-you-hub.js.map

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

package/dist/needs-you-live.d.ts

@@ -0,0 +1,116 @@
+/**
+ * #1386 §5.1–5.4: one world's live "Needs you" message in its General — kept current, without flooding, and never
+ * left holding a capability it should not.
+ *
+ * - **Generations (§5.2a).** Every render is a generation. Its Acknowledge capabilities are minted for it, and the
+ *   previous generation's are revoked *before the render's first await* — an old button is stale from that moment,
+ *   whether or not the edit lands. Expiry never edits the message: the message is renewed at least every
+ *   RENEW_MS.
+ * - **Single flight with fences (§5.3a).** One render at a time; a change meanwhile schedules exactly one more. After
+ *   every await (post/edit/delete ACK) the render continues only if its generation is current, the feature is on,
+ *   the world exists, the target is the one it started with, and the fleet is not stopping. Otherwise nothing is
+ *   persisted, its capabilities are revoked, and a late post is deleted.
+ * - **Edit vs new post (§5.3).** Changes edit in place (debounced, at most one edit per EDIT_MIN_MS). A new item
+ *   replaces the message with a new post — at the bottom, so people are notified — at most once per POST_MIN_MS;
+ *   one inside that window is shown by an edit and posted when the window opens.
+ * - **The pointer (§5.4).** Reused only at the same canonical place; a moved target never receives this world's list
+ *   at its former destination (the old message is deleted best effort, without new content).
+ *
+ * Every effect is injected; times come from a monotonic clock.
+ */
+import type { NeedsYouItem } from "./needs-you.js";
+export interface LiveTarget {
+    chatId: string;
+    threadId?: string;
+}
+export interface LivePointer extends LiveTarget {
+    messageId: string;
+}
+export interface LiveChoice {
+    id: string;
+    label: string;
+}
+export interface LiveContent {
+    /** Nothing waits on this world: no message is posted for it if none exists yet. */
+    empty: boolean;
+    text: string;
+    /** Delivery items that get an Acknowledge button on this render. */
+    ackable: NeedsYouItem[];
+}
+/** Capabilities minted for one render; `bind` fixes the message id once a post returns it. */
+export interface LiveAcks {
+    choices: LiveChoice[];
+    bind(pointer: LivePointer): void;
+}
+export interface LiveDeps {
+    world: string;
+    now(): number;
+    setTimer(fn: () => void, ms: number): unknown;
+    clearTimer(handle: unknown): void;
+    /** The current canonical General target, or null when this world has none. */
+    target(): LiveTarget | null;
+    enabled(): boolean;
+    stopping(): boolean;
+    worldExists(): boolean;
+    /** This world's current content. */
+    content(): LiveContent;
+    post(target: LiveTarget, text: string, choices: LiveChoice[]): Promise<LivePointer>;
+    edit(pointer: LivePointer, text: string, choices: LiveChoice[]): Promise<void>;
+    remove(pointer: LivePointer): Promise<void>;
+    loadPointer(): LivePointer | null;
+    savePointer(pointer: LivePointer | null): void;
+    /** Mint Acknowledge capabilities for `generation`, bound to `place` (the message id may follow via bind). */
+    mintAcks(generation: number, place: LiveTarget & {
+        messageId?: string;
+    }, items: NeedsYouItem[]): LiveAcks;
+    /** Revoke every Acknowledge capability this world holds (all generations). */
+    revokeAcks(): void;
+    log(message: string, extra?: Record<string, unknown>): void;
+    text: {
+        stopped: string;
+        off: string;
+    };
+}
+export declare const DEBOUNCE_MS = 3000;
+export declare const EDIT_MIN_MS = 10000;
+export declare const POST_MIN_MS = 60000;
+export declare const RENEW_MS: number;
+/** A failed post backs off from POST_MIN_MS, doubling, up to this (#1398 review: never a tight retry loop). */
+export declare const POST_BACKOFF_MAX_MS: number;
+/** Telegram General is topic "1" on input and no thread on the wire: both are the same place. */
+export declare function canonicalTarget(target: LiveTarget): LiveTarget;
+export declare function samePlace(a: LiveTarget, b: LiveTarget): boolean;
+export declare class NeedsYouLiveMessage {
+    private readonly deps;
+    private generation;
+    private pointer;
+    private inFlight;
+    private rerun;
+    private timer;
+    private dueAt;
+    private lastEditAt;
+    /** No post (of any kind: first, moved, new item, edit fallback) before this monotonic time. */
+    private nextPostAt;
+    private postFailures;
+    private postWanted;
+    private retired;
+    constructor(deps: LiveDeps);
+    /** The list changed. `newIds`: an item appeared that this world has not shown before (→ a new post, rate-limited). */
+    changed(newIds: boolean): void;
+    /** Current generation (tests and the ack handler's generation check). */
+    get currentGeneration(): number;
+    get currentPointer(): LivePointer | null;
+    private requestAt;
+    private scheduleRenewal;
+    /** One render. Public for tests; normal use goes through changed(). */
+    render(): Promise<void>;
+    private fenced;
+    private renderOnce;
+    private postNew;
+    /** Shutdown: revoke first, then say so on the message, without buttons. No further renders. */
+    retire(): Promise<void>;
+    /** Replaced by another renderer (a new adapter under this world's id): stop and revoke, touching nothing remote. */
+    abandon(): void;
+    /** live_message turned off (or the world removed): revoke, mark the message, forget it. */
+    disable(): Promise<void>;
+}