@songsid/agend 2.2.0-alpha.1 → 2.2.0-alpha.3

package/dist/package-preimage.js

@@ -0,0 +1,96 @@
+/**
+ * #1450 C6: what a failed transition restores. npm rolls a global install back only while its own lifecycle runs; a
+ * failure AFTER npm succeeded — the target does not verify, its service cannot be proven or loaded — needs the
+ * previous package back. "Reinstall the previous version" is not a rollback: an older package has no install hook to
+ * re-provision anything, and a service written for the new one names a Node inside the new package.
+ *
+ * So before npm runs the updater copies the installed package (with its node_modules, so its bundled runtime) to
+ * `<prefix>/.agend-rollback/<version>-<ts>/agend` — the same filesystem, so a restore is a rename — and records where
+ * its bin links point. Restoring renames the new tree aside, renames the preimage in, and puts the bin links back.
+ * After a successful transition only the newest preimage is kept (for a later repair); older ones are removed.
+ */
+import { cpSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, readlinkSync, renameSync, rmSync, symlinkSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+export const ROLLBACK_DIR = ".agend-rollback";
+const BINS = ["agend", "agend-agent"];
+/** The installed package under `root` (npm's global node_modules), copied aside — or null when none is installed. */
+export function takePackagePreimage(root, prefix, now) {
+    const pkg = join(root, "@songsid", "agend");
+    if (!existsSync(join(pkg, "package.json")))
+        return { ok: true, preimage: null };
+    let version;
+    try {
+        version = String(JSON.parse(readFileSync(join(pkg, "package.json"), "utf8")).version);
+    }
+    catch {
+        return { ok: false, reason: `the installed ${pkg}/package.json cannot be read` };
+    }
+    const dir = join(prefix, ROLLBACK_DIR, `${version}-${now.toISOString().replace(/[:.]/g, "-")}`);
+    try {
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+        cpSync(pkg, join(dir, "agend"), { recursive: true, verbatimSymlinks: true, preserveTimestamps: true });
+    }
+    catch (err) {
+        rmSync(dir, { recursive: true, force: true });
+        return { ok: false, reason: `the installed package could not be copied aside for a rollback (${err.message})` };
+    }
+    const links = {};
+    for (const bin of BINS) {
+        try {
+            links[bin] = lstatSync(join(prefix, "bin", bin)).isSymbolicLink() ? readlinkSync(join(prefix, "bin", bin)) : null;
+        }
+        catch {
+            links[bin] = null;
+        }
+    }
+    return { ok: true, preimage: { dir, version, links } };
+}
+/** Put the preimage back in place of whatever npm installed; the replaced tree is removed once the swap is done. */
+export function restorePackagePreimage(root, prefix, p) {
+    const pkg = join(root, "@songsid", "agend");
+    const aside = join(p.dir, "replaced");
+    try {
+        if (existsSync(pkg))
+            renameSync(pkg, aside);
+        renameSync(join(p.dir, "agend"), pkg);
+    }
+    catch (err) {
+        return { ok: false, reason: `the previous package could not be put back from ${p.dir} (${err.message})` };
+    }
+    for (const bin of BINS) {
+        const link = join(prefix, "bin", bin);
+        try {
+            unlinkSync(link);
+        }
+        catch { /* absent */ }
+        const target = p.links[bin];
+        if (target) {
+            try {
+                symlinkSync(target, link);
+            }
+            catch (err) {
+                return { ok: false, reason: `${link} could not be restored (${err.message})` };
+            }
+        }
+    }
+    rmSync(aside, { recursive: true, force: true });
+    rmSync(p.dir, { recursive: true, force: true });
+    return { ok: true };
+}
+/** After a successful transition: keep only `keep` (the newest preimage), remove every other one. */
+export function prunePreimages(prefix, keep) {
+    const base = join(prefix, ROLLBACK_DIR);
+    let entries = [];
+    try {
+        entries = readdirSync(base);
+    }
+    catch {
+        return;
+    }
+    for (const name of entries) {
+        if (keep && join(base, name) === keep.dir)
+            continue;
+        rmSync(join(base, name), { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=package-preimage.js.map

package/dist/package-preimage.js.map

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

package/dist/pane-context-cache.d.ts

@@ -0,0 +1,25 @@
+import { type TokenContextRatio } from "./context-percent.js";
+/** Captured pane owner; the producer keeps this operation permanently revoked after replacement/stop. */
+export interface PaneContextSource {
+    readonly owner: object;
+    readonly generation: string;
+    isCurrent(): boolean;
+    /** Production uses the manager's bounded control-mode read lane (60 lines, 2s including queueing). */
+    capture(): Promise<string>;
+}
+export interface PaneContextValue {
+    context: number | null;
+    tokenRatio: TokenContextRatio | null;
+}
+/** One refresh per current pane owner; transport fallback belongs to its bounded manager read lane. */
+export declare class PaneContextCache {
+    private now;
+    private entries;
+    constructor(now?: () => number);
+    private key;
+    private current;
+    resolve(dataDir: string, instance: string, backend: string, source?: PaneContextSource | null): PaneContextValue;
+    record(dataDir: string, instance: string, backend: string, value: PaneContextValue, source?: PaneContextSource | null): void;
+    forget(instance: string): void;
+    private refresh;
+}

package/dist/pane-context-cache.js

@@ -0,0 +1,73 @@
+import { parseContextPercent, parseTokenContextRatio } from "./context-percent.js";
+const empty = () => ({ context: null, tokenRatio: null });
+/** One refresh per current pane owner; transport fallback belongs to its bounded manager read lane. */
+export class PaneContextCache {
+    now;
+    entries = new Map();
+    constructor(now = () => performance.now()) {
+        this.now = now;
+    }
+    key(dataDir, instance) { return JSON.stringify([dataDir, instance]); }
+    current(source) {
+        try {
+            return source.isCurrent();
+        }
+        catch {
+            return false;
+        }
+    }
+    resolve(dataDir, instance, backend, source) {
+        const key = this.key(dataDir, instance);
+        if (!source || !this.current(source)) {
+            this.entries.delete(key);
+            return empty();
+        }
+        let entry = this.entries.get(key);
+        if (!entry || entry.backend !== backend || entry.source.owner !== source.owner
+            || entry.source.generation !== source.generation || !this.current(entry.source)) {
+            entry = { instance, backend, source, at: -Infinity, value: empty(), inFlight: false };
+            this.entries.set(key, entry);
+        }
+        if (!entry.inFlight && this.now() - entry.at >= 8_000) {
+            entry.inFlight = true;
+            void this.refresh(key, entry);
+        }
+        return { ...entry.value };
+    }
+    record(dataDir, instance, backend, value, source) {
+        if (!source || !this.current(source))
+            return;
+        this.entries.set(this.key(dataDir, instance), { instance, backend, source, at: this.now(), value, inFlight: false });
+    }
+    forget(instance) {
+        for (const [key, entry] of this.entries)
+            if (entry.instance === instance)
+                this.entries.delete(key);
+    }
+    async refresh(key, entry) {
+        let value = empty();
+        try {
+            if (!this.current(entry.source))
+                return;
+            const pane = await entry.source.capture();
+            if (!this.current(entry.source))
+                return;
+            const tokenRatio = entry.backend === "grok" ? parseTokenContextRatio(pane) : null;
+            value = { context: tokenRatio?.percentage ?? parseContextPercent(pane), tokenRatio };
+        }
+        catch { /* unavailable remains unknown, as with the prior scrape */ }
+        finally {
+            // Forget/re-create, cancel, stop, respawn and a new pane cannot accept this old result.
+            if (this.entries.get(key) === entry) {
+                if (!this.current(entry.source))
+                    this.entries.delete(key);
+                else {
+                    entry.value = value;
+                    entry.at = this.now();
+                    entry.inFlight = false;
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=pane-context-cache.js.map

package/dist/pane-context-cache.js.map

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

package/dist/paths.d.ts

@@ -1,12 +1,5 @@
 /** Resolve the AgEnD data directory. Override with AGEND_HOME env var. */
 export declare function getAgendHome(): string;
-/**
- * The user's real AgEnD home: `.agend` in the home directory from the
- * password database, NOT `$HOME`. A test or throwaway fleet that changes HOME
- * (and AGEND_HOME with it) must not be mistaken for the user's own fleet.
- * Null when the password database cannot be read: falling back to homedir()
- * would trust `$HOME` again (#1128 review), so then no home is the default.
- */
 export declare function realDefaultAgendHome(): string | null;
 /**
  * Whether this process's AgEnD home is the user's real default one — the only

package/dist/paths.js

@@ -14,13 +14,19 @@ export function getAgendHome() {
  * Null when the password database cannot be read: falling back to homedir()
  * would trust `$HOME` again (#1128 review), so then no home is the default.
  */
+let verifiedDefaultHome;
 export function realDefaultAgendHome() {
+    const uid = process.getuid?.() ?? null;
+    if (verifiedDefaultHome?.uid === uid)
+        return verifiedDefaultHome.home;
     try {
-        return join(userInfo().homedir, ".agend");
+        const home = join(userInfo().homedir, ".agend");
+        verifiedDefaultHome = { uid, home };
+        return home;
     }
     catch {
         return null;
-    }
+    } // unknown never trusts HOME, and may retry a later OS lookup
 }
 /**
  * Whether this process's AgEnD home is the user's real default one — the only

package/dist/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,0EAA0E;AAC1E,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,YAAY,EAAE;IAC9D,0EAA0E;IAC1E,uEAAuE;IACvE,yEAAyE;IACzE,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC;IACpC,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC;AACxC,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,4EAA4E;IAC5E,2EAA2E;IAC3E,4EAA4E;IAC5E,YAAY;IACZ,OAAO,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,QAAuB;IACtE,OAAO,QAAQ,KAAK,IAAI,IAAI,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;AACjF,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,QAAuB;IACrE,OAAO,QAAQ,KAAK,IAAI,IAAI,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,kBAAkB;IAChC,OAAO,kBAAkB,CAAC,YAAY,EAAE,EAAE,oBAAoB,EAAE,CAAC,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,iBAAiB,CAAC,YAAY,EAAE,EAAE,oBAAoB,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;QACnC,4EAA4E;QAC5E,6EAA6E;QAC7E,IAAI,CAAC;YAAC,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACpG,CAAC;AACH,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"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"}

package/dist/provider-probe.d.ts

@@ -18,6 +18,21 @@ export interface TelegramStartResult {
 export declare function redactProviderError(error: unknown, secret?: string): string;
 export declare function verifyDiscordToken(token: string, doFetch?: typeof fetch): Promise<BotIdentity>;
 export declare function listDiscordGuilds(token: string, doFetch?: typeof fetch): Promise<DiscordGuild[]>;
+export interface DiscordTextChannel {
+    id: string;
+    name: string;
+}
+/**
+ * #1519 P3: a server's text channels, as the bot sees them (GET /guilds/{id}/channels with its token), in Discord's
+ * order — for the General channel picker. A guild the bot is not in, or one it cannot list, is { ok: false }.
+ */
+export declare function listDiscordTextChannels(token: string, guildId: string, doFetch?: typeof fetch): Promise<{
+    ok: true;
+    channels: DiscordTextChannel[];
+} | {
+    ok: false;
+    error: string;
+}>;
 export declare function verifyTelegramToken(token: string, doFetch?: typeof fetch): Promise<BotIdentity>;
 /** Long-polling `getUpdates` has one consumer. A second one takes turns with the
  * first and both miss messages, which is why a running fleet must never be

package/dist/provider-probe.js

@@ -43,6 +43,26 @@ export async function listDiscordGuilds(token, doFetch = fetch) {
         return [];
     }
 }
+/**
+ * #1519 P3: a server's text channels, as the bot sees them (GET /guilds/{id}/channels with its token), in Discord's
+ * order — for the General channel picker. A guild the bot is not in, or one it cannot list, is { ok: false }.
+ */
+export async function listDiscordTextChannels(token, guildId, doFetch = fetch) {
+    if (!/^\d{1,20}$/.test(guildId))
+        return { ok: false, error: "guild id must be numeric" };
+    try {
+        const res = await doFetch(`${DISCORD_API}/guilds/${guildId}/channels`, { headers: { Authorization: `Bot ${token}` } });
+        if (!res.ok)
+            return { ok: false, error: `Discord replied ${res.status}` };
+        const rows = (await res.json());
+        const text = (Array.isArray(rows) ? rows : []).filter(c => c && c.type === 0 && typeof c.id === "string" && typeof c.name === "string");
+        text.sort((a, b) => (a.position ?? 0) - (b.position ?? 0));
+        return { ok: true, channels: text.map(c => ({ id: c.id, name: c.name })) };
+    }
+    catch (err) {
+        return { ok: false, error: redactProviderError(err, token) };
+    }
+}
 export async function verifyTelegramToken(token, doFetch = fetch) {
     try {
         const res = await doFetch(`https://api.telegram.org/bot${token}/getMe`);

package/dist/provider-probe.js.map

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

package/dist/public-link-progress.d.ts

@@ -0,0 +1,73 @@
+import type { CloudflaredInstallErrorKind } from "./tunnel/cloudflared-install.js";
+export type PublicLinkStep = "check" | "download" | "verify" | "tunnel" | "address" | "deliver";
+/** Why a step failed, as one of a fixed set: each has its own static sentence. */
+export type PublicLinkFailure = "unsupported-platform" | "download-failed" | "checksum-mismatch" | "install-failed" | "cancelled" | "spawn-failed" | "no-address" | "unreachable" | "lease-held" | "gateway-failed" | "delivery-failed" | "closed" | "unknown";
+export interface PublicLinkProgress {
+    readonly startedAt: number;
+    /** Steps begun so far, in order; the last one without `endedAt` is the one running. */
+    readonly steps: ReadonlyArray<{
+        readonly step: PublicLinkStep;
+        readonly startedAt: number;
+        readonly endedAt?: number;
+    }>;
+    /** `checking` until the install answered; `download` shows ①–③, `installed` hides them. */
+    readonly install: "checking" | "installed" | "download";
+    readonly version?: string;
+    readonly download?: {
+        readonly received: number;
+        readonly total: number | null;
+    };
+    readonly failed?: {
+        readonly step: PublicLinkStep;
+        readonly reason: PublicLinkFailure;
+    };
+}
+/** The install's and the tunnel's error kinds, folded into the reasons a user is shown. */
+export declare function failureOf(kind: CloudflaredInstallErrorKind | string | undefined): PublicLinkFailure;
+/** Builds the snapshots; each change hands a new immutable one to `emit`. */
+export declare class PublicLinkProgressTracker {
+    private readonly now;
+    private readonly emit;
+    private state;
+    constructor(now: () => number, emit: (p: PublicLinkProgress) => void);
+    get snapshot(): PublicLinkProgress;
+    private set;
+    /** Ends the running step (if any) and begins `step`. A step already begun is not begun again. */
+    begin(step: PublicLinkStep, extra?: Partial<Pick<PublicLinkProgress, "install" | "version" | "download">>): void;
+    installChecked(download: boolean, version: string): void;
+    downloaded(received: number, total: number | null): void;
+    /** Every running step ends now. */
+    complete(): void;
+    fail(reason: PublicLinkFailure): void;
+}
+/** The message text for one snapshot, at monotonic time `now`; `outcome` is the closing line once it is decided. */
+export declare function renderPublicLinkProgress(p: PublicLinkProgress, now: number, outcome?: string): string;
+/**
+ * Edits one message with the latest text, no more often than `minIntervalMs`: a burst of changes (download bytes)
+ * becomes one edit carrying the newest. While open it refreshes every `heartbeatMs`, so the seconds move even when
+ * nothing else does. One edit at a time, an unchanged text is never sent again (Telegram refuses "not modified"),
+ * and two failed edits in a row stop it (the message or its token is gone). `close` waits out the edit in flight,
+ * so whatever the caller writes next lands after it.
+ */
+export declare class ThrottledMessageEditor {
+    private readonly opts;
+    private render;
+    private lastText;
+    private lastSentAt;
+    private inFlight;
+    private timer;
+    private closed;
+    private failures;
+    constructor(opts: {
+        edit: (text: string) => Promise<void>;
+        now: () => number;
+        minIntervalMs: number;
+        heartbeatMs: number;
+        onError?: (err: unknown) => void;
+    });
+    update(render: () => string): void;
+    private pump;
+    private arm;
+    /** No edit after this one returns; the one in flight has settled. */
+    close(): Promise<void>;
+}

package/dist/public-link-progress.js

@@ -0,0 +1,190 @@
+/**
+ * What opening a temporary public link is doing, step by step, for the message the admin clicked on.
+ *
+ *   ① check cloudflared  ② download it  ③ verify it      — only when AgEnD's pinned copy must be fetched
+ *   ④ start the tunnel   ⑤ wait for the public address   ⑥ deliver the link privately
+ *
+ * The text goes where the button was: a Discord ephemeral reply, or the Telegram menu in General. So it holds
+ * only static words, numbers and durations — never the link, the code, a path or a platform's error text.
+ * Durations are monotonic (performance.now), so a wall-clock jump cannot make a step take negative time.
+ */
+import { t } from "./locale.js";
+const STEPS = ["check", "download", "verify", "tunnel", "address", "deliver"];
+const NUMBERS = { check: "①", download: "②", verify: "③", tunnel: "④", address: "⑤", deliver: "⑥" };
+/** The install's and the tunnel's error kinds, folded into the reasons a user is shown. */
+export function failureOf(kind) {
+    switch (kind) {
+        case "unsupported-platform":
+        case "download-failed":
+        case "checksum-mismatch":
+        case "install-failed":
+        case "cancelled":
+        case "lease-held":
+            return kind;
+        case "binary-missing":
+        case "binary-not-executable":
+        case "spawn-failed":
+        case "not-logged-in":
+            return "spawn-failed";
+        case "no-url":
+        case "bad-url":
+        case "timeout":
+            return "no-address";
+        case "readiness-failed":
+            return "unreachable";
+        default:
+            return "unknown";
+    }
+}
+/** Builds the snapshots; each change hands a new immutable one to `emit`. */
+export class PublicLinkProgressTracker {
+    now;
+    emit;
+    state;
+    constructor(now, emit) {
+        this.now = now;
+        this.emit = emit;
+        const at = now();
+        this.state = { startedAt: at, steps: [{ step: "check", startedAt: at }], install: "checking" };
+    }
+    get snapshot() { return this.state; }
+    set(next) { this.state = next; this.emit(next); }
+    /** Ends the running step (if any) and begins `step`. A step already begun is not begun again. */
+    begin(step, extra = {}) {
+        if (this.state.failed || this.state.steps.some(s => s.step === step)) {
+            if (Object.keys(extra).length)
+                this.set({ ...this.state, ...extra });
+            return;
+        }
+        const at = this.now();
+        const steps = this.state.steps.map(s => s.endedAt === undefined ? { ...s, endedAt: at } : s);
+        this.set({ ...this.state, ...extra, steps: [...steps, { step, startedAt: at }] });
+    }
+    installChecked(download, version) {
+        if (download)
+            this.begin("download", { install: "download", version });
+        else
+            this.set({ ...this.state, install: "installed", version });
+    }
+    downloaded(received, total) { this.set({ ...this.state, download: { received, total } }); }
+    /** Every running step ends now. */
+    complete() {
+        const at = this.now();
+        this.set({ ...this.state, steps: this.state.steps.map(s => s.endedAt === undefined ? { ...s, endedAt: at } : s) });
+    }
+    fail(reason) {
+        if (this.state.failed)
+            return;
+        const running = [...this.state.steps].reverse().find(s => s.endedAt === undefined) ?? this.state.steps.at(-1);
+        const at = this.now();
+        this.set({ ...this.state, failed: { step: running.step, reason }, steps: this.state.steps.map(s => s.endedAt === undefined ? { ...s, endedAt: at } : s) });
+    }
+}
+function seconds(ms) { return Math.max(0, Math.floor(ms / 1000)); }
+function megabytes(bytes) { return (bytes / (1024 * 1024)).toFixed(1); }
+/** The message text for one snapshot, at monotonic time `now`; `outcome` is the closing line once it is decided. */
+export function renderPublicLinkProgress(p, now, outcome) {
+    const shown = STEPS.filter(step => p.install === "download" || !["download", "verify"].includes(step))
+        .filter(step => p.install !== "installed" || step !== "check");
+    const end = Math.max(...p.steps.map(s => s.endedAt ?? now));
+    const lines = [t("dashboard.progress.title", seconds((outcome !== undefined || p.failed ? end : now) - p.startedAt))];
+    for (const step of shown) {
+        const begun = p.steps.find(s => s.step === step);
+        const label = `${NUMBERS[step]} ${stepLabel(step, p)}`;
+        if (!begun) {
+            lines.push(`▫️ ${label}`);
+            continue;
+        }
+        const took = seconds((begun.endedAt ?? now) - begun.startedAt);
+        if (p.failed?.step === step)
+            lines.push(`❌ ${label} · ${t("dashboard.progress.seconds", took)} — ${t(`dashboard.progress.fail.${p.failed.reason}`)}`);
+        else if (begun.endedAt !== undefined)
+            lines.push(`✅ ${label} · ${t("dashboard.progress.seconds", took)}`);
+        else
+            lines.push(`⏳ ${label} · ${t("dashboard.progress.seconds", took)}`);
+    }
+    if (outcome)
+        lines.push("", outcome);
+    return lines.join("\n");
+}
+function stepLabel(step, p) {
+    switch (step) {
+        case "check":
+            return p.install === "download" ? t("dashboard.progress.check_download", p.version ?? "") : t("dashboard.progress.check");
+        case "download": {
+            const d = p.download;
+            if (!d)
+                return t("dashboard.progress.download");
+            return d.total ? t("dashboard.progress.download_of", megabytes(d.received), megabytes(d.total)) : t("dashboard.progress.download_bytes", megabytes(d.received));
+        }
+        default:
+            return t(`dashboard.progress.${step}`);
+    }
+}
+/**
+ * Edits one message with the latest text, no more often than `minIntervalMs`: a burst of changes (download bytes)
+ * becomes one edit carrying the newest. While open it refreshes every `heartbeatMs`, so the seconds move even when
+ * nothing else does. One edit at a time, an unchanged text is never sent again (Telegram refuses "not modified"),
+ * and two failed edits in a row stop it (the message or its token is gone). `close` waits out the edit in flight,
+ * so whatever the caller writes next lands after it.
+ */
+export class ThrottledMessageEditor {
+    opts;
+    render = null;
+    lastText = null;
+    lastSentAt = Number.NEGATIVE_INFINITY;
+    inFlight = null;
+    timer = null;
+    closed = false;
+    failures = 0;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    update(render) {
+        if (this.closed)
+            return;
+        this.render = render;
+        this.pump();
+    }
+    pump() {
+        if (this.closed || this.inFlight || !this.render)
+            return;
+        const wait = this.lastSentAt + this.opts.minIntervalMs - this.opts.now();
+        if (wait > 0) {
+            this.arm(wait);
+            return;
+        }
+        const text = this.render();
+        if (text === this.lastText) {
+            this.arm(this.opts.heartbeatMs);
+            return;
+        }
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.lastText = text;
+        this.lastSentAt = this.opts.now();
+        this.inFlight = this.opts.edit(text).then(() => { this.failures = 0; }, err => { this.failures++; this.opts.onError?.(err); if (this.failures >= 2)
+            this.closed = true; }).finally(() => { this.inFlight = null; if (!this.closed)
+            this.arm(this.opts.heartbeatMs); });
+    }
+    arm(ms) {
+        if (this.closed)
+            return;
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = setTimeout(() => { this.timer = null; this.pump(); }, Math.max(0, ms));
+        this.timer.unref?.();
+    }
+    /** No edit after this one returns; the one in flight has settled. */
+    async close() {
+        this.closed = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        await this.inFlight;
+    }
+}
+//# sourceMappingURL=public-link-progress.js.map

package/dist/public-link-progress.js.map

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

package/dist/public-web-gateway.js

@@ -25,9 +25,9 @@ export function isPublicWebRoute(method, path) {
         return true;
     if (method === "GET" && /^\/ui\/js\/[a-z0-9_-]+\.js$/.test(path))
         return true;
-    if (method === "GET" && /^\/ui\/(backends|poll|history|file\/[^/]+|prompts|instance\/[^/]+|instances|tasks(?:\/[^/]+)?|schedules(?:\/[^/]+)?|teams(?:\/[^/]+)?|config|org)$/.test(path))
+    if (method === "GET" && /^\/ui\/(backends|poll|history|file\/[^/]+|prompts|instance\/[^/]+|instances|tasks(?:\/[^/]+)?|schedules(?:\/[^/]+)?|teams(?:\/[^/]+)?|config|org|cache)$/.test(path))
         return true;
-    if (method === "POST" && /^\/ui\/(send|upload|prompt|needs\/ack|cancel\/[^/]+|stop\/[^/]+|start\/[^/]+|instances\/[^/]+\/delete|restart\/[^/]+|instances|tasks|schedules|teams|config)$/.test(path))
+    if (method === "POST" && /^\/ui\/(send|upload|prompt|reply-button|command|needs\/ack|cancel\/[^/]+|stop\/[^/]+|start\/[^/]+|instances\/[^/]+\/delete|restart\/[^/]+|instances|tasks|schedules|teams|config)$/.test(path))
         return true;
     if (((method === "POST" && /^\/ui\/tasks\/[^/]+$/.test(path))) || (method === "DELETE" && /^\/ui\/(schedules|teams)\/[^/]+$/.test(path)))
         return true;