/**
 * Response Formatters
 *
 * Converts API response data into human-readable text for MCP tool responses.
 * Uses concise, structured text that LLMs can easily parse and act on.
 */
import type { DashboardSummary, BudgetStatus, OptimizationResult, AgentDetail, AlertEvent, FailurePrediction, ModelRoutingExperiment } from '../types.js';
/** Format cents as dollar string */
export declare function formatCents(cents: number): string;
/** Format microcents as dollar string.
 *  Convention: 1 cent = 10,000 microcents → 1 dollar = 1,000,000 microcents.
 *  Source of truth: apps/gateway/src/cost.ts and apps/web/lib/customers/customer-costs.ts. */
export declare function formatMicrocents(microcents: number): string;
/** Format a percentage */
export declare function formatPct(value: number, decimals?: number): string;
/**
 * Attribution fields from the Metrx API have three states (see AgentSummary):
 * a number, null (on the plan, nothing attributed) or absent (not on the plan).
 * This is the one place the per-agent multiple is worded; it matches the hosted
 * MCP (agentledger packages/mcp-server/src/services/formatters.ts).
 *
 * Returns the suffix to append to an agent line ('' when the plan omits it).
 */
export declare function formatAgentMultipleSuffix(roi: number | null | undefined): string;
/** Format dashboard summary for LLM consumption */
export declare function formatDashboard(data: DashboardSummary): string;
/** Format optimization recommendations */
export declare function formatOptimizations(result: OptimizationResult): string;
/** Format budget status */
export declare function formatBudgetStatus(status: BudgetStatus): string;
/** Format agent detail */
export declare function formatAgentDetail(agent: AgentDetail): string;
/** Format alerts list */
export declare function formatAlerts(alerts: AlertEvent[]): string;
/** Format failure predictions */
export declare function formatPredictions(predictions: FailurePrediction[]): string;
/** Format model routing experiment */
export declare function formatExperiment(exp: ModelRoutingExperiment): string;
//# sourceMappingURL=formatters.d.ts.map