ftown-bridge 0.19.37 → 0.19.39

package/dist/loop-controller.js

@@ -1,133 +0,0 @@
-import { createLoop as createLoopInStore, deleteLoop as deleteLoopInStore, getLoop as getLoopInStore, listLoops as listLoopsInStore, mutateLoopRuntime as mutateLoopRuntimeInStore, updateLoop as updateLoopInStore, } from './loop-store.js';
-import { deleteLoopRunRecords as deleteLoopRunRecordsInStore, listLoopRunRecordsWithFallback as listLoopRunRecordsWithFallbackInStore, } from './loop-run-store.js';
-import { validateLoopDraft, validateLoopPatch } from './loop-validation.js';
-const defaultLoopStore = {
-    createLoop: createLoopInStore,
-    getLoop: getLoopInStore,
-    listLoops: listLoopsInStore,
-    updateLoop: updateLoopInStore,
-    deleteLoop: deleteLoopInStore,
-    mutateLoopRuntime: mutateLoopRuntimeInStore,
-};
-const defaultLoopRunStore = {
-    deleteLoopRunRecords: deleteLoopRunRecordsInStore,
-    listLoopRunRecordsWithFallback: listLoopRunRecordsWithFallbackInStore,
-};
-export class LoopController {
-    deps;
-    loopStore;
-    loopRunStore;
-    constructor(deps) {
-        this.deps = deps;
-        this.loopStore = deps.loopStore ?? defaultLoopStore;
-        this.loopRunStore = deps.loopRunStore ?? defaultLoopRunStore;
-    }
-    /** Create a loop owned by this bridge. bridgeId is forced to THIS bridge —
-     * a loop is always owned by its runner, whatever the caller sent. */
-    async create(input) {
-        const candidate = { ...input, bridgeId: this.deps.bridgeId };
-        const error = validateLoopDraft(candidate);
-        if (error) {
-            return { ok: false, code: 'invalid', message: error };
-        }
-        const draft = {
-            name: candidate.name.trim(),
-            bridgeId: this.deps.bridgeId,
-            schedule: candidate.schedule,
-            harness: candidate.harness,
-            workdir: candidate.workdir,
-            task: candidate.task,
-            model: candidate.model,
-            enabled: candidate.enabled,
-            overlapPolicy: candidate.overlapPolicy,
-            retention: candidate.retention,
-            preflight: candidate.preflight,
-            postflight: candidate.postflight,
-            maxRuntimeMs: candidate.maxRuntimeMs,
-            group: candidate.group,
-        };
-        try {
-            const loop = this.loopStore.createLoop(draft);
-            await this.deps.publishLoopUpdate(loop);
-            return { ok: true, loop };
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            return { ok: false, code: 'failed', message };
-        }
-    }
-    list() {
-        return this.loopStore.listLoops();
-    }
-    get(loopId) {
-        const loop = this.loopStore.getLoop(loopId);
-        if (!loop) {
-            return { ok: false, code: 'not_found', message: 'Loop not found' };
-        }
-        return { ok: true, loop };
-    }
-    async update(loopId, patch) {
-        const error = validateLoopPatch(patch);
-        if (error) {
-            return { ok: false, code: 'invalid', message: error };
-        }
-        try {
-            const loop = this.loopStore.updateLoop(loopId, patch);
-            if (!loop) {
-                return { ok: false, code: 'not_found', message: 'Loop not found' };
-            }
-            await this.deps.publishLoopUpdate(loop);
-            return { ok: true, loop };
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            return { ok: false, code: 'failed', message };
-        }
-    }
-    async delete(loopId) {
-        const existingLoop = this.loopStore.getLoop(loopId);
-        const removed = this.loopStore.deleteLoop(loopId);
-        if (removed) {
-            // Stop any in-flight run and drop scheduler tracking so a just-deleted
-            // loop never leaves a live AI session with nothing left to finalize/prune it.
-            if (existingLoop)
-                this.deps.scheduler.onLoopDeleted(existingLoop);
-            this.loopRunStore.deleteLoopRunRecords(loopId);
-            await this.deps.publishLoopRemoved(loopId);
-        }
-        return { removed };
-    }
-    async runNow(loopId) {
-        const loop = this.loopStore.getLoop(loopId);
-        if (!loop) {
-            return { fired: false, reason: 'not_found' };
-        }
-        // A skip-policy loop with a live run cannot be manually fired either —
-        // report overlap synchronously (the async tick would otherwise swallow it).
-        if (loop.overlapPolicy === 'skip' &&
-            loop.lastStatus === 'running' &&
-            loop.lastSessionId &&
-            this.deps.isSessionRunning(loop.lastSessionId)) {
-            return { fired: false, reason: 'overlap' };
-        }
-        // Reload-check-write via mutateLoopRuntime: if the loop was deleted
-        // between the getLoop() above and this write, this returns null and
-        // nothing is written/published — a stale in-memory snapshot must never
-        // be upserted back, or a deleted loop resurrects.
-        const updated = this.loopStore.mutateLoopRuntime(loopId, (l) => {
-            l.runNowRequested = true;
-            l.updatedAt = new Date().toISOString();
-        });
-        if (!updated) {
-            return { fired: false, reason: 'not_found' };
-        }
-        await this.deps.publishLoopUpdate(updated);
-        this.deps.scheduler.kick();
-        return { fired: true, loop: updated };
-    }
-    async runs(loopId) {
-        const sessions = await this.deps.listWireSessions();
-        return this.loopRunStore.listLoopRunRecordsWithFallback(loopId, sessions, (sessionId) => this.deps.loadTerminalLog(sessionId));
-    }
-}
-//# sourceMappingURL=loop-controller.js.map

package/dist/loop-controller.js.map

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

package/dist/loop-run-store.d.ts

@@ -1,10 +0,0 @@
-import type { Loop, LoopRunRecord, Session } from './types.js';
-/** Inject the instance ".ftown home" once at startup (see above). */
-export declare function configureLoopRunStoreHome(home: string | undefined): void;
-export declare function listLoopRunRecords(loopId: string): LoopRunRecord[];
-export declare function getLoopRunRecord(runId: string): LoopRunRecord | undefined;
-export declare function upsertLoopRunRecord(record: LoopRunRecord): LoopRunRecord;
-export declare function deleteLoopRunRecords(loopId: string): void;
-export declare function pruneLoopRunRecords(loopId: string, keep: number | null, preserveIds?: Iterable<string | undefined>): void;
-export declare function recordForSession(loop: Loop, session: Session, startedAt?: string): LoopRunRecord;
-export declare function listLoopRunRecordsWithFallback(loopId: string, sessions: Session[], loadLog?: (sessionId: string) => Promise<string>): Promise<LoopRunRecord[]>;

package/dist/loop-run-store.js

@@ -1,153 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { isLoopHarness } from './harness-registry.js';
-/**
- * Instance ".ftown home" for `loop-runs.json`, injected once at bridge startup
- * via `configureLoopRunStoreHome()` (index.ts passes `resolveFtownHome(dataDir)`):
- * the DEFAULT data dir keeps `$HOME/.ftown`, a non-default `--data-dir` gets its
- * own home so a co-resident bridge's loop-runs.json is never touched. Unconfigured
- * (unit tests / default install) it falls back to `join(homedir(), '.ftown')`
- * resolved at call time — a test's $HOME override still redirects every read/write.
- */
-let configuredFtownHome;
-/** Inject the instance ".ftown home" once at startup (see above). */
-export function configureLoopRunStoreHome(home) {
-    configuredFtownHome = home;
-}
-function ftownHome() {
-    return configuredFtownHome ?? join(homedir(), '.ftown');
-}
-function runStorePath() {
-    return join(ftownHome(), 'loop-runs.json');
-}
-/** Legacy 'skipped' run records were persisted before skip diagnostics moved onto the
- *  Loop object (lastSkipAt/lastSkipReason). Filtering them out here — on every load —
- *  shrinks existing bloated loop-runs.json files as soon as the store is next saved. */
-function loadFile() {
-    try {
-        const path = runStorePath();
-        if (!existsSync(path))
-            return { runs: [] };
-        const parsed = JSON.parse(readFileSync(path, 'utf8'));
-        const runs = Array.isArray(parsed.runs) ? parsed.runs : [];
-        return { runs: runs.filter((run) => run.status !== 'skipped') };
-    }
-    catch {
-        return { runs: [] };
-    }
-}
-function saveFile(data) {
-    mkdirSync(ftownHome(), { recursive: true, mode: 0o700 });
-    const path = runStorePath();
-    const tmp = `${path}.tmp`;
-    writeFileSync(tmp, JSON.stringify(data, null, 2) + '\n', { mode: 0o600 });
-    renameSync(tmp, path);
-}
-export function listLoopRunRecords(loopId) {
-    return loadFile()
-        .runs.filter((run) => run.loopId === loopId)
-        .sort((a, b) => Date.parse(b.startedAt) - Date.parse(a.startedAt));
-}
-export function getLoopRunRecord(runId) {
-    return loadFile().runs.find((run) => run.id === runId || run.sessionId === runId);
-}
-export function upsertLoopRunRecord(record) {
-    const data = loadFile();
-    const index = data.runs.findIndex((run) => run.id === record.id);
-    if (index === -1)
-        data.runs.push(record);
-    else
-        data.runs[index] = record;
-    saveFile(data);
-    return record;
-}
-export function deleteLoopRunRecords(loopId) {
-    const data = loadFile();
-    const remaining = data.runs.filter((run) => run.loopId !== loopId);
-    if (remaining.length === data.runs.length)
-        return;
-    data.runs = remaining;
-    saveFile(data);
-}
-export function pruneLoopRunRecords(loopId, keep, preserveIds = []) {
-    if (keep == null)
-        return;
-    const preserve = new Set([...preserveIds].filter((id) => Boolean(id)));
-    const data = loadFile();
-    const loopRuns = data.runs
-        .filter((run) => run.loopId === loopId)
-        .sort((a, b) => Date.parse(b.startedAt) - Date.parse(a.startedAt));
-    const kept = new Set();
-    for (const run of loopRuns) {
-        if (preserve.has(run.id) || (run.sessionId && preserve.has(run.sessionId)))
-            kept.add(run.id);
-    }
-    for (const run of loopRuns) {
-        if (kept.size >= keep && !kept.has(run.id))
-            continue;
-        kept.add(run.id);
-    }
-    data.runs = data.runs.filter((run) => run.loopId !== loopId || kept.has(run.id));
-    saveFile(data);
-}
-export function recordForSession(loop, session, startedAt = session.createdAt) {
-    return {
-        id: session.id,
-        loopId: loop.id,
-        bridgeId: loop.bridgeId,
-        sessionId: session.id,
-        name: session.name,
-        status: session.status === 'error' ? 'error' : session.status === 'completed' ? 'ok' : 'running',
-        startedAt,
-        updatedAt: new Date().toISOString(),
-        harness: loop.harness,
-        workdir: session.workingDir ?? loop.workdir,
-        task: session.prompt ?? loop.task,
-        model: session.model ?? loop.model,
-        sessionStatus: session.status,
-        errorReason: session.errorReason,
-    };
-}
-function fallbackRecord(loopId, session) {
-    return {
-        id: session.id,
-        loopId,
-        bridgeId: session.bridgeId,
-        sessionId: session.id,
-        name: session.name,
-        status: session.status === 'error' ? 'error' : session.status === 'completed' ? 'ok' : 'running',
-        startedAt: session.createdAt,
-        updatedAt: session.updatedAt,
-        harness: isLoopHarness(session.shellType) ? session.shellType : undefined,
-        workdir: session.workingDir,
-        task: session.prompt,
-        model: session.model,
-        sessionStatus: session.status,
-        errorReason: session.errorReason,
-    };
-}
-export async function listLoopRunRecordsWithFallback(loopId, sessions, loadLog) {
-    const records = listLoopRunRecords(loopId);
-    const seenSessionIds = new Set(records.map((run) => run.sessionId).filter(Boolean));
-    const seenIds = new Set(records.map((run) => run.id));
-    for (const session of sessions) {
-        if (session.loopId !== loopId)
-            continue;
-        if (seenIds.has(session.id) || seenSessionIds.has(session.id))
-            continue;
-        const record = fallbackRecord(loopId, session);
-        if (loadLog && (session.status === 'completed' || session.status === 'error')) {
-            const log = await loadLog(session.id);
-            const tail = log.length > 65_536 ? log.slice(-65_536) : log;
-            record.logTail = tail;
-            record.logBytes = Buffer.byteLength(log, 'utf8');
-            record.logTruncated = Buffer.byteLength(log, 'utf8') > Buffer.byteLength(tail, 'utf8');
-            record.finishedAt = session.updatedAt;
-            record.durationMs = Math.max(0, Date.parse(session.updatedAt) - Date.parse(session.createdAt));
-        }
-        records.push(record);
-    }
-    return records.sort((a, b) => Date.parse(b.startedAt) - Date.parse(a.startedAt));
-}
-//# sourceMappingURL=loop-run-store.js.map

package/dist/loop-run-store.js.map

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

package/dist/loop-schedule.d.ts

@@ -1,18 +0,0 @@
-import type { Loop, LoopSchedule } from './types.js';
-/**
- * Epoch ms of the next fire strictly after fromMs.
- *
- * - interval: fromMs + everyMs, floored at a 1000ms minimum cadence so a
- *   misconfigured sub-second loop cannot busy-spin the scheduler.
- * - cron: the next occurrence strictly after `fromMs` in the loop's timezone.
- *   Throws on a malformed cron expression (callers validate before persisting).
- */
-export declare function computeNextRun(schedule: LoopSchedule, fromMs: number): number;
-/**
- * Whether a loop should fire on a tick at `nowMs`.
- *
- * A manual run request bypasses both the enabled flag and the schedule (it is a
- * one-shot override cleared on the next fire). Otherwise the loop must be
- * enabled, have a computed nextRunAt, and that target must be at or before now.
- */
-export declare function isDue(loop: Loop, nowMs: number): boolean;

package/dist/loop-schedule.js

@@ -1,35 +0,0 @@
-import cronParser from 'cron-parser';
-/**
- * Epoch ms of the next fire strictly after fromMs.
- *
- * - interval: fromMs + everyMs, floored at a 1000ms minimum cadence so a
- *   misconfigured sub-second loop cannot busy-spin the scheduler.
- * - cron: the next occurrence strictly after `fromMs` in the loop's timezone.
- *   Throws on a malformed cron expression (callers validate before persisting).
- */
-export function computeNextRun(schedule, fromMs) {
-    if (schedule.kind === 'interval')
-        return fromMs + Math.max(1000, schedule.everyMs);
-    const it = cronParser.parseExpression(schedule.expression, {
-        currentDate: new Date(fromMs),
-        tz: schedule.tz,
-    });
-    return it.next().toDate().getTime();
-}
-/**
- * Whether a loop should fire on a tick at `nowMs`.
- *
- * A manual run request bypasses both the enabled flag and the schedule (it is a
- * one-shot override cleared on the next fire). Otherwise the loop must be
- * enabled, have a computed nextRunAt, and that target must be at or before now.
- */
-export function isDue(loop, nowMs) {
-    if (loop.runNowRequested)
-        return true; // manual fire bypasses enabled + schedule
-    if (!loop.enabled)
-        return false;
-    if (!loop.nextRunAt)
-        return false;
-    return Date.parse(loop.nextRunAt) <= nowMs;
-}
-//# sourceMappingURL=loop-schedule.js.map

package/dist/loop-schedule.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"loop-schedule.js","sourceRoot":"","sources":["../src/loop-schedule.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,aAAa,CAAC;AAIrC;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,QAAsB,EAAE,MAAc;IACnE,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnF,MAAM,EAAE,GAAG,UAAU,CAAC,eAAe,CAAC,QAAQ,CAAC,UAAU,EAAE;QACzD,WAAW,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC;QAC7B,EAAE,EAAE,QAAQ,CAAC,EAAE;KAChB,CAAC,CAAC;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CAAC,IAAU,EAAE,KAAa;IAC7C,IAAI,IAAI,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC,CAAC,0CAA0C;IACjF,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC;AAC7C,CAAC"}

package/dist/loop-scheduler.d.ts

@@ -1,148 +0,0 @@
-import { type LoopRuntimeMutator } from './loop-store.js';
-import type { CreateFtownSessionInput } from './create-ftown-session.js';
-import type { RemoveFtownSessionOptions } from './remove-ftown-session.js';
-import type { Loop, LoopRunRecord, Session } from './types.js';
-/** Base tick cadence; also the finalize grace so a just-spawned PTY is not mistaken for exited. */
-export declare const LOOP_TICK_INTERVAL_MS = 30000;
-export interface FlightResult {
-    stdout: string;
-    stderr: string;
-    exitCode: number;
-}
-/** Preflight/postflight primitive: promisified child_process.exec (captures exit code + timeout). */
-export type RunFlight = (command: string, cwd: string | undefined, timeoutMs?: number, extraEnv?: Record<string, string>) => Promise<FlightResult>;
-/** In-process flight spawn — wraps createFtownSession(sessionDeps, input) in index.ts. */
-export type SpawnSession = (input: CreateFtownSessionInput) => Promise<Session>;
-/** In-process run removal — wraps removeFtownSession({store,runner,centrifugo,userId}, id, opts) in index.ts. */
-export type RemoveSession = (id: string, options?: RemoveFtownSessionOptions) => Promise<Session | null>;
-export interface SchedulerStore {
-    loadSession(id: string): Promise<Session | null>;
-    loadTerminalLog(id: string): Promise<string>;
-    listSessions(): Promise<Session[]>;
-}
-export interface SchedulerRunner {
-    isRunning(id: string): boolean;
-    stop(id: string): boolean;
-}
-export interface SchedulerCentrifugo {
-    publishLoopUpdate(userId: string, loop: Loop): Promise<void>;
-}
-export interface LoopStoreApi {
-    listLoops(): Loop[];
-    /** Fresh-read → mutate scheduler-owned fields → save; null when deleted concurrently. */
-    mutateLoopRuntime(id: string, fn: LoopRuntimeMutator): Loop | null;
-}
-export interface LoopRunRecordStoreApi {
-    upsertLoopRunRecord(record: LoopRunRecord): LoopRunRecord;
-    pruneLoopRunRecords(loopId: string, keep: number | null, preserveIds?: Iterable<string | undefined>): void;
-}
-export interface SchedulerDeps {
-    store: SchedulerStore;
-    runner: SchedulerRunner;
-    centrifugo: SchedulerCentrifugo;
-    userId: string;
-    /** Built in index.ts as (input) => createFtownSession(sessionDeps, input) — the direct in-process call. */
-    spawnSession: SpawnSession;
-    /** Built in index.ts as (id, opts) => removeFtownSession({store,runner,centrifugo,userId}, id, opts). */
-    removeSession: RemoveSession;
-    /** Loop persistence. Defaults to the real ~/.ftown/loops.json store. */
-    loops?: LoopStoreApi;
-    /** Durable loop-run log persistence. Defaults to the real ~/.ftown/loop-runs.json store. */
-    runRecords?: LoopRunRecordStoreApi;
-    /** Flight runner. Defaults to the exec-based runFlightCommand. */
-    runFlight?: RunFlight;
-    /** Clock seam. Defaults to Date.now. */
-    now?: () => number;
-}
-/**
- * Runs child_process.exec and normalizes the result to { stdout, stderr,
- * exitCode }. Never rejects — the exit code is the signal (a timeout maps to
- * 124, any other failure to the real exit code or 1).
- *
- * The hard budget is enforced by SIGKILL on the whole process GROUP, NOT by
- * exec's built-in `timeout`. exec's timeout only sends SIGTERM to the spawned
- * `/bin/sh`; a detached grandchild that keeps the stdout pipe open, or a child
- * that traps SIGTERM, would keep the exec callback from ever firing — and since
- * the scheduler awaits every flight inside a single re-entrancy-guarded tick,
- * ONE such flight would wedge the entire scheduler permanently. Spawning
- * `detached` makes the child its own group leader, so `kill(-pid, SIGKILL)`
- * takes down the whole tree and the flight can never exceed its budget.
- */
-export declare function runFlightCommand(command: string, cwd: string | undefined, timeoutMs?: number, extraEnv?: Record<string, string>): Promise<FlightResult>;
-/**
- * The scheduled-loops engine. On each 30s tick it FINALIZES each loop's
- * in-flight run(s) (Phase A) before deciding whether to FIRE a new one
- * (Phase B). All side effects go through injected collaborators so it is
- * unit-testable without a live bridge, real fs or real timers (mirrors
- * workflow-runner.ts).
- *
- * Persistence rule: the scheduler NEVER writes a whole detached Loop back
- * across an await. Every runtime-field change goes through
- * store.mutateLoopRuntime (fresh-read → mutate → save), so a loop deleted or
- * user-edited during a long flight is neither resurrected nor clobbered.
- */
-export declare class LoopScheduler {
-    private readonly store;
-    private readonly runner;
-    private readonly centrifugo;
-    private readonly userId;
-    private readonly spawnSession;
-    private readonly removeSession;
-    private readonly loops;
-    private readonly runRecords;
-    private readonly runFlight;
-    private readonly now;
-    /** Re-entrancy guard: tick N+1 never overlaps N. */
-    private tickRunning;
-    /** Set once start() runs (after reconcileOnStart). kick() no-ops before this so an
-     *  early run_loop_now cannot trigger an un-reconciled tick that stampedes overdue loops. */
-    private started;
-    /** Per-loop in-memory fire lock, shared by tick + run_loop_now/kick. */
-    private readonly firingLoops;
-    /** loopId -> (runSessionId -> fire-time ms). Every run THIS process spawned, so under
-     *  overlapPolicy:'allow' each concurrent run is finalized/postflighted/maxRuntime-checked
-     *  independently — not just the newest. Rebuilt lazily from the persisted primary on restart. */
-    private readonly inFlight;
-    private timer;
-    constructor(deps: SchedulerDeps);
-    start(): void;
-    stop(): void;
-    /** Immediate, guarded, out-of-band tick (used by run_loop_now). No-op until start()
-     *  has run, so a kick that races startup cannot fire before reconcileOnStart. */
-    kick(): void;
-    /** Drop scheduler tracking for a deleted loop and stop any run it left alive, so a
-     *  just-deleted loop never leaks a live AI session with nothing left to finalize it. */
-    onLoopDeleted(loop: Loop): void;
-    /**
-     * Missed-schedule policy, run once before the first tick: for every loop whose
-     * nextRunAt is missing or already past, recompute it from now (skip missed
-     * occurrences; never stampede overdue loops). runNowRequested is preserved so a
-     * manual override survives a restart and still fires on the first tick. A loop
-     * with a corrupt persisted schedule is skipped here (logged) and reported as an
-     * error on its first fire.
-     */
-    reconcileOnStart(now?: number): Promise<void>;
-    tick(now?: number): Promise<void>;
-    private processLoop;
-    /** Phase A: finalize each in-flight run once its PTY is confirmed gone (past grace)
-     *  or over its per-run maxRuntime budget. Under 'allow' this walks every tracked run,
-     *  not just the newest, so none is orphaned. */
-    private finalizePhase;
-    /** Seed the persisted primary run into in-memory tracking after a restart (when this
-     *  process has spawned nothing yet for the loop), so a run left 'running' by a prior
-     *  process is still finalized. */
-    private ensureTracked;
-    private track;
-    /** Phase B: fire the loop if due, honoring the per-loop lock and the overlap policy. */
-    private firePhase;
-    /** Advance the schedule up front (so failures/skips never stampede), then preflight → flight. */
-    private fireLoop;
-    /** Resolve one finished run to ok/error, update the loop badge (only if this is the
-     *  loop's tracked/latest run), then run postflight + retention for it. */
-    private finalizeRun;
-    private runPostflight;
-    /** Keep the newest N run-sessions for this loop; prune older finished ones. */
-    private pruneRuns;
-    private persist;
-    private publish;
-}