@songsid/agend 2.1.11-beta.3 → 2.1.11-beta.5

package/dist/darwin-memory.d.ts

@@ -0,0 +1,34 @@
+import type { HostMemory } from "./host-memory.js";
+export declare const DARWIN_MEMORY_DEADLINE_MS = 2000;
+export declare const DARWIN_MEMORY_CACHE_MS = 30000;
+export declare function unknownDarwinMemory(totalBytes: number): HostMemory;
+/** vm_stat's printed free count excludes speculative pages. Purgeable can overlap inactive. */
+export declare function parseDarwinAvailable(text: string, totalBytes: number): number | null;
+/** sysctl prints binary MiB to two decimals, including the valid unallocated 0/0 pool. */
+export declare function parseDarwinSwap(text: string): Pick<HostMemory, "swapTotalBytes" | "swapFreeBytes">;
+export interface MemoryCommand {
+    result: Promise<string | null>;
+    /** Physical child close, independent of logical timeout/result. */
+    stopped: Promise<void>;
+    kill(): void;
+}
+export type MemoryCommandRunner = (file: string, args: string[]) => MemoryCommand;
+export declare const runMemoryCommand: MemoryCommandRunner;
+interface Options {
+    run?: MemoryCommandRunner;
+    totalmem?: () => number;
+    now?: () => number;
+}
+/** One bounded logical read and at most one physical pair, even across stop/restart. */
+export declare class DarwinMemoryProbe {
+    private readonly run;
+    private readonly total;
+    private readonly now;
+    private flight;
+    private cache;
+    private epoch;
+    constructor(options?: Options);
+    read(): Promise<HostMemory>;
+    stop(): void;
+}
+export {};

package/dist/darwin-memory.js

@@ -0,0 +1,160 @@
+import { execFile } from "node:child_process";
+import { totalmem } from "node:os";
+export const DARWIN_MEMORY_DEADLINE_MS = 2_000;
+export const DARWIN_MEMORY_CACHE_MS = 30_000;
+const MAX_OUTPUT = 32 * 1024;
+export function unknownDarwinMemory(totalBytes) {
+    return { totalBytes, availableBytes: null, availableKind: "unknown", swapTotalBytes: null, swapFreeBytes: null };
+}
+/** vm_stat's printed free count excludes speculative pages. Purgeable can overlap inactive. */
+export function parseDarwinAvailable(text, totalBytes) {
+    const headers = [...text.matchAll(/^Mach Virtual Memory Statistics: \(page size of (\d+) bytes\)\s*$/gm)];
+    if (headers.length !== 1 || [...text.matchAll(/^Mach Virtual Memory Statistics:/gm)].length !== 1)
+        return null;
+    const pageSize = Number(headers[0][1]);
+    if (!Number.isSafeInteger(pageSize) || pageSize < 1024 || pageSize > 1024 * 1024 || Math.log2(pageSize) % 1 !== 0)
+        return null;
+    const counts = [];
+    for (const name of ["free", "speculative", "inactive", "purgeable"]) {
+        const rows = [...text.matchAll(new RegExp(`^Pages ${name}:\\s+(\\d+)\\.\\s*$`, "gm"))];
+        if (rows.length !== 1 || [...text.matchAll(new RegExp(`^Pages ${name}:`, "gm"))].length !== 1)
+            return null;
+        const count = Number(rows[0][1]);
+        if (!Number.isSafeInteger(count) || count < 0)
+            return null;
+        counts.push(count);
+    }
+    const [free, speculative, inactive, purgeable] = counts;
+    const bytes = (free + speculative + Math.max(inactive, purgeable)) * pageSize;
+    return Number.isSafeInteger(bytes) && Number.isFinite(totalBytes) && totalBytes > 0 && bytes <= totalBytes ? bytes : null;
+}
+/** sysctl prints binary MiB to two decimals, including the valid unallocated 0/0 pool. */
+export function parseDarwinSwap(text) {
+    const unknown = { swapTotalBytes: null, swapFreeBytes: null };
+    const rows = [...text.matchAll(/^vm\.swapusage:\s+total = (\d+(?:\.\d+)?)M\s+used = (\d+(?:\.\d+)?)M\s+free = (\d+(?:\.\d+)?)M\s*(?:\(encrypted\))?\s*$/gm)];
+    if (rows.length !== 1)
+        return unknown;
+    const [total, used, free] = rows[0].slice(1).map(Number);
+    if (![total, used, free].every(Number.isFinite) || free > total || used > total || Math.abs(total - used - free) > 0.02)
+        return unknown;
+    const totalBytes = Math.round(total * 1024 ** 2), freeBytes = Math.round(free * 1024 ** 2);
+    if (!Number.isSafeInteger(totalBytes) || !Number.isSafeInteger(freeBytes))
+        return unknown;
+    return { swapTotalBytes: totalBytes, swapFreeBytes: freeBytes };
+}
+export const runMemoryCommand = (file, args) => {
+    let resolveResult;
+    let resolveStopped;
+    const result = new Promise(resolve => { resolveResult = resolve; });
+    const stopped = new Promise(resolve => { resolveStopped = resolve; });
+    try {
+        const child = execFile(file, args, {
+            encoding: "utf8", env: { ...process.env, LC_ALL: "C", LANG: "C" },
+            timeout: 1_500, killSignal: "SIGKILL", maxBuffer: MAX_OUTPUT,
+        }, (error, stdout) => resolveResult(error ? null : stdout));
+        child.once("close", resolveStopped);
+        // A spawn error normally also emits close. Keep the physical reservation until then.
+        child.once("error", () => resolveResult(null));
+        return { result, stopped, kill: () => { try {
+                child.kill("SIGKILL");
+            }
+            catch { /* wait for close */ } } };
+    }
+    catch {
+        resolveResult(null);
+        resolveStopped();
+        return { result, stopped, kill: () => { } };
+    }
+};
+/** One bounded logical read and at most one physical pair, even across stop/restart. */
+export class DarwinMemoryProbe {
+    run;
+    total;
+    now;
+    flight = null;
+    cache = null;
+    epoch = 0;
+    constructor(options = {}) {
+        this.run = options.run ?? runMemoryCommand;
+        this.total = options.totalmem ?? totalmem;
+        this.now = options.now ?? (() => performance.now());
+    }
+    read() {
+        if (this.cache && this.now() - this.cache.at < DARWIN_MEMORY_CACHE_MS)
+            return Promise.resolve({ ...this.cache.memory });
+        // A timed-out or cancelled pair still owns its physical reservation.
+        if (this.flight) {
+            const flight = this.flight;
+            if (flight.completed)
+                return Promise.resolve(unknownDarwinMemory(this.total()));
+            return flight.result.then(value => flight.epoch === this.epoch ? { ...value } : unknownDarwinMemory(this.total()));
+        }
+        const epoch = ++this.epoch, totalBytes = this.total(), deadlineAt = this.now() + DARWIN_MEMORY_DEADLINE_MS;
+        const unknown = unknownDarwinMemory(totalBytes);
+        const commands = [];
+        let settle;
+        let completed = false;
+        let timer = null;
+        const result = new Promise(resolve => { settle = resolve; });
+        const finish = (value) => {
+            if (completed)
+                return;
+            completed = true;
+            flight.completed = true;
+            if (timer)
+                clearTimeout(timer);
+            if (epoch === this.epoch)
+                this.cache = { at: this.now(), memory: { ...value } };
+            settle(value);
+        };
+        const cancel = () => {
+            finish(unknown);
+            for (const command of commands) {
+                try {
+                    command.kill();
+                }
+                catch { /* retain until close */ }
+            }
+        };
+        const flight = { completed: false, epoch, result, cancel };
+        this.flight = flight;
+        // Start the deadline before either constructor; a slow constructor cannot earn extra time.
+        timer = setTimeout(cancel, DARWIN_MEMORY_DEADLINE_MS);
+        timer.unref?.();
+        for (const [file, args] of [["/usr/bin/vm_stat", []], ["/usr/sbin/sysctl", ["vm.swapusage"]]]) {
+            if (this.now() >= deadlineAt) {
+                cancel();
+                break;
+            }
+            try {
+                commands.push(this.run(file, [...args]));
+            }
+            catch {
+                commands.push({ result: Promise.resolve(null), stopped: Promise.resolve(), kill: () => { } });
+            }
+        }
+        void Promise.all(commands.map(command => command.result.catch(() => null))).then(outputs => {
+            if (completed)
+                return;
+            if (epoch !== this.epoch || this.now() >= deadlineAt) {
+                cancel();
+                return;
+            }
+            const available = outputs[0] === null || outputs[0] === undefined ? null : parseDarwinAvailable(outputs[0], totalBytes);
+            finish(available === null ? unknown : { totalBytes, availableBytes: available, availableKind: "available",
+                ...parseDarwinSwap(outputs[1] ?? "") });
+        });
+        // Never release on kill request/result alone. Rejected cleanup remains reserved.
+        void Promise.all(commands.map(command => command.stopped.catch(() => new Promise(() => { })))).then(() => {
+            if (this.flight === flight)
+                this.flight = null;
+        });
+        return result.then(value => ({ ...value }));
+    }
+    stop() {
+        this.epoch++;
+        this.cache = null;
+        this.flight?.cancel();
+    }
+}
+//# sourceMappingURL=darwin-memory.js.map

package/dist/darwin-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"darwin-memory.js","sourceRoot":"","sources":["../src/darwin-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAC/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC7C,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7B,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;AACnH,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,UAAkB;IACnE,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,qEAAqE,CAAC,CAAC,CAAC;IAC1G,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/G,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,IAAI,IAAI,QAAQ,GAAG,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/H,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,UAAU,IAAI,qBAAqB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACvF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,UAAU,IAAI,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3G,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,GAAG,MAAM,CAAC;IACxD,MAAM,KAAK,GAAG,CAAC,IAAI,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,GAAG,QAAQ,CAAC;IAC9E,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,IAAI,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5H,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAC9D,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,2HAA2H,CAAC,CAAC,CAAC;IAC7J,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACtC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI;QAAE,OAAO,OAAO,CAAC;IACxI,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC;IAC3F,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC;QAAE,OAAO,OAAO,CAAC;IAC1F,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AAClE,CAAC;AAUD,MAAM,CAAC,MAAM,gBAAgB,GAAwB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;IAClE,IAAI,aAA8C,CAAC;IACnD,IAAI,cAA2B,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,OAAO,CAAgB,OAAO,CAAC,EAAE,GAAG,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,GAAG,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE;YACjC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE;YACjE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU;SAC7D,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACpC,qFAAqF;QACrF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;gBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5G,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,CAAC,IAAI,CAAC,CAAC;QAAC,cAAc,EAAE,CAAC;QACtC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAC7C,CAAC;AACH,CAAC,CAAC;AAcF,wFAAwF;AACxF,MAAM,OAAO,iBAAiB;IACX,GAAG,CAAsB;IACzB,KAAK,CAAe;IACpB,GAAG,CAAe;IAC3B,MAAM,GAAkB,IAAI,CAAC;IAC7B,KAAK,GAA8C,IAAI,CAAC;IACxD,KAAK,GAAG,CAAC,CAAC;IAElB,YAAY,UAAmB,EAAE;QAC/B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,gBAAgB,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC;QAC1C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,sBAAsB;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACxH,qEAAqE;QACrE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC3B,IAAI,MAAM,CAAC,SAAS;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAChF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACrH,CAAC;QACD,MAAM,KAAK,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,EAAE,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,yBAAyB,CAAC;QAC3G,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,IAAI,MAAoC,CAAC;QACzC,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,KAAK,GAAyC,IAAI,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,OAAO,CAAa,OAAO,CAAC,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,CAAC,KAAiB,EAAE,EAAE;YACnC,IAAI,SAAS;gBAAE,OAAO;YACtB,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;YACxB,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,KAAK,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC;YAChF,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,MAAM,CAAC,OAAO,CAAC,CAAC;YAChB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAAC,IAAI,CAAC;oBAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,wBAAwB,CAAC,CAAC;YAAC,CAAC;QAChG,CAAC,CAAC;QACF,MAAM,MAAM,GAAW,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACnE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,2FAA2F;QAC3F,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;QACtD,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,EAAE,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,cAAc,CAAC,CAAC,CAAU,EAAE,CAAC;YACvG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,UAAU,EAAE,CAAC;gBAAC,MAAM,EAAE,CAAC;gBAAC,MAAM;YAAC,CAAC;YAClD,IAAI,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC;YACjD,MAAM,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAC;YAAC,CAAC;QACzG,CAAC;QACD,KAAK,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YACzF,IAAI,SAAS;gBAAE,OAAO;YACtB,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,UAAU,EAAE,CAAC;gBAAC,MAAM,EAAE,CAAC;gBAAC,OAAO;YAAC,CAAC;YAC3E,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACxH,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW;gBACvG,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,iFAAiF;QACjF,KAAK,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,OAAO,CAAO,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAC5G,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;gBAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACjD,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/fleet-manager.d.ts

@@ -955,6 +955,11 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     };
     /** Start the primary adapter (backward-compatible, sets this.adapter) */
     private startSingleAdapter;
+    /**
+     * Register a Telegram connection's command menus; any other kind of channel has none to register. Started, not
+     * awaited: a slow api.telegram.org must never hold up the adapter's login (each call has its own timeout). Never fatal.
+     */
+    private registerTelegramCommandsFor;
     /** Start an additional (non-primary) adapter */
     private startAdditionalAdapter;
     /** Connect IPC to a single instance with all handlers */
@@ -2131,6 +2136,11 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private effortSuffix;
     /** Read recent chat log for agent context */
     private getRecentChatLog;
+    /**
+     * The ClassicBot /start replies say how to talk to the agent, and that differs by platform (#1196): on Telegram
+     * you @mention the bot; on Discord, @mention or `/chat`. The chat's platform is the adapter it came through.
+     */
+    private classicStartKey;
     /** Return a user-facing blocker without mutating ClassicBot state. */
     private validateClassicStart;
     private isBackendInstalled;

package/dist/fleet-manager.js

@@ -988,6 +988,10 @@ export class FleetManager {
             this.logger.debug({ hostMemory: snapshot }, "Host memory sample");
         }
         const changed = snapshot.level !== this.memoryLogLevel;
+        if (this.memoryPressure.allowsUnknown(snapshot)) {
+            this.memoryLogLevel = snapshot.level;
+            return;
+        }
         if (snapshot.level === "normal") {
             if (this.memoryLogLevel === "critical" || this.memoryLogLevel === "elevated") {
                 this.logger.info({ hostMemory: snapshot }, "Host memory recovered");
@@ -2790,10 +2794,8 @@ export class FleetManager {
         // it before lifecycle.start() can turn a crash-loop daemon's dead pane into
         // a falsely running instance when lifecycle.start() returns early.
         this.instanceProcessStatus.delete(name);
-        try {
-            unlinkSync(join(this.getInstanceDir(name), "crash-state.json"));
-        }
-        catch { /* consumed or absent */ }
+        // Recovery intent belongs to Daemon.start. lifecycle.start can return
+        // before reaching it, so an await here is not proof the marker was read.
         // Auto-connect IPC — daemon.start() ensures socket is ready before resolving
         await this.connectIpcToInstance(name);
         this.requestDiscordUsagePresenceRefresh();
@@ -4513,7 +4515,8 @@ export class FleetManager {
                 return;
             await this.dispatchSlash(data, adapterId, adapter);
         }, this.logger, "adapter.slash_command"));
-        await this.topicCommands.registerBotCommands().catch(e => this.logger.warn({ err: e }, "registerBotCommands failed (non-fatal)"));
+        // This adapter's own Telegram menus — each Telegram adapter registers its own when it starts (#1191).
+        this.registerTelegramCommandsFor(channelConfig);
         // Background-probe each backend's CLI env (version/models) → cli-env cache.
         // Non-blocking: /model & status views read the cache; never delays startup.
         this.probeCliEnvs();
@@ -4568,6 +4571,15 @@ export class FleetManager {
             this.pruneStaleExternalSessions().catch(err => this.logger.debug({ err }, "Session prune failed"));
         }, 5 * 60 * 1000);
     }
+    /**
+     * Register a Telegram connection's command menus; any other kind of channel has none to register. Started, not
+     * awaited: a slow api.telegram.org must never hold up the adapter's login (each call has its own timeout). Never fatal.
+     */
+    registerTelegramCommandsFor(channelConfig) {
+        if (channelConfig.type !== "telegram")
+            return;
+        void this.topicCommands.registerBotCommands(channelConfig).catch(e => this.logger.warn({ err: e, adapterId: channelConfig.id ?? channelConfig.type }, "registerBotCommands failed (non-fatal)"));
+    }
     /** Start an additional (non-primary) adapter */
     async startAdditionalAdapter(channelConfig, registerCommands = true, onStarted) {
         const adapterId = channelConfig.id ?? channelConfig.type;
@@ -4643,6 +4655,9 @@ export class FleetManager {
             this.logger.error({ err, adapterId }, "Additional adapter fatal error");
             this.restartAdapter(adapter, adapterId).catch(() => { });
         });
+        // A secondary Telegram connection (a ClassicBot next to a Discord fleet, say) has menus of its own to register —
+        // at fleet start, on retry, and when Settings rebinds it or rotates its token: all of them start it here (#1191).
+        this.registerTelegramCommandsFor(channelConfig);
         // Register lifecycle listeners before login; a fast ready/error must not be lost.
         await adapter.start();
         if (channelConfig.group_id) {
@@ -11919,6 +11934,14 @@ Plus the operational skills (fleet-health, instance-lifecycle, scheduling, sessi
             return undefined;
         }
     }
+    /**
+     * The ClassicBot /start replies say how to talk to the agent, and that differs by platform (#1196): on Telegram
+     * you @mention the bot; on Discord, @mention or `/chat`. The chat's platform is the adapter it came through.
+     */
+    classicStartKey(key, adapterId) {
+        const adapter = (adapterId ? this.worlds.get(adapterId)?.adapter : undefined) ?? this.adapter;
+        return adapter?.type === "telegram" ? `${key}.telegram` : key;
+    }
     /** Return a user-facing blocker without mutating ClassicBot state. */
     validateClassicStart(channelId, userId, guildId, adapterId) {
         if (!this.classicChannels)
@@ -11940,7 +11963,7 @@ Plus the operational skills (fleet-health, instance-lifecycle, scheduling, sessi
             return t("classic.not_authorized_guild");
         }
         if (this.classicChannels.isClassicChannel(channelId, adapterId))
-            return t("classic.already_active");
+            return t(this.classicStartKey("classic.already_active", adapterId));
         if (this.routing.resolve(channelId))
             return t("classic.topic_bound");
         return undefined;
@@ -12127,7 +12150,7 @@ Plus the operational skills (fleet-health, instance-lifecycle, scheduling, sessi
             classicChannels.toggleCollab(channelId, adapterId);
         }
         this.logger.info({ channelId, adapterId, instanceName, userId }, "Classic channel started");
-        return t("classic.started");
+        return t(this.classicStartKey("classic.started", adapterId));
     }
     /** Handle /stop slash command — unregister classic channel */
     async handleClassicStop(channelId, adapterId) {