@songsid/agend 2.1.4-beta.2 → 2.1.4-beta.20

package/dist/doctor.d.ts

@@ -0,0 +1,26 @@
+import { type SpawnSyncReturns } from "node:child_process";
+import type { ServiceInfo } from "./service-installer.js";
+export type DoctorCheckStatus = "ok" | "warn" | "error";
+export interface DoctorCheck {
+    section: "Prerequisites" | "Service" | "Fleet" | "MCP IPC";
+    status: DoctorCheckStatus;
+    label: string;
+    detail: string;
+}
+export interface DoctorReport {
+    checks: DoctorCheck[];
+    errors: number;
+    warnings: number;
+}
+interface DoctorDeps {
+    env: NodeJS.ProcessEnv;
+    platform: NodeJS.Platform;
+    run: (file: string, args: string[]) => SpawnSyncReturns<string>;
+    processAlive: (pid: number) => boolean;
+    connectSocket: (path: string) => Promise<boolean>;
+}
+export declare function connectUnixSocket(path: string, timeoutMs?: number): Promise<boolean>;
+/** Collect read-only diagnostics. Dependencies are injectable for deterministic tests. */
+export declare function collectDoctorReport(dataDir: string, service: ServiceInfo, overrides?: Partial<DoctorDeps>): Promise<DoctorReport>;
+export declare function formatDoctorReport(report: DoctorReport): string;
+export {};

package/dist/doctor.js

@@ -0,0 +1,216 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { platform } from "node:os";
+import { spawnSync } from "node:child_process";
+import net from "node:net";
+import { loadRawFleetConfig } from "./config.js";
+import { hasPausedMarker } from "./pause-marker.js";
+import { getTmuxSessionName, getTmuxSocketName } from "./paths.js";
+import { BACKENDS } from "./setup-wizard.js";
+import { t } from "./locale.js";
+const defaultDeps = {
+    env: process.env,
+    platform: platform(),
+    run: (file, args) => spawnSync(file, args, { encoding: "utf8", timeout: 5000 }),
+    processAlive: pid => {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    connectSocket: connectUnixSocket,
+};
+function tmuxArgs(args) {
+    const socket = getTmuxSocketName();
+    return socket ? ["-L", socket, ...args] : args;
+}
+function readPid(path) {
+    try {
+        const pid = Number.parseInt(readFileSync(path, "utf8").trim(), 10);
+        return Number.isInteger(pid) && pid > 0 ? pid : null;
+    }
+    catch {
+        return null;
+    }
+}
+function hasCrashLoop(dataDir, name) {
+    try {
+        const value = JSON.parse(readFileSync(join(dataDir, "instances", name, "crash-state.json"), "utf8"));
+        return Number(value?.crashesInWindow) >= 3;
+    }
+    catch {
+        return false;
+    }
+}
+export async function connectUnixSocket(path, timeoutMs = 1000) {
+    if (!existsSync(path))
+        return false;
+    return new Promise(resolve => {
+        const client = net.createConnection(path);
+        let settled = false;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            client.destroy();
+            resolve(value);
+        };
+        const timer = setTimeout(() => finish(false), timeoutMs);
+        timer.unref?.();
+        client.once("connect", () => finish(true));
+        client.once("error", () => finish(false));
+    });
+}
+/** Collect read-only diagnostics. Dependencies are injectable for deterministic tests. */
+export async function collectDoctorReport(dataDir, service, overrides = {}) {
+    const deps = { ...defaultDeps, ...overrides };
+    const checks = [];
+    const add = (section, status, label, detail) => {
+        checks.push({ section, status, label, detail });
+    };
+    const configPath = join(dataDir, "fleet.yaml");
+    let raw = {};
+    try {
+        raw = loadRawFleetConfig(configPath);
+    }
+    catch (err) {
+        add("Fleet", "error", "fleet.yaml", t("doctor.config_invalid", err.message.split("\n")[0]));
+    }
+    const defaultBackend = raw.defaults?.backend ?? "claude-code";
+    const backendIds = new Set([defaultBackend]);
+    for (const config of Object.values(raw.instances ?? {})) {
+        backendIds.add(config.backend ?? defaultBackend);
+    }
+    for (const id of backendIds) {
+        // `mock` is an in-process test backend and deliberately has no CLI binary.
+        if (id === "mock")
+            continue;
+        const backend = BACKENDS.find(item => item.id === id);
+        if (!backend) {
+            add("Prerequisites", "error", t("doctor.backend_label", id), t("doctor.backend_unknown"));
+            continue;
+        }
+        const result = deps.run(backend.binary, ["--version"]);
+        const version = String(result.stdout ?? "").trim().split("\n")[0];
+        if (!result.error && result.status === 0) {
+            add("Prerequisites", "ok", backend.label, version || t("doctor.binary_available", backend.binary));
+        }
+        else {
+            add("Prerequisites", "error", backend.label, t("doctor.binary_missing", backend.binary));
+        }
+    }
+    const tmuxVersion = deps.run("tmux", ["-V"]);
+    const tmuxAvailable = !tmuxVersion.error && tmuxVersion.status === 0;
+    add("Prerequisites", tmuxAvailable ? "ok" : "error", "tmux", tmuxAvailable ? String(tmuxVersion.stdout ?? "").trim() : t("doctor.not_found"));
+    add("Prerequisites", deps.env.TERM ? "ok" : "warn", "TERM", deps.env.TERM || t("doctor.term_unset"));
+    if (!service.installed) {
+        add("Service", "warn", t("doctor.service_installed"), t("doctor.service_none"));
+    }
+    else {
+        const managerUnavailable = service.manager === "systemd --user"
+            ? t("doctor.manager_user_unavailable")
+            : t("doctor.manager_unavailable");
+        add("Service", "ok", t("doctor.service_installed"), `${service.manager}: ${service.path}`);
+        add("Service", service.enabled === true ? "ok" : "warn", t("doctor.service_enabled"), service.enabled == null ? managerUnavailable : service.enabled ? t("doctor.yes") : t("doctor.no_install"));
+        add("Service", service.active === true ? "ok" : "warn", t("doctor.service_active"), service.active == null ? managerUnavailable : service.active ? t("doctor.service_running") : t("doctor.inactive_start"));
+    }
+    if (deps.platform === "linux") {
+        add("Service", deps.env.DBUS_SESSION_BUS_ADDRESS ? "ok" : "warn", "D-Bus", deps.env.DBUS_SESSION_BUS_ADDRESS
+            ? t("doctor.dbus_set")
+            : t("doctor.dbus_unset"));
+    }
+    const fleetPidPath = join(dataDir, "fleet.pid");
+    const fleetPid = readPid(fleetPidPath);
+    const fleetAlive = fleetPid != null && deps.processAlive(fleetPid);
+    if (!existsSync(fleetPidPath)) {
+        add("Fleet", "warn", t("doctor.fleet_process"), t("doctor.pid_missing"));
+    }
+    else if (fleetPid == null) {
+        add("Fleet", "error", t("doctor.fleet_process"), t("doctor.pid_invalid"));
+    }
+    else if (!fleetAlive) {
+        add("Fleet", "error", t("doctor.fleet_process"), t("doctor.pid_stale", fleetPid));
+    }
+    else {
+        add("Fleet", "ok", t("doctor.fleet_process"), t("doctor.pid_alive", fleetPid));
+    }
+    const sessionName = getTmuxSessionName();
+    const tmuxSession = tmuxAvailable
+        ? deps.run("tmux", tmuxArgs(["has-session", "-t", sessionName]))
+        : null;
+    const sessionAlive = !!tmuxSession && !tmuxSession.error && tmuxSession.status === 0;
+    add("Fleet", sessionAlive ? "ok" : fleetAlive ? "error" : "warn", t("doctor.tmux_session"), sessionAlive ? t("doctor.session_exists", sessionName) : t("doctor.session_missing", sessionName));
+    if (!existsSync(configPath)) {
+        add("Fleet", "warn", t("doctor.instances"), t("doctor.config_missing", configPath));
+    }
+    const names = Object.keys(raw.instances ?? {});
+    const counts = { running: 0, paused: 0, stopped: 0, crashed: 0 };
+    const runningNames = [];
+    for (const name of names) {
+        const instanceDir = join(dataDir, "instances", name);
+        if (hasPausedMarker(instanceDir)) {
+            counts.paused++;
+            continue;
+        }
+        if (hasCrashLoop(dataDir, name)) {
+            counts.crashed++;
+            continue;
+        }
+        const pid = readPid(join(instanceDir, "daemon.pid"));
+        if (pid != null && deps.processAlive(pid)) {
+            counts.running++;
+            runningNames.push(name);
+        }
+        else {
+            counts.stopped++;
+        }
+    }
+    add("Fleet", "ok", t("doctor.instances"), t("doctor.instance_counts", counts.running, counts.paused, counts.stopped, counts.crashed, names.length));
+    const ipcResults = await Promise.all(runningNames.map(async (name) => {
+        const socketPath = join(dataDir, "instances", name, "channel.sock");
+        return { name, socketPath, exists: existsSync(socketPath), connected: await deps.connectSocket(socketPath) };
+    }));
+    const connected = ipcResults.filter(result => result.connected).length;
+    const missing = ipcResults.filter(result => !result.exists).map(result => result.name);
+    const unreachable = ipcResults.filter(result => result.exists && !result.connected).map(result => result.name);
+    const ipcProblems = [...missing, ...unreachable];
+    add("MCP IPC", ipcProblems.length === 0 ? "ok" : "error", "channel.sock", ipcProblems.length === 0
+        ? t("doctor.ipc_ok", connected, runningNames.length)
+        : t("doctor.ipc_failed", connected, runningNames.length, ipcProblems.join(", ")));
+    return {
+        checks,
+        errors: checks.filter(check => check.status === "error").length,
+        warnings: checks.filter(check => check.status === "warn").length,
+    };
+}
+export function formatDoctorReport(report) {
+    const sectionLabels = {
+        Prerequisites: t("doctor.section.prerequisites"),
+        Service: t("doctor.section.service"),
+        Fleet: t("doctor.section.fleet"),
+        "MCP IPC": t("doctor.section.ipc"),
+    };
+    const lines = ["", `  \x1b[1m${t("doctor.title")}\x1b[0m`];
+    let section;
+    for (const check of report.checks) {
+        if (check.section !== section) {
+            section = check.section;
+            lines.push("", `  \x1b[1m${sectionLabels[section]}\x1b[0m`);
+        }
+        const icon = check.status === "ok"
+            ? "\x1b[32m✓\x1b[0m"
+            : check.status === "warn"
+                ? "\x1b[33m⚠\x1b[0m"
+                : "\x1b[31m✗\x1b[0m";
+        lines.push(`  ${icon} ${check.label}: ${check.detail}`);
+    }
+    lines.push("", report.errors === 0
+        ? `  \x1b[32m✓ ${t("doctor.complete", report.warnings)}\x1b[0m`
+        : `  \x1b[31m✗ ${t("doctor.errors", report.errors, report.warnings)}\x1b[0m`, "");
+    return lines.join("\n");
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,SAAS,EAAyB,MAAM,oBAAoB,CAAC;AACtE,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAE,CAAC,EAAE,MAAM,aAAa,CAAC;AAyBhC,MAAM,WAAW,GAAe;IAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,QAAQ,EAAE,QAAQ,EAAE;IACpB,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC/E,YAAY,EAAE,GAAG,CAAC,EAAE;QAClB,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,aAAa,EAAE,iBAAiB;CACjC,CAAC;AAEF,SAAS,QAAQ,CAAC,IAAc;IAC9B,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACnE,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,IAAY;IACjD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACrG,OAAO,MAAM,CAAC,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,SAAS,GAAG,IAAI;IACpE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,EAAE;YAChC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;QACzD,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAe,EACf,OAAoB,EACpB,YAAiC,EAAE;IAEnC,MAAM,IAAI,GAAG,EAAE,GAAG,WAAW,EAAE,GAAG,SAAS,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,CAAC,OAA+B,EAAE,MAAyB,EAAE,KAAa,EAAE,MAAc,EAAE,EAAE;QACxG,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC/C,IAAI,GAAG,GAA0C,EAAE,CAAC;IACpD,IAAI,CAAC;QACH,GAAG,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,uBAAuB,EAAG,GAAa,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzG,CAAC;IAED,MAAM,cAAc,GAAG,GAAG,CAAC,QAAQ,EAAE,OAAO,IAAI,aAAa,CAAC;IAC9D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,CAAC,cAAc,CAAC,CAAC,CAAC;IACrD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC;IACnD,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,2EAA2E;QAC3E,IAAI,EAAE,KAAK,MAAM;YAAE,SAAS;QAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,GAAG,CAAC,eAAe,EAAE,OAAO,EAAE,CAAC,CAAC,sBAAsB,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC;YAC1F,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,CAAC,yBAAyB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACrG,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,uBAAuB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,aAAa,GAAG,CAAC,WAAW,CAAC,KAAK,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC;IACrE,GAAG,CACD,eAAe,EACf,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAC9B,MAAM,EACN,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAChF,CAAC;IACF,GAAG,CACD,eAAe,EACf,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAC7B,MAAM,EACN,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,mBAAmB,CAAC,CACxC,CAAC;IAEF,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAClF,CAAC;SAAM,CAAC;QACN,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,KAAK,gBAAgB;YAC7D,CAAC,CAAC,CAAC,CAAC,iCAAiC,CAAC;YACtC,CAAC,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC;QACpC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,0BAA0B,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3F,GAAG,CACD,SAAS,EACT,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EACxC,CAAC,CAAC,wBAAwB,CAAC,EAC3B,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAC1G,CAAC;QACF,GAAG,CACD,SAAS,EACT,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EACvC,CAAC,CAAC,uBAAuB,CAAC,EAC1B,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CACxH,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC9B,GAAG,CACD,SAAS,EACT,IAAI,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EACjD,OAAO,EACP,IAAI,CAAC,GAAG,CAAC,wBAAwB;YAC/B,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC;YACtB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAC3B,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,QAAQ,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACnE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC3E,CAAC;SAAM,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QAC5B,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC5E,CAAC;SAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACvB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpF,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,aAAa;QAC/B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,aAAa,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;QAChE,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC;IACrF,GAAG,CACD,OAAO,EACP,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EACnD,CAAC,CAAC,qBAAqB,CAAC,EACxB,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB,EAAE,WAAW,CAAC,CAClG,CAAC;IAEF,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACjE,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QACrD,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,MAAM,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;QACrD,IAAI,GAAG,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IACD,GAAG,CACD,OAAO,EACP,IAAI,EACJ,CAAC,CAAC,kBAAkB,CAAC,EACrB,CAAC,CAAC,wBAAwB,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CACzG,CAAC;IAEF,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAC,IAAI,EAAC,EAAE;QACjE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACpE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;IAC/G,CAAC,CAAC,CAAC,CAAC;IACJ,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;IACvE,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvF,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/G,MAAM,WAAW,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,WAAW,CAAC,CAAC;IACjD,GAAG,CACD,SAAS,EACT,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EACzC,cAAc,EACd,WAAW,CAAC,MAAM,KAAK,CAAC;QACtB,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC;QACpD,CAAC,CAAC,CAAC,CAAC,mBAAmB,EAAE,SAAS,EAAE,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CACnF,CAAC;IAEF,OAAO;QACL,MAAM;QACN,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM;QAC/D,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;KACjE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,MAAM,aAAa,GAA2C;QAC5D,aAAa,EAAE,CAAC,CAAC,8BAA8B,CAAC;QAChD,OAAO,EAAE,CAAC,CAAC,wBAAwB,CAAC;QACpC,KAAK,EAAE,CAAC,CAAC,sBAAsB,CAAC;QAChC,SAAS,EAAE,CAAC,CAAC,oBAAoB,CAAC;KACnC,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC3D,IAAI,OAA2C,CAAC;IAChD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC9B,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,KAAK,IAAI;YAChC,CAAC,CAAC,kBAAkB;YACpB,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM;gBACvB,CAAC,CAAC,kBAAkB;gBACpB,CAAC,CAAC,kBAAkB,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,KAAK,CAAC,IAAI,CACR,EAAE,EACF,MAAM,CAAC,MAAM,KAAK,CAAC;QACjB,CAAC,CAAC,eAAe,CAAC,CAAC,iBAAiB,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS;QAC/D,CAAC,CAAC,eAAe,CAAC,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,EAC9E,EAAE,CACH,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/fleet-context.d.ts

@@ -54,6 +54,10 @@ export interface FleetContext {
     readonly classicChannels: ClassicChannelManager | null;
     getSysInfo(): SysInfo;
     getInstanceStatus(name: string): "running" | "paused" | "stopped" | "crashed";
+    /** Current cancellation epoch stamped onto direct daemon IPC deliveries. */
+    getDeliveryEpoch?(name: string): number;
+    /** Subscription provider IDs used by running or paused fleet/Classic instances. */
+    getActiveUsageProviderIds?(): ReadonlySet<string>;
     toggleFleetCollab(instanceName: string): boolean;
     /** Apply a model to an instance (runtime paste or persist + restart). Returns a status string. */
     applyModel(instanceName: string, model: string): Promise<string>;
@@ -80,6 +84,11 @@ export interface FleetContext {
         ready: boolean;
         token: string | null;
     };
+    /** Persist and edit one `/update` message across the fleet process restart. */
+    beginUpdateProgress?(adapter: import("./channel/types.js").ChannelAdapter, chatId: string, threadId: string | undefined, messageId: string): void;
+    failUpdateProgress?(message: string): void;
+    /** Post one random, not-yet-dismissed tip with a dismiss button. */
+    promptTip?(generalName: string, adapter: import("./channel/types.js").ChannelAdapter, chatId: string, threadId?: string): Promise<"posted" | "empty" | "unavailable">;
     /** Human-readable effective model for an instance (resolves inherited defaults). */
     modelDisplayForInstance?(name: string): string;
     /**
@@ -97,4 +106,9 @@ export interface FleetContext {
     applyEffort?(instanceName: string, level: string): Promise<string>;
     /** TG inline-keyboard effort menu; same contract as promptModelMenu. */
     promptEffortMenu?(instanceName: string, userId: string, channelId: string, adapter: import("./channel/types.js").ChannelAdapter, chatId: string, threadId?: string): Promise<string | null>;
+    /**
+     * Post a nonce-armed confirmation before the destructive `/clear` command.
+     * Returns null when the buttons were posted, otherwise a user-facing error.
+     */
+    promptClearConfirmation?(instanceName: string, channelId: string, adapter: import("./channel/types.js").ChannelAdapter, chatId: string, threadId?: string): Promise<string | null>;
 }