import type { Server } from 'node:http';
interface StartOptions {
    config?: string;
    host?: string;
    port?: number;
    logLevel?: string;
}
/**
 * 注册 SIGTERM/SIGINT 关闭 handler。
 * 关键约束：Node.js 注册 signal listener 后，默认自动退出行为被移除。
 * 每一步必须 try-catch，保证最后 process.exit(0) 一定执行，
 * 否则进程残留（菜单栏 stopSync 退出后，Node.js 进程会变成孤儿）。
 *
 * 抽成独立函数便于单测：验证即使中间步骤抛错，仍会调用 process.exit。
 */
export declare function installShutdownHandlers(opts: {
    server: Server;
    visionCache: {
        flushSync(): void;
    };
    t: (key: string) => string;
    pidPath?: string;
    signalTarget?: NodeJS.Signals[] | '*';
    /** 可选：需要 graceful close 的资源（如 SQLite store） */
    onShutdown?: () => void;
}): void;
export declare function cmdStart(opts: StartOptions): Promise<void>;
export declare function cmdStop(opts?: {
    port?: number;
}): Promise<void>;
export declare function cmdStatus(): Promise<void>;
export declare function cmdRestart(opts: StartOptions): Promise<void>;
export declare function cmdReload(opts: {
    port?: number;
    config?: string;
    adminKey?: string;
}): Promise<void>;
export {};
//# sourceMappingURL=commands.d.ts.map