import type { AgentPlannedMessageSnapshot } from '../../../src/book-3.0/AgentPlannedMessagesSidecar';
/**
 * Planned-message sidecar information made visible to one coding-harness prompt.
 */
export type AgentPlannedMessagesPromptSidecar = {
    /**
     * Portable path of the sidecar inside the agent folder.
     */
    readonly relativeSidecarPath: string;
    /**
     * Planned messages that are already waiting to wake the agent.
     */
    readonly currentPlannedMessages: ReadonlyArray<AgentPlannedMessageSnapshot>;
};
/**
 * Builds the planned-message instructions available to an Agents Server-managed coding agent.
 *
 * Planned messages always target the agent's singleton goal chat, regardless of the chat in which the
 * wake-up is planned, and each of them keeps repeating until its schedule is over or it is cancelled.
 * The sidecar file is the only channel that changes them, so an answer that merely claims a follow-up
 * was planned changes nothing — and an answer that changes nothing keeps the current plan running.
 *
 * @param sidecar - Sidecar prepared by the Agents Server for the answered message.
 * @returns Prompt section, or an empty string outside Agents Server-managed runs.
 */
export declare function buildAgentGoalChatPromptSection(sidecar: AgentPlannedMessagesPromptSidecar | undefined): string;