@start9labs/start-sdk 1.5.2 → 2.0.0

package/package/lib/mainFn/Daemons.d.ts

@@ -1,275 +0,0 @@
-import { HealthCheckResult } from '../health/checkFns';
-import { Trigger } from '../trigger';
-import * as T from '../../../base/lib/types';
-import { SubContainer } from '../util/SubContainer';
-import * as CP from 'node:child_process';
-export { Daemon } from './Daemon';
-export { CommandController } from './CommandController';
-import { HealthDaemon } from './HealthDaemon';
-import { Daemon } from './Daemon';
-import { CommandController } from './CommandController';
-/** Promisified version of `child_process.exec` */
-export declare const cpExec: typeof CP.exec.__promisify__;
-/** Promisified version of `child_process.execFile` */
-export declare const cpExecFile: typeof CP.execFile.__promisify__;
-/**
- * Configuration for a daemon's health-check readiness probe.
- *
- * Every daemon and standalone health check requires a `Ready` configuration
- * that tells StartOS how to determine whether the daemon is healthy.
- *
- * The `fn` is called on a recurring interval controlled by `trigger` (defaults
- * to 1 s before the first non-pending result, then 30 s). During the initial
- * `gracePeriod` window, `failure` results are softened to `starting` so the
- * UI doesn't flash red while a daemon is still booting.
- *
- * ### Health check result states
- *
- * | Result      | Meaning                                              | UI treatment     |
- * |-------------|------------------------------------------------------|------------------|
- * | `success`   | Healthy and fully operational                        | Green / ready    |
- * | `loading`   | Operational but still catching up (e.g. syncing)     | Progress / amber |
- * | `disabled`  | Intentionally inactive (excluded by configuration)   | Grey / skipped   |
- * | `starting`  | Not yet ready, still initializing                    | Spinner          |
- * | `waiting`   | Blocked on an external dependency                    | Spinner          |
- * | `failure`   | Unhealthy — something is wrong                       | Red / error      |
- */
-export type Ready = {
-    /**
-     * Human-readable label shown in the StartOS health-check UI.
-     * Set to `null` to hide this check from the UI entirely.
-     */
-    display: string | null;
-    /**
-     * The function called on each polling interval to determine the daemon's health.
-     *
-     * Return a {@link HealthCheckResult} with a `result` field (`success`, `loading`,
-     * `failure`, etc.) and an optional `message` string shown in the UI.
-     *
-     * The SDK ships several built-in helpers on `sdk.healthCheck`:
-     * - `checkPortListening` — checks whether a TCP/UDP port is bound
-     * - `checkWebUrl` — fetches a URL and succeeds on any HTTP response
-     * - `runHealthScript` — runs a command in a subcontainer and succeeds on exit 0
-     *
-     * @example
-     * ```ts
-     * fn: () =>
-     *   sdk.healthCheck.checkPortListening(effects, 80, {
-     *     successMessage: 'Web server is ready',
-     *     errorMessage: 'Web server is not listening',
-     *   })
-     * ```
-     */
-    fn: () => Promise<HealthCheckResult> | HealthCheckResult;
-    /**
-     * Duration in milliseconds during which `failure` results are reported
-     * as `starting` instead, giving the daemon time to initialize without
-     * showing errors in the UI.
-     *
-     * @default 10_000
-     */
-    gracePeriod?: number;
-    /**
-     * Controls the polling interval for this health check.
-     *
-     * Use one of the built-in triggers from `sdk.trigger`:
-     * - `cooldownTrigger(ms)` — fixed interval between checks
-     * - `statusTrigger({ success, loading, failure, ... })` — per-status
-     *   polling intervals
-     *
-     * If omitted, uses the default trigger: 1 s before the first non-pending
-     * result, then 30 s afterward.
-     */
-    trigger?: Trigger;
-};
-/**
- * Options for running a daemon as a shell command inside a subcontainer.
- */
-export type ExecCommandOptions = {
-    /** The command and arguments to execute (e.g. `['bitcoind', '-conf=/etc/bitcoin.conf']`) */
-    command: T.CommandType;
-    /**
-     * How long (ms) to wait for the process to exit after sending SIGTERM
-     * before force-killing it.
-     *
-     * @default 30_000
-     */
-    sigtermTimeout?: number;
-    /** Run the command as PID 1 inside the container (init process) */
-    runAsInit?: boolean;
-    /** Environment variables to set for the process */
-    env?: {
-        [variable in string]?: string;
-    } | undefined;
-    /** Working directory for the process */
-    cwd?: string | undefined;
-    /** Run the process as this user inside the container */
-    user?: string | undefined;
-    /** Callback invoked with each chunk written to stdout */
-    onStdout?: (chunk: Buffer | string | any) => void;
-    /** Callback invoked with each chunk written to stderr */
-    onStderr?: (chunk: Buffer | string | any) => void;
-};
-/**
- * Options for running a daemon via an async function that may optionally return
- * a command to execute in the subcontainer. The function receives an `AbortSignal`
- * for cooperative cancellation.
- */
-export type ExecFnOptions<Manifest extends T.SDKManifest, C extends SubContainer<Manifest> | null> = {
-    fn: (subcontainer: C, abort: AbortSignal) => Promise<C extends null ? null : ExecCommandOptions | null>;
-    sigtermTimeout?: number;
-};
-/**
- * The execution specification for a daemon: either an {@link ExecFnOptions} (async function)
- * or an {@link ExecCommandOptions} (shell command, only valid when a subcontainer is provided).
- */
-export type DaemonCommandType<Manifest extends T.SDKManifest, C extends SubContainer<Manifest> | null> = ExecFnOptions<Manifest, C> | (C extends null ? never : ExecCommandOptions);
-type NewDaemonParams<Manifest extends T.SDKManifest, C extends SubContainer<Manifest> | null> = {
-    /** What to run as the daemon: either an async fn or a commandline command to run in the subcontainer */
-    exec: DaemonCommandType<Manifest, C>;
-    /** The subcontainer in which the daemon runs */
-    subcontainer: C;
-};
-type OptionalParamSync<T> = T | (() => T | null);
-type OptionalParamAsync<T> = () => Promise<T | null>;
-type AddDaemonParams<Manifest extends T.SDKManifest, Ids extends string, Id extends string, C extends SubContainer<Manifest> | null> = (NewDaemonParams<Manifest, C> | {
-    daemon: Daemon<Manifest>;
-}) & {
-    ready: Ready;
-    /**
-     * IDs of prior daemons/oneshots/health checks that must be ready before
-     * this daemon starts. Enforces startup ordering in the daemon chain.
-     */
-    requires: Exclude<Ids, Id>[];
-};
-type AddOneshotParams<Manifest extends T.SDKManifest, Ids extends string, Id extends string, C extends SubContainer<Manifest> | null> = NewDaemonParams<Manifest, C> & {
-    exec: DaemonCommandType<Manifest, C>;
-    /**
-     * IDs of prior daemons/oneshots/health checks that must be ready before
-     * this oneshot runs.
-     */
-    requires: Exclude<Ids, Id>[];
-};
-type AddHealthCheckParams<Ids extends string, Id extends string> = {
-    ready: Ready;
-    /**
-     * IDs of prior daemons/oneshots/health checks that must be ready before
-     * this health check starts polling.
-     */
-    requires: Exclude<Ids, Id>[];
-};
-type ErrorDuplicateId<Id extends string> = `The id '${Id}' is already used`;
-export declare const runCommand: <Manifest extends T.SDKManifest>() => (effects: T.Effects, subcontainer: SubContainer<Manifest, T.Effects>, exec: DaemonCommandType<Manifest, SubContainer<Manifest, T.Effects>>) => Promise<CommandController<Manifest, SubContainer<Manifest, T.Effects>>>;
-/**
- * A class for defining and controlling the service daemons
-```ts
-Daemons.of({
-  effects,
-  started,
-  interfaceReceipt, // Provide the interfaceReceipt to prove it was completed
-  healthReceipts, // Provide the healthReceipts or [] to prove they were at least considered
-}).addDaemon('webui', {
-  command: 'hello-world', // The command to start the daemon
-  ready: {
-    display: 'Web Interface',
-    // The function to run to determine the health status of the daemon
-    fn: () =>
-      checkPortListening(effects, 80, {
-        successMessage: 'The web interface is ready',
-        errorMessage: 'The web interface is not ready',
-      }),
-  },
-  requires: [],
-})
-```
- */
-export declare class Daemons<Manifest extends T.SDKManifest, Ids extends string> implements T.DaemonBuildable {
-    readonly effects: T.Effects;
-    readonly ids: Ids[];
-    readonly healthDaemons: HealthDaemon<Manifest>[];
-    private termPromise;
-    private constructor();
-    /**
-     * Returns an empty new Daemons class with the provided inputSpec.
-     *
-     * Call .addDaemon() on the returned class to add a daemon.
-     *
-     * Daemons run in the order they are defined, with latter daemons being capable of
-     * depending on prior daemons
-     *
-     * @param effects
-     *
-     * @param started
-     * @returns
-     */
-    static of<Manifest extends T.SDKManifest>(options: {
-        effects: T.Effects;
-    }): Daemons<Manifest, never>;
-    private addDaemonImpl;
-    /**
-     * Register a long-running daemon process.
-     *
-     * The daemon starts in its subcontainer and is monitored by its `ready`
-     * health check. Other daemons and health checks can depend on it via
-     * `requires`.
-     *
-     * Pass a static options object, a sync/async factory that returns options
-     * (or `null` to conditionally skip the daemon), or an object with a
-     * pre-built `daemon` instance.
-     *
-     * @param id - Unique string identifier for this daemon
-     * @param options - Daemon configuration, or a factory returning it (return `null` to skip)
-     */
-    addDaemon<Id extends string, C extends SubContainer<Manifest> | null>(id: "" extends Id ? never : ErrorDuplicateId<Id> extends Id ? never : Id extends Ids ? ErrorDuplicateId<Id> : Id, options: OptionalParamSync<AddDaemonParams<Manifest, Ids, Id, C>>): Daemons<Manifest, Ids | Id>;
-    addDaemon<Id extends string, C extends SubContainer<Manifest> | null>(id: "" extends Id ? never : ErrorDuplicateId<Id> extends Id ? never : Id extends Ids ? ErrorDuplicateId<Id> : Id, options: OptionalParamAsync<AddDaemonParams<Manifest, Ids, Id, C>>): Promise<Daemons<Manifest, Ids | Id>>;
-    /**
-     * Register a one-shot command that runs to completion before dependents start.
-     *
-     * Common uses: `chown` for file ownership, database migrations, config
-     * generation, wallet unlocking. The oneshot is considered "ready" as soon
-     * as the command exits successfully (exit code 0).
-     *
-     * @param id - Unique string identifier for this oneshot
-     * @param options - Oneshot configuration, or a factory returning it (return `null` to skip)
-     */
-    addOneshot<Id extends string, C extends SubContainer<Manifest> | null>(id: "" extends Id ? never : ErrorDuplicateId<Id> extends Id ? never : Id extends Ids ? ErrorDuplicateId<Id> : Id, options: OptionalParamSync<AddOneshotParams<Manifest, Ids, Id, C>>): Daemons<Manifest, Ids | Id>;
-    addOneshot<Id extends string, C extends SubContainer<Manifest> | null>(id: "" extends Id ? never : ErrorDuplicateId<Id> extends Id ? never : Id extends Ids ? ErrorDuplicateId<Id> : Id, options: OptionalParamAsync<AddOneshotParams<Manifest, Ids, Id, C>>): Promise<Daemons<Manifest, Ids | Id>>;
-    /**
-     * Register a standalone health check with no associated process.
-     *
-     * Use this for ongoing conditions that don't map to a single daemon, such
-     * as blockchain sync progress or network reachability. Dependent services
-     * can reference standalone health check IDs in their dependency config.
-     *
-     * @param id - Unique string identifier for this health check
-     * @param options - Health check configuration, or a factory returning it (return `null` to skip)
-     */
-    addHealthCheck<Id extends string>(id: "" extends Id ? never : ErrorDuplicateId<Id> extends Id ? never : Id extends Ids ? ErrorDuplicateId<Id> : Id, options: OptionalParamSync<AddHealthCheckParams<Ids, Id>>): Daemons<Manifest, Ids | Id>;
-    addHealthCheck<Id extends string>(id: "" extends Id ? never : ErrorDuplicateId<Id> extends Id ? never : Id extends Ids ? ErrorDuplicateId<Id> : Id, options: OptionalParamAsync<AddHealthCheckParams<Ids, Id>>): Promise<Daemons<Manifest, Ids | Id>>;
-    /**
-     * Start all registered daemons and wait until every one passes its ready
-     * check, then tear everything down.
-     *
-     * Used for bootstrapping via a temporary daemon chain — e.g. starting a
-     * service to call its API (create admin users, register apps), then
-     * shutting it down before the real daemon chain starts.
-     *
-     * @param timeout - Maximum time (ms) to wait for all daemons to become ready, or `null` for no limit
-     * @throws If the timeout is reached before all daemons are ready
-     */
-    runUntilSuccess(timeout: number | null): Promise<null>;
-    /**
-     * Gracefully terminate all daemons in reverse dependency order.
-     *
-     * Daemons with no remaining dependents are shut down first, proceeding
-     * until all daemons have been terminated. Falls back to a bulk shutdown
-     * if a dependency cycle is detected.
-     */
-    term(): Promise<void>;
-    private _term;
-    /**
-     * Start all registered daemons and their health checks.
-     * @returns This `Daemons` instance, now running
-     */
-    build(): Promise<this>;
-}

package/package/lib/mainFn/Daemons.js

@@ -1,258 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Daemons = exports.runCommand = exports.cpExecFile = exports.cpExec = exports.CommandController = exports.Daemon = void 0;
-const node_util_1 = require("node:util");
-const CP = __importStar(require("node:child_process"));
-var Daemon_1 = require("./Daemon");
-Object.defineProperty(exports, "Daemon", { enumerable: true, get: function () { return Daemon_1.Daemon; } });
-var CommandController_1 = require("./CommandController");
-Object.defineProperty(exports, "CommandController", { enumerable: true, get: function () { return CommandController_1.CommandController; } });
-const HealthDaemon_1 = require("./HealthDaemon");
-const Daemon_2 = require("./Daemon");
-const CommandController_2 = require("./CommandController");
-const Oneshot_1 = require("./Oneshot");
-/** Promisified version of `child_process.exec` */
-exports.cpExec = (0, node_util_1.promisify)(CP.exec);
-/** Promisified version of `child_process.execFile` */
-exports.cpExecFile = (0, node_util_1.promisify)(CP.execFile);
-const runCommand = () => CommandController_2.CommandController.of();
-exports.runCommand = runCommand;
-/**
- * A class for defining and controlling the service daemons
-```ts
-Daemons.of({
-  effects,
-  started,
-  interfaceReceipt, // Provide the interfaceReceipt to prove it was completed
-  healthReceipts, // Provide the healthReceipts or [] to prove they were at least considered
-}).addDaemon('webui', {
-  command: 'hello-world', // The command to start the daemon
-  ready: {
-    display: 'Web Interface',
-    // The function to run to determine the health status of the daemon
-    fn: () =>
-      checkPortListening(effects, 80, {
-        successMessage: 'The web interface is ready',
-        errorMessage: 'The web interface is not ready',
-      }),
-  },
-  requires: [],
-})
-```
- */
-class Daemons {
-    constructor(effects, ids, healthDaemons) {
-        this.effects = effects;
-        this.ids = ids;
-        this.healthDaemons = healthDaemons;
-        this.termPromise = null;
-    }
-    /**
-     * Returns an empty new Daemons class with the provided inputSpec.
-     *
-     * Call .addDaemon() on the returned class to add a daemon.
-     *
-     * Daemons run in the order they are defined, with latter daemons being capable of
-     * depending on prior daemons
-     *
-     * @param effects
-     *
-     * @param started
-     * @returns
-     */
-    static of(options) {
-        return new Daemons(options.effects, [], []);
-    }
-    addDaemonImpl(id, daemon, requires, ready) {
-        const healthDaemon = new HealthDaemon_1.HealthDaemon(daemon, requires
-            .map((x) => this.ids.indexOf(x))
-            .filter((x) => x >= 0)
-            .map((id) => this.healthDaemons[id]), id, ready, this.effects);
-        const ids = [...this.ids, id];
-        const healthDaemons = [...this.healthDaemons, healthDaemon];
-        return new Daemons(this.effects, ids, healthDaemons);
-    }
-    addDaemon(id, options) {
-        const prev = this;
-        const res = (options) => {
-            if (!options)
-                return prev;
-            const daemon = 'daemon' in options
-                ? options.daemon
-                : Daemon_2.Daemon.of()(this.effects, options.subcontainer, options.exec);
-            return prev.addDaemonImpl(id, daemon, options.requires, options.ready);
-        };
-        if (options instanceof Function) {
-            const opts = options();
-            if (opts instanceof Promise) {
-                return opts.then(res);
-            }
-            return res(opts);
-        }
-        return res(options);
-    }
-    addOneshot(id, options) {
-        const prev = this;
-        const res = (options) => {
-            if (!options)
-                return prev;
-            const daemon = Oneshot_1.Oneshot.of()(this.effects, options.subcontainer, options.exec);
-            return prev.addDaemonImpl(id, daemon, options.requires, HealthDaemon_1.EXIT_SUCCESS);
-        };
-        if (options instanceof Function) {
-            const opts = options();
-            if (opts instanceof Promise) {
-                return opts.then(res);
-            }
-            return res(opts);
-        }
-        return res(options);
-    }
-    addHealthCheck(id, options) {
-        const prev = this;
-        const res = (options) => {
-            if (!options)
-                return prev;
-            return prev.addDaemonImpl(id, null, options.requires, options.ready);
-        };
-        if (options instanceof Function) {
-            const opts = options();
-            if (opts instanceof Promise) {
-                return opts.then(res);
-            }
-            return res(opts);
-        }
-        return res(options);
-    }
-    /**
-     * Start all registered daemons and wait until every one passes its ready
-     * check, then tear everything down.
-     *
-     * Used for bootstrapping via a temporary daemon chain — e.g. starting a
-     * service to call its API (create admin users, register apps), then
-     * shutting it down before the real daemon chain starts.
-     *
-     * @param timeout - Maximum time (ms) to wait for all daemons to become ready, or `null` for no limit
-     * @throws If the timeout is reached before all daemons are ready
-     */
-    async runUntilSuccess(timeout) {
-        let resolve = (_) => { };
-        const res = new Promise((res, rej) => {
-            resolve = res;
-            if (timeout)
-                setTimeout(() => {
-                    const notReady = this.healthDaemons
-                        .filter((d) => !d.isReady)
-                        .map((d) => d.id);
-                    rej(new Error(`Timed out waiting for ${notReady}`));
-                }, timeout);
-        });
-        const daemon = Oneshot_1.Oneshot.of()(this.effects, null, {
-            fn: async () => {
-                resolve();
-                return null;
-            },
-        });
-        const healthDaemon = new HealthDaemon_1.HealthDaemon(daemon, [...this.healthDaemons], '__RUN_UNTIL_SUCCESS', 'EXIT_SUCCESS', this.effects);
-        const daemons = await new Daemons(this.effects, this.ids, [
-            ...this.healthDaemons,
-            healthDaemon,
-        ]).build();
-        try {
-            await res;
-        }
-        finally {
-            await daemons.term();
-        }
-        return null;
-    }
-    /**
-     * Gracefully terminate all daemons in reverse dependency order.
-     *
-     * Daemons with no remaining dependents are shut down first, proceeding
-     * until all daemons have been terminated. Falls back to a bulk shutdown
-     * if a dependency cycle is detected.
-     */
-    async term() {
-        if (!this.termPromise) {
-            this.termPromise = this._term();
-        }
-        return this.termPromise;
-    }
-    async _term() {
-        const remaining = new Set(this.healthDaemons);
-        while (remaining.size > 0) {
-            // Find daemons with no remaining dependents
-            const canShutdown = [...remaining].filter((daemon) => ![...remaining].some((other) => other.dependencies.some((dep) => dep.id === daemon.id)));
-            if (canShutdown.length === 0) {
-                // Dependency cycle that should not happen, just shutdown remaining daemons
-                console.warn('Dependency cycle detected, shutting down remaining daemons');
-                canShutdown.push(...[...remaining].reverse());
-            }
-            // remove from remaining set
-            canShutdown.forEach((daemon) => remaining.delete(daemon));
-            // Shutdown daemons with no remaining dependents concurrently
-            await Promise.allSettled(canShutdown.map(async (daemon) => {
-                try {
-                    console.debug(`Terminating daemon ${daemon.id}`);
-                    const destroySubcontainer = daemon.daemon
-                        ? ![...remaining].some((d) => d.daemon?.sharesSubcontainerWith(daemon.daemon))
-                        : false;
-                    await daemon.term({ destroySubcontainer });
-                }
-                catch (e) {
-                    console.error(e);
-                }
-            }));
-        }
-    }
-    /**
-     * Start all registered daemons and their health checks.
-     * @returns This `Daemons` instance, now running
-     */
-    async build() {
-        this.effects.onLeaveContext(() => {
-            this.term().catch((e) => console.error(e));
-        });
-        for (const daemon of this.healthDaemons) {
-            daemon.daemon?.markManaged();
-            await daemon.updateStatus();
-        }
-        return this;
-    }
-}
-exports.Daemons = Daemons;
-//# sourceMappingURL=Daemons.js.map

package/package/lib/mainFn/Daemons.js.map

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

package/package/lib/mainFn/HealthDaemon.d.ts

@@ -1,46 +0,0 @@
-import { HealthCheckResult } from '../health/checkFns';
-import { Ready } from './Daemons';
-import { Daemon } from './Daemon';
-import { Effects, SDKManifest } from '../../../base/lib/types';
-export declare const EXIT_SUCCESS: "EXIT_SUCCESS";
-/**
- * Wanted a structure that deals with controlling daemons by their health status
- * States:
- * -- Waiting for dependencies to be success
- * -- Running: Daemon is running and the status is in the health
- *
- */
-export declare class HealthDaemon<Manifest extends SDKManifest> {
-    readonly daemon: Daemon<Manifest> | null;
-    readonly dependencies: HealthDaemon<Manifest>[];
-    readonly id: string;
-    readonly ready: Ready | typeof EXIT_SUCCESS;
-    readonly effects: Effects;
-    private _health;
-    private healthWatchers;
-    private running;
-    private started?;
-    private resolveReady;
-    private resolvedReady;
-    private readyPromise;
-    private session;
-    constructor(daemon: Daemon<Manifest> | null, dependencies: HealthDaemon<Manifest>[], id: string, ready: Ready | typeof EXIT_SUCCESS, effects: Effects);
-    /** Run after we want to do cleanup */
-    term(termOptions?: {
-        signal?: NodeJS.Signals | undefined;
-        timeout?: number | undefined;
-        destroySubcontainer?: boolean;
-    }): Promise<void>;
-    /** Want to add another notifier that the health might have changed */
-    addWatcher(watcher: () => unknown): void;
-    get health(): Readonly<HealthCheckResult>;
-    private changeRunning;
-    private stopSession;
-    private resetReady;
-    private startSession;
-    private runHealthCheckLoop;
-    onReady(): Promise<void>;
-    get isReady(): boolean;
-    private setHealth;
-    updateStatus(): Promise<void>;
-}