botmux 3.10.0 → 3.23.1

package/dist/core/local-terminal-opener.js

@@ -1,230 +0,0 @@
-import { spawn, spawnSync } from 'node:child_process';
-import { homedir } from 'node:os';
-import { delimiter } from 'node:path';
-import { getBot } from '../bot-registry.js';
-import { createCliAdapterSync } from '../adapters/cli/registry.js';
-import { buildWrappedLaunch, decorateResumeForWrapper, parseWrapperCli } from '../setup/cli-selection.js';
-import { stripPm2GracefulExitMarker } from '../pm2-graceful-exit.js';
-function shellQuote(value) {
-    return `'${value.replace(/'/g, `'\\''`)}'`;
-}
-function onPath(bin) {
-    if (bin.includes('/'))
-        return spawnSync('test', ['-x', bin]).status === 0;
-    const paths = (process.env.PATH || '').split(delimiter).filter(Boolean);
-    if (paths.some(dir => spawnSync('test', ['-x', `${dir}/${bin}`]).status === 0))
-        return true;
-    const shell = process.env.SHELL || '/bin/zsh';
-    const result = spawnSync(shell, ['-lc', `command -v ${shellQuote(bin)}`], {
-        encoding: 'utf8',
-        timeout: 3000,
-        stdio: ['ignore', 'pipe', 'ignore'],
-    });
-    return result.status === 0 && (result.stdout ?? '').trim().length > 0;
-}
-function effectiveCliConfig(ds) {
-    let botCfg;
-    try {
-        botCfg = getBot(ds.larkAppId).config;
-    }
-    catch { /* tests / deregistered bot */ }
-    return {
-        cliId: (ds.session.cliId ?? ds.initConfig?.cliId ?? botCfg?.cliId ?? 'claude-code'),
-        cliPathOverride: ds.session.cliPathOverride ?? ds.initConfig?.cliPathOverride ?? botCfg?.cliPathOverride,
-        wrapperCli: ds.session.wrapperCli ?? ds.initConfig?.wrapperCli ?? botCfg?.wrapperCli,
-        model: ds.session.model ?? ds.initConfig?.model ?? botCfg?.model,
-    };
-}
-function isCodexFamily(cliId) {
-    return cliId === 'codex' || cliId === 'codex-app';
-}
-function defaultLocalExecutable(cliId, adapterResolvedBin, cliPathOverride) {
-    if (cliPathOverride?.trim())
-        return cliPathOverride.trim();
-    if (cliId === 'codex-app')
-        return 'codex';
-    if (cliId === 'mira')
-        return null;
-    if (cliId === 'mir')
-        return 'mircli';
-    return adapterResolvedBin;
-}
-function replaceFirstToken(command, executable) {
-    const rest = command.trim().replace(/^\S+/, '').trimStart();
-    return rest ? `${shellQuote(executable)} ${rest}` : shellQuote(executable);
-}
-function shellJoin(parts) {
-    return parts.map(shellQuote).join(' ');
-}
-function commandForWrapperLaunch(wrapperCli, args, model) {
-    const tokens = parseWrapperCli(wrapperCli);
-    const launch = buildWrappedLaunch(wrapperCli, args, (bin) => bin, { ttadkModel: model });
-    return {
-        command: shellJoin([launch.bin, ...launch.args]),
-        executable: tokens[0] ?? launch.bin,
-    };
-}
-function appleScriptString(value) {
-    return JSON.stringify(value);
-}
-export function localCliCommandForSession(ds) {
-    const cfg = effectiveCliConfig(ds);
-    const cwd = ds.workingDir || ds.session.workingDir || ds.adoptedFrom?.cwd || homedir();
-    const cd = `cd ${shellQuote(cwd)}`;
-    let adapter;
-    try {
-        adapter = createCliAdapterSync(cfg.cliId, cfg.cliPathOverride);
-    }
-    catch (err) {
-        return { ok: false, error: 'adapter_error', cliId: cfg.cliId, detail: err instanceof Error ? err.message : String(err) };
-    }
-    const rawResume = adapter.buildResumeCommand?.({
-        sessionId: ds.session.sessionId,
-        cliSessionId: ds.session.cliSessionId,
-    }) ?? null;
-    if (rawResume) {
-        const decorated = decorateResumeForWrapper(rawResume, cfg.wrapperCli, { ttadkModel: cfg.model });
-        if (cfg.wrapperCli?.trim()) {
-            const executable = parseWrapperCli(cfg.wrapperCli)[0];
-            if (!executable || !onPath(executable)) {
-                return { ok: false, error: 'cli_unavailable', cliId: cfg.cliId, executable };
-            }
-            return { ok: true, mode: 'resume', executable, command: `${cd} && exec ${decorated}` };
-        }
-        const executable = defaultLocalExecutable(cfg.cliId, adapter.resolvedBin, cfg.cliPathOverride);
-        if (!executable || !onPath(executable)) {
-            return { ok: false, error: 'cli_unavailable', cliId: cfg.cliId, executable: executable ?? cfg.cliId };
-        }
-        return { ok: true, mode: 'resume', executable, command: `${cd} && exec ${replaceFirstToken(rawResume, executable)}` };
-    }
-    if (cfg.wrapperCli?.trim()) {
-        const { command, executable } = commandForWrapperLaunch(cfg.wrapperCli, [], cfg.model);
-        if (!executable || !onPath(executable)) {
-            return { ok: false, error: 'cli_unavailable', cliId: cfg.cliId, executable };
-        }
-        return { ok: true, mode: 'launch', executable, command: `${cd} && exec ${command}` };
-    }
-    const executable = defaultLocalExecutable(cfg.cliId, adapter.resolvedBin, cfg.cliPathOverride);
-    if (!executable) {
-        return { ok: false, error: 'resume_unavailable', cliId: cfg.cliId };
-    }
-    if (!onPath(executable)) {
-        return { ok: false, error: 'cli_unavailable', cliId: cfg.cliId, executable };
-    }
-    return { ok: true, mode: 'launch', executable, command: `${cd} && exec ${shellQuote(executable)}` };
-}
-function spawnDetached(command, args) {
-    try {
-        // Strip the daemon's graceful-exit sentinel: the launched terminal runs a
-        // login shell → local AI CLI that could itself start a foreground botmux,
-        // which would then exit 90 on a clean stop (a supervisor reads that as a
-        // crash). Only the PM2-managed cores may carry the marker.
-        const child = spawn(command, args, {
-            detached: true,
-            stdio: 'ignore',
-            env: stripPm2GracefulExitMarker(process.env),
-        });
-        child.unref();
-        return { ok: true };
-    }
-    catch (err) {
-        return { ok: false, error: err instanceof Error ? err.message : String(err) };
-    }
-}
-function openOnMac(command) {
-    if (!onPath('osascript'))
-        return { ok: false, error: 'launcher_unavailable', detail: 'osascript not found', command };
-    const args = [
-        '-e', 'tell application "Terminal"',
-        '-e', 'activate',
-        '-e', `do script ${appleScriptString(command)}`,
-        '-e', 'end tell',
-    ];
-    const launched = spawnDetached('osascript', args);
-    if (!launched.ok)
-        return { ok: false, error: 'spawn_failed', detail: launched.error, command };
-    return { ok: true, backend: 'cli', command, launcher: 'Terminal.app' };
-}
-function openCodexApp() {
-    if (process.platform !== 'darwin') {
-        return { ok: false, error: 'unsupported_platform', detail: process.platform, command: 'open -a Codex' };
-    }
-    if (!onPath('open'))
-        return { ok: false, error: 'launcher_unavailable', detail: 'open not found', command: 'open -a Codex' };
-    const launched = spawnSync('open', ['-a', 'Codex'], { stdio: 'ignore', timeout: 3000 });
-    if (launched.status === 0) {
-        return { ok: true, backend: 'app', command: 'open -a Codex', launcher: 'Codex.app' };
-    }
-    return {
-        ok: false,
-        error: 'launcher_unavailable',
-        detail: launched.error?.message ?? 'Codex.app not found',
-        command: 'open -a Codex',
-    };
-}
-/** Per-emulator command forwarding: gnome-terminal wants `--`, xfce4-terminal
- *  `-x`, kitty / xdg-terminal-exec take the command as positional args, and the
- *  xterm lineage (konsole / alacritty / xterm and most others, including
- *  whatever BOTMUX_TERMINAL points at) wants `-e`. */
-export function terminalLaunchArgs(terminalBase, shell, command) {
-    if (terminalBase === 'gnome-terminal')
-        return ['--', shell, '-lc', command];
-    if (terminalBase === 'xfce4-terminal')
-        return ['-x', shell, '-lc', command];
-    if (terminalBase === 'kitty' || terminalBase === 'xdg-terminal-exec')
-        return [shell, '-lc', command];
-    return ['-e', shell, '-lc', command];
-}
-function openOnLinux(command) {
-    const shell = process.env.SHELL || 'bash';
-    const preferred = process.env.BOTMUX_TERMINAL || process.env.TERMINAL;
-    const candidates = [
-        ...(preferred ? [preferred] : []),
-        'xdg-terminal-exec',
-        'gnome-terminal',
-        'konsole',
-        'xfce4-terminal',
-        'kitty',
-        'alacritty',
-        'xterm',
-    ];
-    const terminal = candidates.find(onPath);
-    if (!terminal)
-        return { ok: false, error: 'launcher_unavailable', detail: 'no terminal launcher found', command };
-    const base = terminal.split('/').pop() || terminal;
-    const launched = spawnDetached(terminal, terminalLaunchArgs(base, shell, command));
-    if (!launched.ok)
-        return { ok: false, error: 'spawn_failed', detail: launched.error, command };
-    return { ok: true, backend: 'cli', command, launcher: terminal };
-}
-/** Whether the daemon host can plausibly pop a native terminal window at all.
- *  Gates the card button so headless/server deployments don't carry a button
- *  that can only ever fail: macOS always qualifies (osascript + Terminal.app
- *  ship with the OS); Linux only with a GUI session (DISPLAY/WAYLAND_DISPLAY)
- *  or an explicit BOTMUX_TERMINAL/TERMINAL override. */
-export function localTerminalCapable() {
-    if (process.platform === 'darwin')
-        return true;
-    if (process.platform === 'linux') {
-        return Boolean(process.env.DISPLAY || process.env.WAYLAND_DISPLAY || process.env.BOTMUX_TERMINAL || process.env.TERMINAL);
-    }
-    return false;
-}
-export function openLocalTerminalForSession(ds) {
-    const cfg = effectiveCliConfig(ds);
-    const resolved = localCliCommandForSession(ds);
-    if (!resolved.ok && resolved.error === 'cli_unavailable' && isCodexFamily(cfg.cliId) && !cfg.wrapperCli?.trim()) {
-        const app = openCodexApp();
-        if (app.ok)
-            return app;
-        return { ...resolved, detail: app.detail ?? resolved.detail };
-    }
-    if (!resolved.ok)
-        return resolved;
-    if (process.platform === 'darwin')
-        return openOnMac(resolved.command);
-    if (process.platform === 'linux')
-        return openOnLinux(resolved.command);
-    return { ok: false, error: 'unsupported_platform', detail: process.platform, command: resolved.command };
-}
-//# sourceMappingURL=local-terminal-opener.js.map

package/dist/core/local-terminal-opener.js.map

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

package/dist/core/maintenance-schedule.d.ts

@@ -1,34 +0,0 @@
-/**
- * Pure scheduling logic for the maintenance timer (auto-update / auto-restart).
- * No I/O — the timer in core/maintenance.ts feeds it the current time and the
- * per-task last-handled date, then acts on the decision.
- *
- * Times are interpreted in a fixed local timezone (Asia/Shanghai, matching the
- * scheduler) and fire at most once per local day. "Handled" covers both fired
- * and skipped-because-busy, so a busy collision deterministically slips to the
- * next day rather than retrying.
- */
-import type { MaintenanceTask } from '../global-config.js';
-export declare const MAINTENANCE_TZ = "Asia/Shanghai";
-/** How late a run may fire after its scheduled minute before it's "missed"
- *  (e.g. the daemon was down at the scheduled time). */
-export declare const DEFAULT_GRACE_MINUTES = 60;
-export type MaintenanceDecision = 'disabled' | 'already-handled' | 'not-yet' | 'due' | 'missed';
-export interface DueResult {
-    decision: MaintenanceDecision;
-    /** For 'due'/'missed': the local date the handled occurrence belongs to.
-     *  Usually today, but the PREVIOUS day for a late run that crossed midnight
-     *  within grace — so the caller marks the run's own day, not "today". */
-    markDate?: string;
-}
-/** Local date ('YYYY-MM-DD') and minutes-since-midnight for `nowMs` in `tz`. */
-export declare function localParts(nowMs: number, tz?: string): {
-    dateStr: string;
-    minutesOfDay: number;
-};
-export declare function parseHhMmToMinutes(time: string): number | null;
-export declare function evaluateDue(task: MaintenanceTask, lastDate: string | undefined, nowMs: number, opts?: {
-    tz?: string;
-    graceMinutes?: number;
-}): DueResult;
-//# sourceMappingURL=maintenance-schedule.d.ts.map

package/dist/core/maintenance-schedule.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"maintenance-schedule.d.ts","sourceRoot":"","sources":["../../src/core/maintenance-schedule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAC9C;wDACwD;AACxD,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,MAAM,MAAM,mBAAmB,GAC3B,UAAU,GACV,iBAAiB,GACjB,SAAS,GACT,KAAK,GACL,QAAQ,CAAC;AAEb,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B;;6EAEyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAYD,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAE,MAAuB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAehH;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI9D;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,SAAS,CA6BX"}

package/dist/core/maintenance-schedule.js

@@ -1,72 +0,0 @@
-import { isValidHhMm } from '../global-config.js';
-export const MAINTENANCE_TZ = 'Asia/Shanghai';
-/** How late a run may fire after its scheduled minute before it's "missed"
- *  (e.g. the daemon was down at the scheduled time). */
-export const DEFAULT_GRACE_MINUTES = 60;
-/** Previous calendar day for a 'YYYY-MM-DD' string. */
-function prevDateStr(dateStr) {
-    const [y, m, d] = dateStr.split('-').map(Number);
-    const dt = new Date(Date.UTC(y, m - 1, d));
-    dt.setUTCDate(dt.getUTCDate() - 1);
-    const mm = String(dt.getUTCMonth() + 1).padStart(2, '0');
-    const dd = String(dt.getUTCDate()).padStart(2, '0');
-    return `${dt.getUTCFullYear()}-${mm}-${dd}`;
-}
-/** Local date ('YYYY-MM-DD') and minutes-since-midnight for `nowMs` in `tz`. */
-export function localParts(nowMs, tz = MAINTENANCE_TZ) {
-    const fmt = new Intl.DateTimeFormat('en-CA', {
-        timeZone: tz,
-        year: 'numeric', month: '2-digit', day: '2-digit',
-        hour: '2-digit', minute: '2-digit', hour12: false,
-    });
-    const parts = {};
-    for (const p of fmt.formatToParts(new Date(nowMs))) {
-        if (p.type !== 'literal')
-            parts[p.type] = p.value;
-    }
-    const dateStr = `${parts.year}-${parts.month}-${parts.day}`;
-    // hour can come back as '24' at midnight in some environments — normalize.
-    const hour = Number(parts.hour) % 24;
-    const minutesOfDay = hour * 60 + Number(parts.minute);
-    return { dateStr, minutesOfDay };
-}
-export function parseHhMmToMinutes(time) {
-    if (!isValidHhMm(time))
-        return null;
-    const [h, m] = time.split(':').map(Number);
-    return h * 60 + m;
-}
-export function evaluateDue(task, lastDate, nowMs, opts) {
-    if (!task.enabled || !task.time)
-        return { decision: 'disabled' };
-    const taskMinutes = parseHhMmToMinutes(task.time);
-    if (taskMinutes === null)
-        return { decision: 'disabled' };
-    const tz = opts?.tz ?? MAINTENANCE_TZ;
-    const grace = opts?.graceMinutes ?? DEFAULT_GRACE_MINUTES;
-    const { dateStr, minutesOfDay } = localParts(nowMs, tz);
-    // The most recent scheduled occurrence at or before `now`. When `now` is
-    // before today's minute, the relevant occurrence is yesterday's — this lets a
-    // late-night run (e.g. 23:30) still fire within grace after midnight.
-    let occDate;
-    let lateness;
-    if (minutesOfDay >= taskMinutes) {
-        occDate = dateStr;
-        lateness = minutesOfDay - taskMinutes;
-    }
-    else {
-        occDate = prevDateStr(dateStr);
-        lateness = minutesOfDay + (1440 - taskMinutes);
-    }
-    if (lastDate === occDate)
-        return { decision: 'already-handled' };
-    if (lateness <= grace)
-        return { decision: 'due', markDate: occDate };
-    // Past grace, unhandled. A today occurrence is genuinely missed (mark it so it
-    // won't retry today). A previous-day occurrence this far late is dropped — we
-    // simply wait for today's run rather than firing a stale one.
-    if (occDate === dateStr)
-        return { decision: 'missed', markDate: occDate };
-    return { decision: 'not-yet' };
-}
-//# sourceMappingURL=maintenance-schedule.js.map

package/dist/core/maintenance-schedule.js.map

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

package/dist/core/maintenance.d.ts

@@ -1,114 +0,0 @@
-/**
- * Maintenance timer: scheduled auto-update / auto-restart. Runs only on the
- * primary daemon (bot-0) — restart is a host-wide operation (it takes down all
- * per-bot daemons), so exactly one process must own it.
- *
- * At the scheduled local time (Asia/Shanghai, once/day) it:
- *  - checks the cross-daemon busy gate (anyDaemonBusy) — a session mid-CLI-turn
- *    anywhere defers the run to the next day (no retry);
- *  - auto-update (npm/pnpm/Bun global): update the package with its owning package
- *    manager, then restart
- *    to apply iff the version actually changed;
- *  - auto-restart: just restart.
- * Before triggering a restart it drops a restart-intent breadcrumb so the fresh
- * daemon knows to DM the owner (vs. staying silent on a crash-restart).
- *
- * runMaintenanceTick is pure over its injected deps (unit tested); the rest is
- * production wiring.
- */
-import { spawn } from 'node:child_process';
-import { type MaintenanceConfig } from '../global-config.js';
-import { type RestartIntent } from '../services/restart-intent-store.js';
-import { type GlobalInstallPlan } from '../utils/global-install.js';
-export interface MaintenanceState {
-    /** Local date the auto-update run was last handled (fired or skipped). */
-    autoUpdate?: {
-        lastDate: string;
-    };
-}
-export interface MaintenanceDeps {
-    now: () => number;
-    readConfig: () => MaintenanceConfig | undefined;
-    readState: () => MaintenanceState;
-    writeState: (s: MaintenanceState) => void;
-    anyBusy: () => boolean;
-    isLocalDev: () => boolean;
-    /** Serialize the complete install → optional restart handoff. */
-    withUpdateLock: (fn: () => void) => void;
-    /** Current on-disk botmux version (read fresh — changes after runUpdate). */
-    currentVersion: () => string;
-    /** Updates the owning npm/pnpm/Bun global install (download/install only). */
-    runUpdate: () => void;
-    writeIntent: (intent: RestartIntent) => void;
-    /** Spawn a detached `botmux restart` (this process is then killed by pm2). */
-    triggerRestart: () => void;
-    log?: (msg: string) => void;
-}
-/**
- * One maintenance tick. The schedule is driven solely by auto-update's time
- * (once/day). At that time: install the latest version (download only), and
- * — only if a newer version was actually installed AND the auto-restart toggle
- * is on — restart to apply it. A busy session anywhere skips the whole run to
- * the next day; auto-restart off ⇒ install only (applied on the next restart).
- * Pure orchestration over injected deps.
- */
-export declare function runMaintenanceTick(deps: MaintenanceDeps): void;
-export declare function maintenanceStatePathIn(dir: string): string;
-export declare function readMaintenanceStateTo(dir: string): MaintenanceState;
-export declare function writeMaintenanceStateTo(dir: string, s: MaintenanceState): void;
-/** How often to evaluate the schedule. Sub-minute so an HH:MM target fires
- *  within the same minute it's reached. */
-export declare const MAINTENANCE_TICK_MS = 60000;
-/** Where the auto-restart driver's stdout/stderr is captured, so a failed
- *  restart-to-apply is diagnosable (previously stdio was 'ignore'). */
-export declare function maintenanceRestartLogPath(): string;
-/**
- * Stable cwd (HOME) for spawns that must not inherit a possibly-deleted cwd.
- * A global package update replaces the botmux package dir, so any process whose cwd
- * points there (notably the dashboard, started by pm2 with `cwd: PKG_ROOT`) is
- * left holding a deleted directory. Both the package-manager child and the
- * detached restart driver spawned afterwards would then die at startup reading
- * cwd (`uv_cwd`/ENOENT). Pinning them to HOME sidesteps that entirely.
- */
-export declare function globalInstallUpdateCwd(): string;
-/** Run the ownership-aware update synchronously. */
-export declare function installLatestBotmuxSync(plan?: GlobalInstallPlan): void;
-/**
- * Cross-process lock target that serializes global botmux updates
- * between the scheduled auto-update (this daemon process) and a
- * dashboard-triggered manual update (the separate `botmux-dashboard` process),
- * so the two never write the active global install concurrently. Both sides acquire
- * `withFileLock(Sync)` on this path.
- */
-export declare function globalInstallUpdateLockTargetIn(dataDir: string): string;
-export declare function globalInstallUpdateLockTarget(): string;
-/**
- * Build the command to launch `botmux restart` for applying an auto-update.
- *
- * The restart driver must NOT remain a descendant of the daemon it's about to
- * tear down: `botmux restart` deletes botmux-0 (the very daemon that spawned
- * this), and when PM2 kills botmux-0 a child in its process tree gets
- * interrupted — so the restart aborts after deleting botmux-0 and never
- * restarts the rest (the 2026-06-11 incident). `setsid` starts it in a brand
- * new session, reparented to init, immune to botmux-0's teardown. Without
- * setsid we fall back to a plain spawn (still detached by the caller).
- */
-export declare function buildRestartLauncher(node: string, cliEntry: string, hasSetsid: boolean): {
-    cmd: string;
-    args: string[];
-};
-export declare function detachedRestartEnv(inheritedEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
-/**
- * Spawn a detached `botmux restart`, immune to this process's own teardown
- * (setsid → a new session reparented to init, so PM2 killing the current
- * process doesn't interrupt the restart driver). Output is appended to the
- * maintenance-restart log so a failed restart stays diagnosable. Shared by the
- * maintenance timer (auto-update) and the dashboard's manual update/restart.
- *
- * @param reason short tag written to the log (e.g. 'auto-update', 'dashboard').
- */
-export declare function spawnDetachedRestart(reason: string, activePackageRoot?: string, restartLeaseId?: string): ReturnType<typeof spawn>;
-/** Start the maintenance loop. Call only on the primary daemon (bot-0). */
-export declare function startMaintenance(): void;
-export declare function stopMaintenance(): void;
-//# sourceMappingURL=maintenance.d.ts.map

package/dist/core/maintenance.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["../../src/core/maintenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAY,KAAK,EAAa,MAAM,oBAAoB,CAAC;AAMhE,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG/E,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,qCAAqC,CAAC;AAQ7C,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAGpC,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,UAAU,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,iBAAiB,GAAG,SAAS,CAAC;IAChD,SAAS,EAAE,MAAM,gBAAgB,CAAC;IAClC,UAAU,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC1C,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,iEAAiE;IACjE,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACzC,6EAA6E;IAC7E,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,WAAW,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC7C,8EAA8E;IAC9E,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CA8D9D;AAMD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CASpE;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAM9E;AAID;2CAC2C;AAC3C,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAE1C;uEACuE;AACvE,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,oDAAoD;AACpD,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,iBAA8C,GAAG,IAAI,CAWlG;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,GACjB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAGjC;AAED,wBAAgB,kBAAkB,CAAC,YAAY,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,UAAU,CAmBnG;AAWD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,iBAAiB,CAAC,EAAE,MAAM,EAC1B,cAAc,CAAC,EAAE,MAAM,GACtB,UAAU,CAAC,OAAO,KAAK,CAAC,CAmC1B;AA2CD,2EAA2E;AAC3E,wBAAgB,gBAAgB,IAAI,IAAI,CAavC;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}