/**
 * Notification command handler.
 *
 * When the onboarding service sends a `notify` command via heartbeat,
 * this handler enqueues a synthetic system message into the message queue
 * and wakes the main loop so the notification is injected into the agent's
 * context on the next wake cycle.
 */
import type { MessageQueue } from "../channels/queue.js";
import type { CommandHandler } from "./command-dispatcher.js";
export interface NotifyPayload {
    /** The notification text to inject into the agent context. */
    message: string;
    /** Optional source label (e.g. "admin", "system"). Defaults to "server". */
    source?: string;
}
/**
 * Creates a `notify` command handler that enqueues a system message
 * and wakes the main loop.
 *
 * @param messageQueue  The persistent message queue.
 * @param wakeMainLoop  Resolves the sleep promise to wake the agent.
 */
export declare function createNotifyHandler(messageQueue: MessageQueue, wakeMainLoop: () => void): CommandHandler;
//# sourceMappingURL=notification-handler.d.ts.map