/**
 * Optional auto-recovery hook. When `hawkins.autoRecovery=true`, fires once
 * on `gateway_start` and logs any unfinished VINES orchestrations the host
 * came up holding. The hook never mutates state — operators still run
 * `vines_recover` explicitly to mark orphans as failed.
 *
 * Default: disabled. Most hosts don't need this; it's a convenience for
 * always-on production deployments.
 */
import type { PluginLogger } from "openclaw/plugin-sdk/core";
import type { HawkinsServices } from "./services.js";
export interface AutoRecoveryHookOptions {
    enabled: boolean;
    services: HawkinsServices;
    logger: PluginLogger;
}
/**
 * Returns a `gateway_start` handler suitable for `api.registerHook`. When
 * `enabled=false` returns a no-op so the registration call stays declarative.
 */
export declare function buildAutoRecoveryHandler(opts: AutoRecoveryHookOptions): () => Promise<void>;
//# sourceMappingURL=hooks.d.ts.map