/**
 * `critical` means the operation probably broke something the user must hear
 * about now; `advisory` means worth mentioning, not worth alarming. Required so
 * a caller cannot get a downgrade by omission.
 */
export type AgentWarningSeverity = "advisory" | "critical";
export interface AgentWarning {
    severity: AgentWarningSeverity;
    /** Stable machine-readable class, e.g. `org-cross-org-repoint`. */
    code: string;
    /** One human sentence: what happened, the consequence, and the remedy. */
    message: string;
}
/**
 * Raise a warning for the agent to relay to the user. Safe to call from any
 * depth inside an action; no `ctx` needed.
 */
export declare function warnAgent(warning: AgentWarning): void;
/** Take and clear the warnings raised so far in the current run. */
export declare function drainAgentWarnings(): AgentWarning[];
/**
 * Render drained warnings as tagged blocks for a tool result. Never called with
 * an empty list by the loop, so an action that raises nothing leaves its result
 * byte-identical.
 */
export declare function formatAgentWarningsForToolResult(warnings: AgentWarning[]): string;
//# sourceMappingURL=action-warnings.d.ts.map