charness 0.0.0-stage → 3.0.0

package/dist/utils/rotatingJsonlFile.js.map

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

package/dist/utils/rotatingLogFile.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @description Shared retention window for the time-bucketed log files (the
+ * output trace and the bot-console tee). Both prune buckets older than this.
+ */
+export declare const retentionHours = 6;
+/** Retention window in milliseconds, derived from {@link retentionHours}. */
+export declare const retentionMs: number;
+/**
+ * @description Path of the hourly bucket file a write at `nowMs` belongs to:
+ * `<dir>/<base>-YYYYMMDDHH.<ext>`, using the HOST-LOCAL clock (so the operator
+ * reading the file sees buckets aligned to their own wall time). Pure — does no
+ * IO, just composes the name.
+ */
+export declare function getHourBucketPath(dir: string, base: string, ext: string, nowMs: number): string;
+/**
+ * @description Delete every bucket file for `<base>.<ext>` (including its `.1`
+ * rollover) whose mtime is older than the retention window. Time-bucketing means
+ * we only ever unlink WHOLE buckets the writer is no longer appending to — no
+ * race with the live writer (it only ever touches the current bucket). Pruning
+ * is best-effort: a missing dir, an unreadable entry, or a failed `unlink` is
+ * swallowed per-file so one bad entry can never abort the sweep or throw into
+ * the boot/interval path.
+ */
+export declare function pruneExpiredBuckets(dir: string, base: string, ext: string, retentionWindowMs: number, nowMs: number): Promise<void>;
+//# sourceMappingURL=rotatingLogFile.d.ts.map

package/dist/utils/rotatingLogFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotatingLogFile.d.ts","sourceRoot":"","sources":["../../src/utils/rotatingLogFile.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,cAAc,IAAI,CAAC;AAIhC,6EAA6E;AAC7E,eAAO,MAAM,WAAW,QAAuC,CAAC;AAMhE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ/F;AAQD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/utils/rotatingLogFile.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retentionMs = exports.retentionHours = void 0;
+exports.getHourBucketPath = getHourBucketPath;
+exports.pruneExpiredBuckets = pruneExpiredBuckets;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * @description Shared retention window for the time-bucketed log files (the
+ * output trace and the bot-console tee). Both prune buckets older than this.
+ */
+exports.retentionHours = 6;
+const millisecondsPerHour = 60 * 60 * 1000;
+/** Retention window in milliseconds, derived from {@link retentionHours}. */
+exports.retentionMs = exports.retentionHours * millisecondsPerHour;
+function padTwo(value) {
+    return value.toString().padStart(2, '0');
+}
+/**
+ * @description Path of the hourly bucket file a write at `nowMs` belongs to:
+ * `<dir>/<base>-YYYYMMDDHH.<ext>`, using the HOST-LOCAL clock (so the operator
+ * reading the file sees buckets aligned to their own wall time). Pure — does no
+ * IO, just composes the name.
+ */
+function getHourBucketPath(dir, base, ext, nowMs) {
+    const now = new Date(nowMs);
+    const stamp = `${now.getFullYear()}` +
+        padTwo(now.getMonth() + 1) +
+        padTwo(now.getDate()) +
+        padTwo(now.getHours());
+    return node_path_1.default.join(dir, `${base}-${stamp}.${ext}`);
+}
+/** Match `<base>-<10 digits>.<ext>` and its `.1` rollover sibling. */
+function buildBucketMatcher(base, ext) {
+    const escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`^${escape(base)}-\\d{10}\\.${escape(ext)}(?:\\.1)?$`);
+}
+/**
+ * @description Delete every bucket file for `<base>.<ext>` (including its `.1`
+ * rollover) whose mtime is older than the retention window. Time-bucketing means
+ * we only ever unlink WHOLE buckets the writer is no longer appending to — no
+ * race with the live writer (it only ever touches the current bucket). Pruning
+ * is best-effort: a missing dir, an unreadable entry, or a failed `unlink` is
+ * swallowed per-file so one bad entry can never abort the sweep or throw into
+ * the boot/interval path.
+ */
+async function pruneExpiredBuckets(dir, base, ext, retentionWindowMs, nowMs) {
+    const matcher = buildBucketMatcher(base, ext);
+    let entries;
+    try {
+        entries = await node_fs_1.promises.readdir(dir);
+    }
+    catch {
+        return;
+    }
+    const cutoffMs = nowMs - retentionWindowMs;
+    for (const name of entries) {
+        if (!matcher.test(name))
+            continue;
+        const filePath = node_path_1.default.join(dir, name);
+        try {
+            const stat = await node_fs_1.promises.stat(filePath);
+            if (stat.mtimeMs < cutoffMs)
+                await node_fs_1.promises.unlink(filePath);
+        }
+        catch {
+            // Best-effort: ignore a vanished/locked file, keep sweeping the rest.
+        }
+    }
+}
+//# sourceMappingURL=rotatingLogFile.js.map

package/dist/utils/rotatingLogFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotatingLogFile.js","sourceRoot":"","sources":["../../src/utils/rotatingLogFile.ts"],"names":[],"mappings":";;;;;;AAwBA,8CAQC;AAiBD,kDAyBC;AA1ED,qCAA0C;AAC1C,0DAA6B;AAE7B;;;GAGG;AACU,QAAA,cAAc,GAAG,CAAC,CAAC;AAEhC,MAAM,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE3C,6EAA6E;AAChE,QAAA,WAAW,GAAG,sBAAc,GAAG,mBAAmB,CAAC;AAEhE,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,GAAW,EAAE,IAAY,EAAE,GAAW,EAAE,KAAa;IACrF,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,KAAK,GACT,GAAG,GAAG,CAAC,WAAW,EAAE,EAAE;QACtB,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzB,OAAO,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,sEAAsE;AACtE,SAAS,kBAAkB,CAAC,IAAY,EAAE,GAAW;IACnD,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACvE,OAAO,IAAI,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,IAAY,EACZ,GAAW,EACX,iBAAyB,EACzB,KAAa;IAEb,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,kBAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,GAAG,iBAAiB,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,kBAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,IAAI,CAAC,OAAO,GAAG,QAAQ;gBAAE,MAAM,kBAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;QACxE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/sendRateTracker.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @description Pure, bounded rolling per-chat outbound send-rate tracker.
+ *
+ * A real Telegram 429 only fires under genuine concurrent multi-topic load and
+ * cannot be reproduced from a single client, so the bot keeps ALWAYS-ON
+ * instrumentation that characterises how hard each chat's outbound channel is
+ * being pushed. This helper is the measurement core: it records a timestamp per
+ * outbound send (hooked at the single send chokepoint in `rateLimiter.ts`) into
+ * a bounded rolling window per chat, and answers two questions used by the rich
+ * 429 log line and the periodic rate summary:
+ *
+ *   - sends in the last 60s (the sustained rate/min we pace against), and
+ *   - the PEAK count in any short sub-window (e.g. busiest 10s burst), which
+ *     reveals spikes the per-minute average hides.
+ *
+ * Bounded + best-effort by construction: each chat keeps at most
+ * {@link maxTimestampsPerChat} timestamps (old ones evicted on every record),
+ * so a runaway send loop can't grow memory without bound. It NEVER throws — the
+ * caller hooks it on the send hot path and must not let instrumentation break a
+ * send.
+ *
+ * The clock is injected (same `() => number` shape as {@link BucketClock.now})
+ * so unit tests drive it deterministically with a fake clock.
+ */
+/** Default sub-window for the peak burst query (busiest 10s). */
+export declare const defaultPeakSubWindowMs = 10000;
+export declare class SendRateTracker {
+    private readonly now;
+    private readonly logs;
+    constructor(now?: () => number);
+    /**
+     * Record one outbound send for a chat. Evicts timestamps that have aged out
+     * of the rolling window and enforces the per-chat hard cap. Never throws.
+     */
+    recordSend(chatId: number, nowMs?: number): void;
+    /**
+     * Number of sends within the last `windowMs` for a chat. Defaults to the
+     * 60s window (sends/min — the sustained rate we pace against).
+     */
+    getSendsInWindow(chatId: number, windowMs?: number, nowMs?: number): number;
+    /** Sends in the last 60s for a chat (the sustained rate/min). */
+    getSendsPerMin(chatId: number, nowMs?: number): number;
+    /**
+     * Peak number of sends in ANY sliding `subWindowMs` window across the
+     * retained (last-60s) timestamps — the busiest short burst, which the
+     * per-minute average can hide. Defaults to a 10s sub-window.
+     */
+    getPeakInSubWindow(chatId: number, subWindowMs?: number, nowMs?: number): number;
+    /**
+     * Chat ids that have at least one send still inside the rolling minute — the
+     * chats worth logging in the periodic rate summary (silent chats are skipped).
+     * Also opportunistically drops fully-aged-out chat logs so the map doesn't
+     * accumulate stale chats forever.
+     */
+    getActiveChats(nowMs?: number): number[];
+    /** Evict timestamps older than the rolling window and enforce the hard cap. */
+    private evict;
+}
+//# sourceMappingURL=sendRateTracker.d.ts.map

package/dist/utils/sendRateTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendRateTracker.d.ts","sourceRoot":"","sources":["../../src/utils/sendRateTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAe7C,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;gBAE1B,GAAG,GAAE,MAAM,MAAyB;IAEjE;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,IAAI;IAU5D;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAqB,EAAE,KAAK,GAAE,MAAmB,GAAG,MAAM;IAarG,iEAAiE;IACjE,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,MAAM;IAIlE;;;;OAIG;IACH,kBAAkB,CAChB,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,MAA+B,EAC5C,KAAK,GAAE,MAAmB,GACzB,MAAM;IAsBT;;;;;OAKG;IACH,cAAc,CAAC,KAAK,GAAE,MAAmB,GAAG,MAAM,EAAE;IAapD,+EAA+E;IAC/E,OAAO,CAAC,KAAK;CAWd"}

package/dist/utils/sendRateTracker.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * @description Pure, bounded rolling per-chat outbound send-rate tracker.
+ *
+ * A real Telegram 429 only fires under genuine concurrent multi-topic load and
+ * cannot be reproduced from a single client, so the bot keeps ALWAYS-ON
+ * instrumentation that characterises how hard each chat's outbound channel is
+ * being pushed. This helper is the measurement core: it records a timestamp per
+ * outbound send (hooked at the single send chokepoint in `rateLimiter.ts`) into
+ * a bounded rolling window per chat, and answers two questions used by the rich
+ * 429 log line and the periodic rate summary:
+ *
+ *   - sends in the last 60s (the sustained rate/min we pace against), and
+ *   - the PEAK count in any short sub-window (e.g. busiest 10s burst), which
+ *     reveals spikes the per-minute average hides.
+ *
+ * Bounded + best-effort by construction: each chat keeps at most
+ * {@link maxTimestampsPerChat} timestamps (old ones evicted on every record),
+ * so a runaway send loop can't grow memory without bound. It NEVER throws — the
+ * caller hooks it on the send hot path and must not let instrumentation break a
+ * send.
+ *
+ * The clock is injected (same `() => number` shape as {@link BucketClock.now})
+ * so unit tests drive it deterministically with a fake clock.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SendRateTracker = exports.defaultPeakSubWindowMs = void 0;
+/** Rolling window the per-minute rate is measured over. */
+const rateWindowMs = 60_000;
+/** Default sub-window for the peak burst query (busiest 10s). */
+exports.defaultPeakSubWindowMs = 10_000;
+/**
+ * Hard cap on retained timestamps per chat. At the 40/min sustained ceiling a
+ * 60s window holds ~40 sends; a generous cap absorbs bursts well past the
+ * ceiling while still bounding memory if a send loop misbehaves. Oldest are
+ * dropped first.
+ */
+const maxTimestampsPerChat = 600;
+class SendRateTracker {
+    now;
+    logs = new Map();
+    constructor(now = () => Date.now()) {
+        this.now = now;
+    }
+    /**
+     * Record one outbound send for a chat. Evicts timestamps that have aged out
+     * of the rolling window and enforces the per-chat hard cap. Never throws.
+     */
+    recordSend(chatId, nowMs = this.now()) {
+        let log = this.logs.get(chatId);
+        if (!log) {
+            log = [];
+            this.logs.set(chatId, log);
+        }
+        log.push(nowMs);
+        this.evict(log, nowMs);
+    }
+    /**
+     * Number of sends within the last `windowMs` for a chat. Defaults to the
+     * 60s window (sends/min — the sustained rate we pace against).
+     */
+    getSendsInWindow(chatId, windowMs = rateWindowMs, nowMs = this.now()) {
+        const log = this.logs.get(chatId);
+        if (!log)
+            return 0;
+        const cutoff = nowMs - windowMs;
+        let count = 0;
+        // Oldest-first; walk from the end while inside the window.
+        for (let i = log.length - 1; i >= 0; i -= 1) {
+            if (log[i] <= cutoff)
+                break;
+            count += 1;
+        }
+        return count;
+    }
+    /** Sends in the last 60s for a chat (the sustained rate/min). */
+    getSendsPerMin(chatId, nowMs = this.now()) {
+        return this.getSendsInWindow(chatId, rateWindowMs, nowMs);
+    }
+    /**
+     * Peak number of sends in ANY sliding `subWindowMs` window across the
+     * retained (last-60s) timestamps — the busiest short burst, which the
+     * per-minute average can hide. Defaults to a 10s sub-window.
+     */
+    getPeakInSubWindow(chatId, subWindowMs = exports.defaultPeakSubWindowMs, nowMs = this.now()) {
+        const log = this.logs.get(chatId);
+        if (!log || log.length === 0)
+            return 0;
+        const windowStart = nowMs - rateWindowMs;
+        // Only consider timestamps still inside the rolling minute, oldest-first.
+        const recent = log.filter((ts) => ts > windowStart);
+        if (recent.length === 0)
+            return 0;
+        // Sliding window over the sorted timestamps: for each start, count how many
+        // fall within [ts, ts + subWindowMs).
+        let peak = 0;
+        let right = 0;
+        for (let left = 0; left < recent.length; left += 1) {
+            if (right < left)
+                right = left;
+            while (right < recent.length && recent[right] - recent[left] < subWindowMs) {
+                right += 1;
+            }
+            const count = right - left;
+            if (count > peak)
+                peak = count;
+        }
+        return peak;
+    }
+    /**
+     * Chat ids that have at least one send still inside the rolling minute — the
+     * chats worth logging in the periodic rate summary (silent chats are skipped).
+     * Also opportunistically drops fully-aged-out chat logs so the map doesn't
+     * accumulate stale chats forever.
+     */
+    getActiveChats(nowMs = this.now()) {
+        const active = [];
+        for (const [chatId, log] of this.logs) {
+            this.evict(log, nowMs);
+            if (log.length === 0) {
+                this.logs.delete(chatId);
+                continue;
+            }
+            active.push(chatId);
+        }
+        return active;
+    }
+    /** Evict timestamps older than the rolling window and enforce the hard cap. */
+    evict(log, nowMs) {
+        const cutoff = nowMs - rateWindowMs;
+        // Drop the aged-out prefix (oldest-first → contiguous prefix).
+        let dropTo = 0;
+        while (dropTo < log.length && log[dropTo] <= cutoff)
+            dropTo += 1;
+        if (dropTo > 0)
+            log.splice(0, dropTo);
+        // Hard cap: if still over, drop the oldest overflow.
+        if (log.length > maxTimestampsPerChat) {
+            log.splice(0, log.length - maxTimestampsPerChat);
+        }
+    }
+}
+exports.SendRateTracker = SendRateTracker;
+//# sourceMappingURL=sendRateTracker.js.map

package/dist/utils/sendRateTracker.js.map

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

package/dist/utils/serialQueue.d.ts

@@ -0,0 +1,5 @@
+export interface SerialQueue {
+    run<T>(fn: () => Promise<T>): Promise<T>;
+}
+export declare function createSerialQueue(): SerialQueue;
+//# sourceMappingURL=serialQueue.d.ts.map

package/dist/utils/serialQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialQueue.d.ts","sourceRoot":"","sources":["../../src/utils/serialQueue.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1C;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAU/C"}

package/dist/utils/serialQueue.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSerialQueue = createSerialQueue;
+function createSerialQueue() {
+    let tail = Promise.resolve();
+    return {
+        run(fn) {
+            const next = tail.then(fn, fn);
+            tail = next.catch(() => undefined);
+            return next;
+        },
+    };
+}
+//# sourceMappingURL=serialQueue.js.map

package/dist/utils/serialQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialQueue.js","sourceRoot":"","sources":["../../src/utils/serialQueue.ts"],"names":[],"mappings":";;AAIA,8CAUC;AAVD,SAAgB,iBAAiB;IAC/B,IAAI,IAAI,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAE/C,OAAO;QACL,GAAG,CAAI,EAAoB;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/sseStreamLifecycle.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @description Pure decision logic for the OpenCode adapter's SSE stream
+ * lifecycle — extracted from `openCodeAdapter.ts` so the "open on the first
+ * session, close on the last" rule is unit-testable without a live server or
+ * sockets.
+ *
+ * Background (plan 2026-06-17): the adapter owns ONE `/global/event` stream for
+ * the whole server (it superseded both the per-thread `/global/event` model of
+ * plan 2026-06-05 and the per-directory `/event?directory=` model, the latter
+ * going silent for an aged sole subscriber on opencode 1.14.41). Every event is
+ * JSON-parsed exactly once and routed by the envelope `directory` + `sessionID`.
+ * The single stream's lifecycle is reference-counted by the TOTAL active-session
+ * count: it opens when the FIRST active session (any folder) appears and closes
+ * when the LAST one goes away — `getSseStreamTransition` is driven with those
+ * totals.
+ */
+/**
+ * @description Decide what to do with the SSE stream after the count of active
+ * sessions changes by one. Driven with the TOTAL active-session count (plan
+ * 2026-06-17): the single global stream opens on the first session anywhere and
+ * closes on the last.
+ *
+ * `open`  — went from zero active sessions to one: start the stream.
+ * `close` — went from one active session to zero: tear it down.
+ * `none`  — a sibling session already keeps (or still keeps) the stream alive,
+ *           or the change is a no-op.
+ *
+ * @param activeSessionCountBefore active sessions BEFORE the change (must be ≥ 0).
+ * @param activeSessionCountAfter active sessions AFTER the change (must be ≥ 0).
+ */
+export declare function getSseStreamTransition(activeSessionCountBefore: number, activeSessionCountAfter: number): 'open' | 'close' | 'none';
+//# sourceMappingURL=sseStreamLifecycle.d.ts.map

package/dist/utils/sseStreamLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseStreamLifecycle.d.ts","sourceRoot":"","sources":["../../src/utils/sseStreamLifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,wBAAwB,EAAE,MAAM,EAChC,uBAAuB,EAAE,MAAM,GAC9B,MAAM,GAAG,OAAO,GAAG,MAAM,CAI3B"}

package/dist/utils/sseStreamLifecycle.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * @description Pure decision logic for the OpenCode adapter's SSE stream
+ * lifecycle — extracted from `openCodeAdapter.ts` so the "open on the first
+ * session, close on the last" rule is unit-testable without a live server or
+ * sockets.
+ *
+ * Background (plan 2026-06-17): the adapter owns ONE `/global/event` stream for
+ * the whole server (it superseded both the per-thread `/global/event` model of
+ * plan 2026-06-05 and the per-directory `/event?directory=` model, the latter
+ * going silent for an aged sole subscriber on opencode 1.14.41). Every event is
+ * JSON-parsed exactly once and routed by the envelope `directory` + `sessionID`.
+ * The single stream's lifecycle is reference-counted by the TOTAL active-session
+ * count: it opens when the FIRST active session (any folder) appears and closes
+ * when the LAST one goes away — `getSseStreamTransition` is driven with those
+ * totals.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSseStreamTransition = getSseStreamTransition;
+/**
+ * @description Decide what to do with the SSE stream after the count of active
+ * sessions changes by one. Driven with the TOTAL active-session count (plan
+ * 2026-06-17): the single global stream opens on the first session anywhere and
+ * closes on the last.
+ *
+ * `open`  — went from zero active sessions to one: start the stream.
+ * `close` — went from one active session to zero: tear it down.
+ * `none`  — a sibling session already keeps (or still keeps) the stream alive,
+ *           or the change is a no-op.
+ *
+ * @param activeSessionCountBefore active sessions BEFORE the change (must be ≥ 0).
+ * @param activeSessionCountAfter active sessions AFTER the change (must be ≥ 0).
+ */
+function getSseStreamTransition(activeSessionCountBefore, activeSessionCountAfter) {
+    if (activeSessionCountBefore <= 0 && activeSessionCountAfter > 0)
+        return 'open';
+    if (activeSessionCountBefore > 0 && activeSessionCountAfter <= 0)
+        return 'close';
+    return 'none';
+}
+//# sourceMappingURL=sseStreamLifecycle.js.map

package/dist/utils/sseStreamLifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseStreamLifecycle.js","sourceRoot":"","sources":["../../src/utils/sseStreamLifecycle.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;AAgBH,wDAOC;AArBD;;;;;;;;;;;;;GAaG;AACH,SAAgB,sBAAsB,CACpC,wBAAgC,EAChC,uBAA+B;IAE/B,IAAI,wBAAwB,IAAI,CAAC,IAAI,uBAAuB,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IAChF,IAAI,wBAAwB,GAAG,CAAC,IAAI,uBAAuB,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC;IACjF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/startupReadiness.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @description Pure decision layer for the boot-time readiness status message
+ * (plan 2026-07-12-startup-readiness-status). On startup the bot tells the owner
+ * whether it can process messages in the topics / group, or — if not — a numbered
+ * list of only the setup steps that are still unmet. This module holds the pure,
+ * unit-testable core: which items are unmet, whether the bot is ready, the
+ * cadence gate, and the full message composition (via an injected translate so
+ * the numbering / header logic is testable without the i18n runtime). `bot.ts`
+ * gathers the live facts and does the actual Telegram send.
+ */
+/** One of the three Telegram admin rights the bot needs in the paired group. */
+export type BotRightKey = 'manageTopics' | 'pin' | 'delete';
+/** The three admin rights, resolved from the bot's `getChatMember` in the group. */
+export interface BotAdminRights {
+    manageTopics: boolean;
+    pin: boolean;
+    delete: boolean;
+}
+/**
+ * @description The checklist items, in the fixed order they render. The first
+ * four are REQUIRED (their unmet state makes the bot not-ready); the two
+ * `optional_*` items are informational only and never affect {@link
+ * ReadinessReport.isReady}.
+ */
+export type ReadinessItemKey = 'create_group' | 'grant_admin' | 'bind_topic' | 'install_agent' | 'optional_groq' | 'optional_owner';
+/** The live facts `bot.ts` gathers at boot and feeds to {@link buildReadinessReport}. */
+export interface ReadinessFacts {
+    /** A forum supergroup is paired (`getAllowedGroupId() != null`). */
+    groupPaired: boolean;
+    /**
+     * The bot's admin rights in the paired group, or `null` when unpaired / the
+     * bot is not an administrator / the rights could not be read.
+     */
+    botRights: BotAdminRights | null;
+    /** At least one topic in the paired group is bound to a folder. */
+    hasBinding: boolean;
+    /** Installed agent CLIs among `claude` / `opencode` (empty ⇒ none installed). */
+    availableAgents: string[];
+    /** `GROQ_API_KEY` is present (optional — enables voice input). */
+    hasGroq: boolean;
+    /** `OWNER_USER_ID` is set. */
+    ownerSet: boolean;
+    /**
+     * Delivery fell back to the group's General topic because the owner DM was
+     * unreachable / unset. Only ever surfaces the `optional_owner` hint (and only
+     * when `ownerSet` is false — a set-but-unopened DM is not the same problem).
+     */
+    usedGeneralFallback: boolean;
+}
+/** The pure verdict {@link buildReadinessReport} produces. */
+export interface ReadinessReport {
+    /** True iff every REQUIRED item is met (optional items never block this). */
+    isReady: boolean;
+    /** The unmet items, in render order — drives the numbered checklist. */
+    unmetKeys: ReadinessItemKey[];
+    /** Which specific admin rights are missing (for the `grant_admin` item copy). */
+    missingRights: BotRightKey[];
+}
+/**
+ * @description Telegram's canonical permission names for the three rights the
+ * bot needs — proper nouns shown verbatim in the `grant_admin` item so the
+ * operator can find the exact toggles in Telegram's admin UI. Kept here (not in
+ * i18n) because they are feature identifiers, not translated prose.
+ */
+export declare const botRightLabels: Record<BotRightKey, string>;
+/**
+ * @description The admin rights the bot is missing. A `null` rights object (not
+ * an admin / unreadable) counts as ALL three missing.
+ */
+export declare function getMissingBotRights(rights: BotAdminRights | null): BotRightKey[];
+/** Join the missing rights into the human list for the `grant_admin` item copy. */
+export declare function formatMissingRights(keys: BotRightKey[]): string;
+/**
+ * @description Turn the live facts into the readiness verdict.
+ *
+ * `isReady` is true iff NONE of the required items are unmet:
+ *   groupPaired  &&  all admin rights held  &&  a binding exists  &&  an agent CLI installed.
+ * The optional groq / owner items are informational — they populate `unmetKeys`
+ * (so they render inside a not-ready checklist) but never flip `isReady`.
+ *
+ * `grant_admin` is only unmet while a group IS paired (you cannot grant admin
+ * before the group exists — an unpaired bot shows `create_group` instead).
+ */
+export declare function buildReadinessReport(facts: ReadinessFacts): ReadinessReport;
+/**
+ * @description Cadence gate. A COLD start always sends (ready or not). A HOT
+ * reload stays silent when fully ready (no spam on frequent rebuilds) and sends
+ * only when something is missing.
+ */
+export declare function checkShouldSendStartupStatus(input: {
+    isHotReload: boolean;
+    isReady: boolean;
+}): boolean;
+/** A resolved delivery surface for the boot-time status: the owner DM or the group's General topic. */
+export type StartupTarget = 'owner' | 'general';
+/**
+ * @description Resolve the ordered delivery targets for the boot-time status.
+ *
+ * The READY status is only meaningful in the owner's private DM, so it is
+ * DM-ONLY and NEVER falls back to the group's General topic (a "✅ Ready" in the
+ * shared group is pure noise). If there is no owner DM, a ready status resolves
+ * to an empty list — nothing is delivered (the caller logs it).
+ *
+ * The NOT-READY checklist is actionable, so it uses the owner DM when available
+ * and falls back to General otherwise (owner first):
+ *
+ *   ready      → hasOwnerTarget ? ['owner'] : []            (private-only, never 'general')
+ *   not-ready  → ['owner', 'general'] filtered to the available surfaces (owner first)
+ */
+export declare function resolveStartupTargets(isReady: boolean, hasOwnerTarget: boolean, hasGeneralTarget: boolean): StartupTarget[];
+/** Injected translate — `(code, opts) => string`, so composition is testable without the i18n runtime. */
+export type StartupStatusTranslate = (code: string, opts?: Record<string, string>) => string;
+/**
+ * @description Compose the full status message. Ready ⇒ the short ready line.
+ * Not ready ⇒ a header followed by the unmet items renumbered 1..N (the
+ * `grant_admin` line interpolates the missing-rights list).
+ */
+export declare function buildStartupStatusText(report: ReadinessReport, translate: StartupStatusTranslate): string;
+//# sourceMappingURL=startupReadiness.d.ts.map

package/dist/utils/startupReadiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startupReadiness.d.ts","sourceRoot":"","sources":["../../src/utils/startupReadiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE5D,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,aAAa,GACb,YAAY,GACZ,eAAe,GACf,eAAe,GACf,gBAAgB,CAAC;AAErB,yFAAyF;AACzF,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,iFAAiF;IACjF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,iFAAiF;IACjF,aAAa,EAAE,WAAW,EAAE,CAAC;CAC9B;AAoBD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAItD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,WAAW,EAAE,CAOhF;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,CAE/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAe3E;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAEV;AAED,uGAAuG;AACvG,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,OAAO,EACvB,gBAAgB,EAAE,OAAO,GACxB,aAAa,EAAE,CAQjB;AAED,0GAA0G;AAC1G,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC;AAE7F;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,sBAAsB,GAChC,MAAM,CAaR"}