import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
export type CodexDeveloperMessageDelivery = "steer" | "followUp" | "nextTurn";
export interface CodexDeveloperMessageOptions {
    deliverAs?: CodexDeveloperMessageDelivery;
    triggerTurn?: boolean;
}
export interface CodexDeveloperMessageDetails {
    protocol: 1;
    id: string;
}
export declare const CODEX_DEVELOPER_MESSAGE_TYPE = "codex-developer-message";
export interface CodexDeveloperCustomMessage {
    customType: string;
    content: string;
    display: boolean;
    /** Plain object; the namespaced developer-message key is reserved. */
    details?: object;
}
export declare function sendCodexDeveloperMessage(pi: ExtensionAPI, content: string, options?: CodexDeveloperMessageOptions): void;
export declare function trySendCodexDeveloperMessage(pi: ExtensionAPI, content: string, options?: CodexDeveloperMessageOptions): boolean;
/** Preserve caller rendering and detail fields; false means nothing was sent. */
export declare function trySendCodexDeveloperCustomMessage(pi: ExtensionAPI, message: CodexDeveloperCustomMessage, options?: CodexDeveloperMessageOptions): boolean;
export declare function registerCodexDeveloperMessageBroker(pi: ExtensionAPI, isActive: () => boolean): () => void;
export declare function customDeveloperMessageMetadata(details: unknown): unknown;
export declare function isCodexDeveloperMessageDetails(value: unknown): value is CodexDeveloperMessageDetails;